Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Transcodificação com taxa de bits adaptativa

Última atualização: Jun 27, 2026

O streaming de taxa de bits adaptativa agrupa vários fluxos de áudio e vídeo com diferentes taxas de bits e resoluções em um único arquivo. Durante a reprodução, o player seleciona automaticamente o fluxo mais adequado à largura de banda da rede e às capacidades do dispositivo do usuário, garantindo uma experiência fluida sem intervenção manual.

Como funciona

Essa tecnologia combina múltiplos fluxos de áudio e vídeo em um único arquivo que contém metadados sobre cada fluxo, como taxa de bits e resolução. Diferentemente da reprodução tradicional com taxa de bits fixa, o streaming adaptativo permite que o player escolha dinamicamente o fluxo ideal para as condições atuais de rede e do dispositivo. Isso melhora significativamente a experiência de reprodução.

Nota

Os formatos de saída mais comuns para streaming de taxa de bits adaptativa são HTTP Live Streaming (HLS) e DASH. O ApsaraVideo VOD oferece suporte apenas a HLS.

Demonstração

image

Pré-requisitos

Antes de começar, verifique se você tem:

Como usar

Transcodificar pelo console

Etapa 1: Criar um grupo de modelos de transcodificação com taxa de bits adaptativa

Crie um grupo de modelos que defina as versões de saída para seu fluxo de taxa de bits adaptativa.

Para obter instruções detalhadas, consulte Modelos de transcodificação.

Etapa 2 (opcional): Criar um workflow

Um workflow orquestra tarefas de processamento de mídia, como transcodificação, revisão e captura de snapshots, em uma sequência automatizada. Após o upload de um arquivo ou o acionamento do processamento de mídia, o workflow processa o arquivo conforme a ordem predefinida de tarefas.

Para utilizar um workflow, crie um com um nó de transcodificação de mídia e associe o grupo de modelos de transcodificação com taxa de bits adaptativa criado na Etapa 1. Para mais informações, consulte Gerenciar workflows.

Etapa 3: Iniciar a transcodificação

Acione a transcodificação durante ou após o upload, utilizando o grupo de modelos ou o workflow criado anteriormente.

Acionar a transcodificação durante o upload

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video e clique em Upload.

  3. Clique em Add Media. Configure o método de upload e o endereço de armazenamento. Selecione Use Transcoding Template Group ou Use Workflow e especifique o grupo de modelos de transcodificação com taxa de bits adaptativa ou o workflow desejado.

    Adaptive bitrate transcoding template selection during upload

  4. Adicione os arquivos de áudio ou vídeo e clique em Upload.

Acionar a transcodificação após o upload

Use este método para transcodificar novamente vídeos existentes, aplicar criptografia padrão ou substituir parâmetros de marca d'água.

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

  3. Localize o arquivo de destino e clique em Processing na coluna Actions.

  4. Selecione Use Transcoding Template Group ou Use Workflow e especifique o grupo de modelos de transcodificação com taxa de bits adaptativa ou o workflow correspondente.

    Adaptive bitrate transcoding template selection after upload

  5. Clique em OK.

Etapa 4: Visualizar os resultados da transcodificação

Após o início do job de transcodificação, verifique seu status e obtenha a URL do vídeo de saída.

Importante

Sem um nome de domínio acelerado configurado no ApsaraVideo VOD, a reprodução ou o download de um vídeo por sua URL gera cobranças de tráfego de saída do armazenamento. Para mais detalhes, consulte Faturamento de tráfego de saída do armazenamento.

Visualizar no console

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

  3. Verifique o status do arquivo. O status Normal indica que a transcodificação foi concluída. Para outros status, consulte Status: Video Status.

  4. Na coluna Actions, clique em Manage e selecione a aba Video URL. Um arquivo transcodificado com sucesso gera um fluxo adaptativo e vários fluxos transcodificados individuais, cada um com sua respectiva URL de vídeo.

    Transcoding results with adaptive and individual streams

Usar notificações de eventos

O ApsaraVideo VOD envia notificações de eventos via callbacks HTTP e MNS ao processar arquivos de mídia. Configure as notificações de eventos para receber o status do job de transcodificação e a URL do vídeo de saída nos resultados do callback. Para instruções de configuração, consulte Notificações de eventos.

