SubmitTranscodeJobs - : Central de Documentação do Alibaba Cloud

Nota

A transcodificação de vídeo só é possível quando o status é UploadSucc, Normal ou Checking.
Obtenha o resultado da transcodificação por meio da notificação de evento StreamTranscodeComplete ou TranscodeComplete.
Ao iniciar uma tarefa de empacotamento HTTP Live Streaming (HLS), chame esta operação para substituir dinamicamente a legenda. Se a tarefa não incluir legendas, não chame esta operação para iniciá-la. Em vez disso, especifique o ID do grupo de modelos específico durante o upload do vídeo para iniciar o processo de empacotamento automaticamente.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	SubmitTranscodeJobs	Operação a ser executada. Defina o valor como SubmitTranscodeJobs.
TemplateGroupId	String	Sim	ea2727ecc0*****5ff43c04878f4e1	ID do grupo de modelos de transcodificação usado na transcodificação do vídeo. Para especificar um grupo de modelos, faça login no console do ApsaraVideo VOD e visualize o ID do grupo de modelos de transcodificação na página Transcode.
VideoId	String	Não	0222e203cf*****72f9c22870a4d2c	ID do vídeo. Nota O parâmetro VideoId é obrigatório.
PipelineId	String	Não	d3e680e618708*****fbf2cae7cc931	ID do pipeline.
EncryptConfig	String	Não	{"CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt", "DecryptKeyUri":"http://decrypt.demo.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt","KeyServiceType":"KMS"}	Configurações de criptografia. O valor é uma string formatada em JSON. Este parâmetro é necessário apenas ao usar criptografia HLS. Nota Na string JSON do parâmetro EncryptConfig, defina o parâmetro CipherText como uma chave de texto cifrado AES-128 gerada pela operação GenerateDataKey. Caso contrário, o job de transcodificação com criptografia HLS falhará. Para mais informações sobre criptografia HLS, consulte Criptografia HLS. Independentemente do uso de criptografia HLS ou criptografia proprietária da Alibaba Cloud, ative a criptografia HLS no grupo de modelos especificado pelo parâmetro TemplateGroupId. Sem isso, a criptografia HLS não funcionará.
OverrideParams	String	Não	{"Watermarks":[{"WatermarkId":"af2afe4761992c***47dae97337","FileUrl":"http://test.bucket.aliyuncs.com/image/replace.png"},{"WatermarkId":"e8e5b8038d7a***da85b376c270","Content":"Watermark test"}]}	Parâmetros de substituição. O valor é uma string formatada em JSON. Use este parâmetro para substituir a marca d'água ou legenda associada ao modelo de transcodificação. É possível substituir a URL do arquivo de uma marca d'água de imagem, o conteúdo de uma marca d'água de texto, a URL de um arquivo de legenda e o formato de codificação desse arquivo. Para mais detalhes sobre a estrutura de dados, consulte a seção "OverrideParams" no tópico Parâmetros de processamento de mídia.
Priority	String	Não	6	Prioridade do job de transcodificação atual entre todos os jobs na fila. Valores válidos: 1 a 10. O valor 10 indica a prioridade mais alta. Valor padrão: 6. Nota Este parâmetro define a prioridade apenas do job de transcodificação atual na fila e não afeta as prioridades dos jobs em execução.
UserData	String	Não	{"Extend":{"localId":"**","test":"*"}}	Configurações personalizadas, incluindo configurações de callback. O valor é uma string formatada em JSON. Para mais informações, consulte a seção "UserData" no tópico Parâmetros da solicitação. Nota As configurações de callback entram em vigor somente ao especificar uma URL de callback HTTP e selecionar eventos de callback específicos no console do ApsaraVideo VOD.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	B1DBEFB3-3371-4E*****43-708259D719CE	ID da solicitação.
TranscodeJobs	Array of TranscodeJob		Jobs de transcodificação. Nota Este parâmetro não é retornado para tarefas de empacotamento HLS. Receba o resultado da transcodificação de forma assíncrona.
TranscodeJob
JobId	String	d8921ce85057*****16cfe86fb112c	ID do job.
TranscodeTaskId	String	9f4a0df7da2c*****8a81c8c0408c8	ID do job de transcodificação enviado.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=SubmitTranscodeJobs
&TemplateGroupId=ea2727ecc0*****5ff43c04878f4e1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<SubmitTranscodeJobsResponse>
  <RequestId>B1DBEFB3-3371-4E*****43-708259D719CE</RequestId>
  <TranscodeJobs>
        <TranscodeJob>
              <JobId>d8921ce85057*****16cfe86fb112c</JobId>
        </TranscodeJob>
  </TranscodeJobs>
  <TranscodeTaskId>9f4a0df7da2c*****8a81c8c0408c8</TranscodeTaskId>
</SubmitTranscodeJobsResponse>

Formato JSON

{
    "RequestId": "B1DBEFB3-3371-4E*****43-708259D719CE",
    "TranscodeJobs": {
        "TranscodeJob": [
            {
                "JobId": "d8921ce85057*****16cfe86fb112c"
            }
        ]
    },
    "TranscodeTaskId": "9f4a0df7da2c*****8a81c8c0408c8"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Erros comuns

A tabela a seguir descreve os erros comuns retornados por esta operação.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
InvalidVideo.NotFound	The video does not exist.	404	Mensagem de erro retornada porque o vídeo não existe.
NoSuchResource	The specified resource %s does not exist.	404	Mensagem de erro retornada porque o recurso relacionado ao usuário não existe. %s indica as informações específicas do recurso.
Forbidden.IllegalStatus	Status of the video is illegal.	400	Mensagem de erro retornada porque o status do vídeo é inválido. A transcodificação de vídeo só é possível quando o status é UploadSucc, Normal ou Checking.

Exemplos de SDK

Recomendamos usar um SDK de servidor para chamar esta operação. Para mais informações sobre os códigos de exemplo usados para chamar esta operação em várias linguagens, consulte os seguintes tópicos: