crie a transcoding job - ApsaraVideo Media Processing: Central de Documentação do Alibaba Cloud

Por favor, envie jobs de transcodificação pelo console do ApsaraVideo Media Processing (MPS) ou chame uma operação de API para converter arquivos de mídia no formato desejado.

Antes de começar

Conclua os seguintes preparativos. Ignore esta seção caso já os tenha concluído.

Activate a pipeline. Para jobs de transcodificação padrão, use um pipeline padrão.
Por favor, envie o vídeo a ser processado para o OSS.
- Caso queira, crie um job, e envie o vídeo diretamente para o OSS. Para mais informações, consulte Upload a video.
- Caso queira, crie um workflow e acione-o automaticamente, adicione buckets de mídia e crie um workflow antes de enviar o vídeo. Por favor, especifique os buckets de mídia de entrada e saída e faça o upload de um arquivo para o bucket de entrada. Depois disso, o MPS receberá uma mensagem sobre o upload e acionará o workflow associado. Após a conclusão do workflow, o arquivo de mídia processado é enviado para o bucket de saída. Para mais informações, consulte Add media buckets.
Por favor, configure os modelos de transcodificação.
Use modelos de marca d'água para simplificar a adição de marcas d'água aos seus vídeos. Para mais informações, consulte Watermark templates.
Opcional: ative o recurso de notificações. Para que o MPS envie notificações sobre jobs e workflows para tópicos ou filas do MNS, Por favor, configure uma fila ou tópico do MNS conforme a necessidade. Para mais informações, consulte defina notifications.

Por favor, envie jobs no console

Job único

Acesse o console do ApsaraVideo Media Processing.
Na barra de navegação superior, selecione uma região. Por exemplo, selecione China (Hangzhou).
No painel de navegação à esquerda, escolha Job Management.
Na aba Encode, Agora, clique em Create Task.

Por favor, configure os parâmetros.

Parâmetro	Descrição
Input File URL	Agora, clique em Select. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket selecionado aparecem em Path. Selecione um arquivo de entrada. Nota Se não houver buckets disponíveis, acesse o console do OSS e crie um bucket na região atual. Para mais informações, consulte Add media buckets. Se não houver arquivos disponíveis em Path após selecionar um bucket, faça o upload de arquivos para esse bucket no console do OSS. Se você receber um aviso de que o OSS não está ativado, acesse o console do OSS e ative o service. Se aparecer uma mensagem de erro de função ou de permissão negada, acesse o console do Resource Access Management (RAM) e conceda as permissões necessárias do OSS ao usuário atual do RAM. Você pode anexar a política AliyunOSSFullAccess ou crie uma política personalizada conforme necessário. Para mais informações, consulte crie a RAM user and grant permissions.
Encoding Pipeline	Selecione um pipeline na lista suspensa. Nota Se não houver pipelines disponíveis, ative um pipeline primeiro. Para mais informações, consulte crie a pipeline. A execução simultânea do pipeline não é garantida e depende dos recursos disponíveis. O limite padrão de simultaneidade é 200.
Output File Name	Insira um nome para o arquivo de saída. Adicione uma extensão para todos os tipos de arquivo, exceto M3U8. Por exemplo, insira `example_video01.mp4`.
Output Path	Agora, clique em Select. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket são exibidas em Path. Selecione uma pasta como caminho de saída. Nota Se o caminho de saída for igual ao de entrada, mas os arquivos tiverem nomes diferentes, o arquivo de source não será sobrescrito. Se os arquivos tiverem o mesmo nome, a configuração do OSS determina se o arquivo de source é sobrescrito. Para evitar sobrescritas, consulte Prevent objects with the same name from being overwritten (Java SDK V1). Com essa configuração ativada, o job falhará ao gravar o arquivo de saída caso ele tenha o mesmo nome do arquivo de source. Recomendamos o uso de um nome diferente para o arquivo de saída. Para outros problemas comuns, consulte a descrição de Input File URL.

Agora, clique em Next.

Por favor, configure o Encoding Template.

Parâmetro	Descrição
Template Type	Selecione o tipo de modelo de transcodificação. Para obter detalhes sobre os modelos predefinidos, consulte Preset template details. Caso precise, crie um modelo personalizado, consulte Transcoding templates.
Output Format	Selecione um formato de saída. O valor padrão é mp4.
Template	Selecione um modelo. O valor padrão é MP4-4K.
(Opcional) Watermark Template	Por favor, ative o switch. Na lista suspensa Watermark Template, selecione um modelo de marca d'água. Se não houver modelos de marca d'água disponíveis, crie primeiro. Agora, clique em Select ao lado de Watermark Image. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket são exibidas em Path. Selecione um arquivo de imagem. Nota Os formatos de marca d'água compatíveis incluem imagens PNG, imagens PNG animadas e animações MOV.
(Opcional) Clip Output	Por favor, ative o switch. Por favor, defina o horário de início e a duração do clipe. No campo Start From, selecione o horário de início no formato HH:MM:SS. Nota O horário de início deve ser menor que a duração total do vídeo. Caso contrário, o job de transcodificação falhará. No campo Clip Length, selecione a duração no formato HH:MM:SS. Nota Se a duração especificada para o clipe ultrapassar o final do vídeo, o clipe será gerado até o fim do vídeo de source.
(Opcional) Rotate Angle	Insira um ângulo de rotação no sentido horário. O valor deve estar no intervalo de [0, 360].

Agora, clique em Submit para a criação e envio do job de transcodificação.

Após o envio do job, visualize seu status de execução, detalhes de configuração, caminho de entrada e caminho de saída na lista de jobs.

