Todos os produtos
Search
Central de documentação

ApsaraVideo Live:StartRtcCloudTranscode

Última atualização: Jun 28, 2026

Cria um trabalho de transcodificação em nuvem.

Descrição da operação

Endpoints\n\nOs seguintes endpoints estão disponíveis para esta operação.\n\n| Região | ID da região | Endpoint público |\n| --------- | -------------- | -------------------------------- |\n| Singapura | ap-southeast-1 | live.ap-southeast-1.aliyuncs.com |

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

AppId

string

Sim

O ID do aplicativo ao qual o canal pertence. O ID pode conter letras maiúsculas, letras minúsculas, dígitos, sublinhados (_) e hifens (-). O comprimento máximo é de 64 caracteres.

********-7074-****-9ef5-85c19a4*****

ChannelId

string

Sim

O ID do canal ao qual o usuário a ser transcodificado pertence. O ID pode conter letras maiúsculas, letras minúsculas, dígitos, sublinhados (_) e hifens (-). O comprimento máximo é de 64 caracteres.

myChannel

InputParam

object

Sim

Os parâmetros para a assinatura do fluxo de entrada.

SingleSubUserParam

object

Sim

Os parâmetros de entrada para uma assinatura de fluxo único.

UserId

string

Sim

O ID do usuário cujo fluxo você deseja assinar.

userA

StreamType

integer

Não

O tipo de mídia do fluxo assinado. Valores válidos:\n\n- 0 (padrão): O fluxo original, que inclui os fluxos de áudio e vídeo.\n\n- 1: O fluxo apenas de áudio. (Este valor não é suportado. A configuração é inválida.)\n\n- 2: O fluxo apenas de vídeo. (Este valor não é suportado. A configuração é inválida.)

0

SourceType

integer

Não

O tipo do fluxo de entrada de vídeo. Este parâmetro é válido apenas se o tipo de mídia assinado incluir um fluxo de vídeo. Valores válidos:\n\n- 0 (padrão): O fluxo da câmera.\n\n- 1: O fluxo de compartilhamento de tela. (Este valor não é suportado. A configuração é inválida.)

0

OutputParams

array<object>

Sim

Os parâmetros para a saída transcodificada.

object

Não

Os parâmetros para um fluxo de saída transcodificado.

ChannelId

string

Sim

O ID do canal para o qual o fluxo transcodificado é enviado. O ID pode conter letras maiúsculas, letras minúsculas, dígitos, sublinhados (_) e hifens (-). O comprimento máximo é de 64 caracteres. (O envio de fluxos para um canal diferente não é suportado. Esta configuração é inválida.)

myChannel

UserId

string

Sim

O ID do usuário para o fluxo transcodificado no canal de destino. Este ID deve ser exclusivo dentro do canal.

userA_360p

UserToken

string

Sim

O token necessário para enviar o fluxo transcodificado para o canal. Para obter mais informações, consulte Autenticação baseada em token.

eyJhcHBpZCI********

TranscodeTemplate

string

Sim

O nome do modelo de transcodificação. Valores válidos:\n\n- alimcopy\n\n- lld\n\n- lsd\n\n- lhd\n\n- lud.

lhd

MaxIdleTime

integer

Não

O período de tempo limite de inatividade em segundos. Se uma tarefa não conseguir assinar o fluxo do streamer especificado e permanecer inativa por mais tempo do que este período, a tarefa será interrompida automaticamente. O valor deve ser um número inteiro de 10 a 14.400. O valor padrão é 300.

600

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

******3B-0E1A-586A-AC29-742247******

TaskId

string

O ID do trabalho de transcodificação em nuvem.

******73-8501-****-8ac1-72295a******

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "TaskId": "******73-8501-****-8ac1-72295a******"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter%s %s.
400 MissingParameter%s %s.
400 TooManyRequests %s.
500 InternalError %s. error on the live liveapi server.
403 Forbidden %s.
404 NotFound%s %s.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.