Eventos relacionados à transcodificação:

  • StreamTranscodeComplete -- Enviado quando a transcodificação de uma única definição é concluída

  • TranscodeComplete -- Enviado quando a transcodificação de todas as definições é concluída

Transcodificar via API

Observações de uso

Para informações gerais sobre o uso da API, consulte Visão geral da API do ApsaraVideo VOD. Para testar operações da API e gerar código de exemplo do SDK sem calcular assinaturas, use o OpenAPI Explorer.

Etapa 1: Criar um grupo de modelos de transcodificação com taxa de bits adaptativa

Chame a operação AddTranscodeTemplateGroup e configure o modelo de empacotamento usando o parâmetro TranscodeTemplate. Para a especificação completa dos parâmetros, consulte TranscodeTemplate: Configuração do modelo de transcodificação.

Parâmetros do modelo de empacotamento

Os seguintes parâmetros são específicos para modelos de empacotamento com taxa de bits adaptativa:

Parâmetro da API

Parâmetro do console

Descrição

PackageType

Tipo de empacotamento

Formato de empacotamento. Valores válidos: HLSPackage (empacotamento HLS) e DASHPackage (empacotamento DASH). Apenas HLSPackage é suportado.

BandWidth

Limiar de largura de banda

Limiar de largura de banda usado pelo player para selecionar um fluxo. Unidade: bps. Este parâmetro aplica-se apenas a modelos de empacotamento de vídeo.

Etapa 2 (opcional): Criar um workflow

Workflows só podem ser criados no console do ApsaraVideo VOD. Para instruções, consulte Gerenciar workflows.

Etapa 3: Iniciar a transcodificação

Acionar a transcodificação durante o upload

Nota

A operação CreateUploadVideo obtém apenas uma URL e credencial de upload, além de criar informações básicas do ativo de mídia. Ela não faz o upload do arquivo. Implemente a lógica de upload separadamente. Para um exemplo completo de upload, consulte Carregar ativos de mídia chamando operações da API do ApsaraVideo VOD.

Chame CreateUploadVideo ou UploadMediaByURL e especifique o ID do grupo de modelos de transcodificação no parâmetro TemplateGroupId ou o ID do workflow no parâmetro WorkflowId. Após o upload do arquivo, o ApsaraVideo VOD inicia automaticamente um job de transcodificação com base no grupo de modelos ou workflow especificado.

Acionar a transcodificação após o upload

Use este método para transcodificar novamente vídeos existentes, aplicar criptografia padrão ou substituir parâmetros de marca d'água.

Chame SubmitTranscodeJobs e especifique o parâmetro TemplateGroupId. Alternativamente, chame SubmitWorkflowJob e especifique o parâmetro WorkflowId. O ApsaraVideo VOD inicia imediatamente a transcodificação com base no grupo de modelos ou workflow especificado.

Etapa 4: Visualizar os resultados da transcodificação

Importante

Sem um nome de domínio acelerado configurado no ApsaraVideo VOD, a reprodução ou o download de um vídeo por sua URL gera cobranças de tráfego de saída do armazenamento. Para mais detalhes, consulte Faturamento de tráfego de saída do armazenamento.

Consultar via API

A operação SubmitTranscodeJobs retorna um TranscodeTaskId. Chame GetTranscodeTask com esse ID para consultar o status de execução e recuperar a URL do vídeo de saída.

Usar notificações de eventos

O ApsaraVideo VOD envia notificações de eventos via callbacks HTTP e MNS ao processar arquivos de mídia. Configure as notificações de eventos para receber o status do job de transcodificação e a URL do vídeo de saída nos resultados do callback. Para instruções de configuração, consulte Notificações de eventos.

Eventos relacionados à transcodificação:

  • StreamTranscodeComplete -- Enviado quando a transcodificação de uma única definição é concluída

  • TranscodeComplete -- Enviado quando a transcodificação de todas as definições é concluída

Próximas etapas

Após a transcodificação, configure o streaming adaptativo no ApsaraVideo Player para permitir a troca automática de definição com base nas condições da rede, ou a troca manual de definição e legendas.