Nota
Se um job de transcodificação falhar e você não conseguir, visualize os detalhes da falha, verifique sua conexão de rede e reenvie o job.

Workflow

Acesse o console do ApsaraVideo Media Processing.
Na barra de navegação superior, selecione uma região.
No painel de navegação à esquerda, escolha Workflow > Workflow Orchestration.
Agora, clique em Create Workflow.
Por favor, configure os parâmetros do workflow conforme necessário.
1. Workflow Name: Insira um nome para o workflow.
2. Configuration Plan: Selecione um plano de configuração.
  
  Nota
  O MPS oferece workflows predefinidos para casos de uso comuns. Selecione e edite um workflow predefinido ou crie um personalizado.

Edite a topologia do workflow.

Agora, clique em um ícone de adição (+) ao lado do nó correspondente e selecione o nó Encode na lista suspensa.
Agora, clique em um ícone de lápis ao lado do nó Encode para abrir a página Basic Settings.

Por favor, configure os parâmetros de transcodificação.

Parâmetro	Descrição
Name	Insira um nome para este nó.
Encoding Template	Agora, clique em Select. Na caixa de diálogo exibida, configure o Encoding Template. Selecione um Template Type. Selecione um Output Format. Selecione um Template. Agora, clique em OK. Nota Para obter detalhes sobre os modelos predefinidos, consulte Preset template details. Caso precise, crie um modelo personalizado, consulte Transcoding templates.
Output Path	Agora, clique em Select. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket são exibidas em Path. Selecione uma pasta como caminho de saída. Nota Se o caminho de saída for igual ao de entrada: Se os arquivos tiverem nomes diferentes, o arquivo de source não será sobrescrito. Se os arquivos tiverem o mesmo nome, a configuração do OSS determina se o arquivo de source é sobrescrito. Para evitar sobrescritas, consulte Prevent objects with the same name from being overwritten (Java SDK V1). Com essa configuração ativada, o job falhará ao gravar o arquivo de saída caso ele tenha o mesmo nome do arquivo de source. Recomendamos o uso de um nome diferente para o arquivo de saída. Para evitar que os arquivos de saída sejam sobrescritos em execuções subsequentes do workflow, use uma combinação das seguintes variáveis integradas: `{RunId}`: O ID de execução do workflow de mídia. `{ObjectPrefix}`: O caminho do arquivo de source, excluindo as informações do bucket. `{FileName}`: O nome do arquivo de source, incluindo a extensão. A extensão do arquivo de saída é determinada pelo modelo de transcodificação selecionado. `{ExtName}`: A extensão do arquivo de source.
(Opcional) Watermark	Por favor, ative o switch. Selecione um nome de modelo na lista suspensa Watermark Template. Nota Se não houver modelos de marca d'água disponíveis, crie primeiro. Agora, clique em Select ao lado de Watermark Image para adicionar o caminho da imagem de marca d'água. Nota Os formatos de marca d'água compatíveis incluem imagens PNG, imagens PNG animadas e animações MOV.
(Opcional) Encryption	Por favor, ative o switch. Para Encryption Method, selecione Alibaba Cloud Private Encryption ou HLS Standard Encryption. Para mais informações, consulte Video encryption.
(Opcional) Clip	Por favor, ative o switch. Para Clip Method, selecione Video Clip ou Video Ending Clip. No campo Start From, selecione o horário de início. No campo Length, selecione a duração. Nota O horário de início deve ser menor que a duração total do vídeo. Caso contrário, o job de transcodificação falhará. Se a duração especificada para o clipe ultrapassar o final do vídeo, o clipe será gerado até o fim do vídeo de source.
(Opcional) Add Credits	Por favor, ative o switch. Ao lado de File Path, Agora, clique em Select e escolha o caminho do arquivo de vídeo de créditos.
(Opcional) Rotate Angle	Insira um ângulo de rotação no sentido horário. O valor deve estar no intervalo de [0, 360].

Agora, clique em OK para concluir a configuração do nó Encode.

Agora, clique em salve para a criação do workflow.

Por favor, envie jobs via API

Caso a criação de jobs ou workflows no console não atenda às suas necessidades, chame a operação SubmitJobs para enviar jobs de transcodificação programaticamente e configurar parâmetros com base na sua lógica de negócios.

Chame a operação SubmitJobs para enviar um job de transcodificação.

Para mais informações, consulte envie a transcoding job. Durante o processo de criação, configure as informações de transcodificação da seguinte forma:
1. PipelineId: Use o ID de um pipeline padrão.
2. TemplateId: Selecione um modelo de transcodificação com base nas suas necessidades. Se os modelos predefinidos não atenderem aos seus requisitos, crie um modelo personalizado. Para mais informações, consulte Add a custom transcoding template.
3. (Opcional) Se precisar de criptografia, configure o parâmetro Encryption no objeto Output.
  
  Nota
  A saída criptografada deve estar no formato M3U8. A API suporta os métodos de criptografia Base64 e KMS. Para mais informações, consulte Parameter details.
Receba notificações de callback.

Quando um job de transcodificação for concluído e você tiver configurado notificações de eventos para o pipeline, uma mensagem será enviada à fila ou ao tópico especificado no Simple Message Queue (formerly MNS). Para mais informações, consulte Receive notifications.
Consulte o resultado do job.
1. Chame a operação Query transcoding jobs para consultar o resultado do job e obter a URL do arquivo de saída.
2. Chame a operação List transcoding jobs para consultar vários jobs de transcodificação com base no ID do pipeline, status do job e intervalo de tempo de criação.