Todos os produtos
Search

Este produto

    ApsaraVideo Media Processing:Criar um trabalho de transcodificação padrão

    Central de documentação

    ApsaraVideo Media Processing:Criar um trabalho de transcodificação padrão

    Última atualização: Jun 27, 2026

    O ApsaraVideo Media Processing (MPS) permite transcodificar mídias enviando trabalhos de transcodificação no console ou chamando uma operação de API. Este tópico descreve como criar um trabalho de transcodificação padrão no MPS.

    Antes de começar

    Conclua as preparações a seguir. Ignore esta seção caso já tenha concluído essas etapas.

    • Ativar um pipeline. Para trabalhos de transcodificação padrão, use um pipeline padrão.

    • Carregue o vídeo a ser processado no OSS.

      • Para criar um trabalho, carregue o vídeo diretamente no OSS. Para mais informações, consulte Fazer upload de um vídeo.

      • Para criar um workflow e acioná-lo automaticamente, adicione buckets de mídia e crie um workflow antes de carregar o vídeo. Após especificar os buckets de mídia de entrada e saída e carregar um arquivo de mídia no bucket de entrada, o MPS recebe uma mensagem sobre o upload e aciona o workflow associado. Quando o workflow é concluído, o arquivo de mídia processado é carregado no bucket de mídia de saída. Para mais informações, consulte Adicionar buckets de mídia.

    • Configure os modelos de transcodificação.

    • Use modelos de marca d'água para simplificar a adição de marcas d'água aos vídeos. Para mais informações, consulte Modelos de marca d'água.

    • Opcional. Ative o recurso de notificação. Para que o MPS envie notificações sobre trabalhos e workflows para tópicos ou filas do MNS, configure uma fila ou tópico do MNS conforme necessário. Para mais informações, consulte Configurar notificações.

    Enviar trabalhos no console

    Trabalho único

    1. Faça login no console do ApsaraVideo Media Processing.

    2. Na barra de navegação superior, selecione uma região. Por exemplo, selecione China (Hangzhou).

    3. No painel de navegação à esquerda, escolha Job Management.

    4. Na aba Encode, clique em Create Task.

    5. Configure os parâmetros.

      Parâmetro

      Descrição

      Input File URL

      Clique em Select. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket selecionado aparecem em Path. Selecione um arquivo de entrada em uma pasta.

      Nota

      • Se não houver buckets disponíveis na lista suspensa, acesse o console do OSS para criar um bucket na região atual. Para mais informações, consulte Adicionar buckets de mídia.

      • Caso não existam arquivos em Path após selecionar um bucket, acesse o console do OSS e carregue arquivos nesse bucket na região atual.

      • Se receber um aviso de que o OSS não está ativado, acesse o console do OSS para ativar o serviço.

      • Se ocorrer um erro de função ou uma mensagem de permissão negada, acesse o console do Resource Access Management (RAM) e conceda as permissões necessárias do OSS ao usuário RAM atual. Conceda permissões totais ao OSS anexando a política AliyunOSSFullAccess ou crie uma política personalizada conforme necessário. Para mais informações, consulte Criar um usuário RAM e conceder permissões.

      Encoding Pipeline

      Selecione um pipeline na lista suspensa.

      Nota

      • Se não houver pipelines disponíveis na lista suspensa, ative um pipeline primeiro. Para mais informações, consulte Criar um pipeline.

      • A simultaneidade do pipeline de transcodificação não é garantida e depende dos recursos disponíveis. A simultaneidade padrão é 200.

      Output File Name

      Insira um nome para o arquivo de saída. Adicione uma extensão de arquivo para todos os tipos, exceto M3U8. Por exemplo, insira example_video01.mp4.

      Output Path

      Clique em Select. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket aparecem 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 origem não será sobrescrito. Caso compartilhem o mesmo nome, a configuração do OSS determina se o arquivo de origem será sobrescrito. Para evitar sobrescrita, consulte Impedir que objetos com o mesmo nome sejam sobrescritos (Java SDK V1). Ao ativar essa configuração, o trabalho falhará ao gravar o arquivo de saída no OSS se ele tiver o mesmo nome do arquivo de origem. Recomendamos usar um nome diferente para o arquivo de saída.

      • Para outros problemas comuns, consulte a descrição de Input File URL.

    6. Clique em Next.

    7. Configure o Encoding Template.

      Parâmetro

      Descrição

      Template Type

      Selecione o tipo de modelo de transcodificação. Para obter informações sobre modelos predefinidos, consulte Detalhes do modelo predefinido. Para criar um modelo de transcodificação personalizado, consulte Modelos de transcodificação.

      Output Format

      Escolha um formato de saída na lista suspensa. O valor padrão é mp4.

      Template

      Selecione um modelo na lista. O valor padrão é MP4-4K.

      (Opcional) Watermark Template

      Ative o switch.

      1. Na lista suspensa Watermark Template, selecione um modelo de marca d'água criado por você. Se não houver modelos na lista, crie um primeiro.

      2. Clique em Select ao lado de Watermark Image. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket aparecem em Path. Selecione um arquivo de imagem em uma pasta.

        Nota

        Os arquivos de marca d'água suportados incluem imagens PNG, imagens PNG animadas e animações MOV.

      (Opcional) Clip Output

      Ative o switch. Defina o horário de início e a duração para delimitar o clipe.

      1. 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 trabalho de transcodificação falhará.

      2. No campo Clip Length, selecione a duração no formato HH:MM:SS.

        Nota

        Se a duração especificada ultrapassar o final do vídeo, o clipe seguirá até o término do vídeo de origem.

      (Opcional) Rotate Angle

      Insira um ângulo de rotação no sentido horário. O valor deve estar no intervalo de [0, 360].

    8. Clique em Submit para criar e enviar o trabalho de transcodificação.

      Após enviar o trabalho, visualize o status de execução, os detalhes de configuração, o caminho de entrada e o caminho de saída na lista de trabalhos desta aba.

      Nota

      Se um trabalho de transcodificação falhar e não for possível visualizar os detalhes da falha, verifique sua conexão de rede e reenvie o trabalho assim que a conexão estiver estável.

    Workflow

    1. Faça login no console do ApsaraVideo Media Processing.

    2. Na barra de navegação superior, selecione uma região.

    3. No painel de navegação à esquerda, escolha Workflow > Workflow Orchestration.

    4. Clique em Create Workflow.

    5. 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 na lista suspensa.

        Nota

        O ApsaraVideo Media Processing oferece workflows predefinidos para casos de uso comuns. Selecione e edite um workflow predefinido ou crie um workflow personalizado.

    6. Edite a topologia do workflow.

      1. Clique no ícone de mais (+) ao lado do nó relevante e selecione o nó Encode na lista suspensa.

      2. Clique no ícone de lápis ao lado do nó Encode para abrir a página Basic Settings.

      3. Configure os parâmetros de transcodificação.

        Parâmetro

        Descrição

        Name

        Insira um nome para este nó.

        Encoding Template

        Clique em Select. Na caixa de diálogo exibida, configure o Encoding Template.

        1. Selecione um Template Type.

        2. Escolha um Output Format.

        3. Selecione um Template.

        4. Clique em OK.

        Nota

        Para obter informações sobre modelos predefinidos, consulte Detalhes do modelo predefinido. Para criar um modelo personalizado, consulte Modelos de transcodificação.

        Output Path

        Clique em Select. Na lista suspensa Bucket, selecione um bucket. As pastas do bucket aparecem em Path. Selecione um local como caminho de saída.

        Nota

        • Se o caminho de saída for igual ao de entrada:

          • Arquivos com nomes diferentes não sobrescrevem o arquivo de origem.

          • Caso compartilhem o mesmo nome, a configuração do OSS determina se o arquivo de origem será sobrescrito. Para evitar sobrescrita, consulte Impedir que objetos com o mesmo nome sejam sobrescritos (Java SDK V1). Ao ativar essa configuração, o trabalho falhará ao gravar o arquivo de saída no OSS se ele tiver o mesmo nome do arquivo de origem. Recomendamos usar um nome diferente para o arquivo de saída.

        • Para evitar que 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 origem, excluindo informações do bucket.

          • {FileName}: O nome do arquivo de origem, 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 origem.

        (Opcional) Watermark

        Ative o switch.

        1. Selecione um nome de modelo na lista suspensa Watermark Template.

          Nota

          Se não houver modelos de marca d'água na lista suspensa, crie um primeiro.

        2. Clique em Select ao lado de Watermark Image para adicionar o caminho da imagem de marca d'água.

          Nota

          Os arquivos de marca d'água suportados incluem imagens PNG, imagens PNG animadas e animações MOV.

        (Opcional) Encryption

        Ative o switch.

        Para Encryption Method, selecione Alibaba Cloud Private Encryption ou HLS Standard Encryption. Para mais informações, consulte Criptografia de vídeo.

        (Opcional) Clip

        Ative o switch.

        1. Em Clip Method, selecione Video Clip ou Video Ending Clip.

        2. No campo Start From, selecione o horário de início.

        3. 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 trabalho de transcodificação falhará.

          • Se a duração especificada ultrapassar o final do vídeo, o clipe seguirá até o término do vídeo de origem.

        (Opcional) Add Credits

        Ative o switch. Ao lado de File Path, 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].

      4. Clique em OK para concluir a configuração do nó Encode.

    7. Clique em Salve para criar o workflow.

    Enviar trabalhos via API

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

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

      Para mais informações, consulte Enviar um trabalho de transcodificação. 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 conforme suas necessidades. Se os modelos predefinidos não atenderem aos requisitos, crie um modelo personalizado. Para mais informações, consulte Adicionar um modelo de transcodificação personalizado.

      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 métodos de criptografia Base64 e KMS. Para mais informações, consulte Detalhes dos parâmetros.

    2. Receba notificações de callback.

      Quando um trabalho de transcodificação for concluído, caso você tenha configurado notificações de eventos para o pipeline, uma mensagem será enviada para a fila ou tópico especificado no Simple Message Queue (anteriormente MNS). Para mais informações, consulte Receber notificações.

    3. Consulte o resultado do trabalho.

      1. Chame a operação Consultar trabalhos de transcodificação para verificar o resultado do trabalho e obter a URL do arquivo de saída.

      2. Chame a operação Listar trabalhos de transcodificação para consultar múltiplos trabalhos de transcodificação com base no ID do pipeline, status do trabalho e intervalo de tempo de criação.