Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Live to VOD

Última atualização: Sep 22, 2026

O ApsaraVideo VOD grava transmissões ao vivo como vídeos sob demanda em tempo real. Após a gravação, você pode transcodificar para vários formatos, moderar o conteúdo, gerar miniaturas inteligentes, edite clipes com a edição online e acelerar a entrega por meio do Alibaba Cloud CDN.

Este tópico aborda três práticas para o uso do Live to VOD.

Recurso

Link

Pré-requisitos

Activate ApsaraVideo VOD

Configuração de Live to VOD

Store recordings in ApsaraVideo VOD

Referência de API

GetPlayInfo, SubmitTranscodeJobs

Principais conceitos

Termo

Descrição

Live to VOD

Grava uma transmissão ao vivo no ApsaraVideo VOD, onde recursos de VOD como transcodificação, edição online, processamento de IA e notificações de eventos ficam disponíveis para o vídeo gravado.

Grupo de modelos de transcodificação

Define como o ApsaraVideo VOD transcodifica um vídeo gravado após o seu armazenamento.

Grupo de modelos de mesclagem e transcodificação

Define como o ApsaraVideo VOD mescla vários vídeos gravados de uma única transmissão ao vivo e transcodifica o resultado mesclado.

Apenas armazenamento

Armazena vídeos gravados sem pós-processamento. Especifique o grupo de modelos integrado No Transcoding na sua configuração de Live to VOD.

Apenas mesclagem

Mescla vários vídeos gravados sem transcodificação. Especifique o grupo de modelos integrado No Transcoding na sua configuração de Live to VOD.

Ciclo de gravação

A duração de cada segmento de gravação. Por exemplo, uma transmissão ao vivo de 3 horas com um ciclo de gravação de 1 hora gera três gravações separadas. A primeira gravação fica disponível para reprodução sob demanda uma hora após o início da transmissão.

Pré-requisitos

Antes de começar, certifique-se de ter concluído o seguinte:

Prática 1: Transcodificação automática + aceleração de CDN

Após a gravação de uma transmissão ao vivo, o ApsaraVideo VOD transcodifica e entrega as gravações via CDN imediatamente. Os usuários podem reproduzir os vídeos sob demanda assim que a transcodificação é concluída.

Quando usar: A maioria dos cenários de transmissão ao vivo em que as gravações não exigem edição manual antes da publicação.

Fluxograma:

image

Como funciona

  1. Inicie a ingestão de stream.

  2. Quando um ciclo de gravação é concluído, o ApsaraVideo VOD armazena automaticamente o vídeo gravado.

  3. O ApsaraVideo VOD gera um ID de vídeo exclusivo e envia o callback AddLiveRecordVideoComplete com parâmetros de transmissão ao vivo, como DomainName, AppName e StreamName. Armazene o ID do vídeo para rastrear atualizações de status subsequentes.

  4. O ApsaraVideo VOD lê o grupo de modelos de transcodificação da sua configuração de Live to VOD e inicia a transcodificação do vídeo gravado.

  5. Os callbacks são enviados quando cada etapa de processamento é concluída (captura de snapshot, transcodificação de vídeo único ou transcodificação de todos os vídeos). Esses callbacks não chegam em uma ordem garantida. O callback de transcodificação inclui a URL de reprodução acelerada por CDN. Você também pode chamar a operação GetPlayInfo com o ID do vídeo para recuperar a URL de reprodução.

Prática 2: Apenas armazenamento + Transcodificação manual

Armazene vídeos gravados no ApsaraVideo VOD sem transcodificação automática. Acione a transcodificação manualmente quando estiver pronto, opcionalmente após edite as gravações com o recurso de edição online.

O modo de apenas armazenamento usa o grupo de modelos integrado No Transcoding , que é criado automaticamente ao ativar o bucket do VOD (o bucket do OSS alocado para o ApsaraVideo VOD).

Quando usar: Cenários em que as gravações precisam de pós-processamento antes da publicação, como a edição de imagens de partidas esportivas ou melhores momentos de jogos. Após a conclusão da transcodificação, o ApsaraVideo VOD fornece automaticamente aceleração de CDN para os vídeos transcodificados.

Fluxograma:

image

Como funciona

  1. Inicie a ingestão de stream.

  2. Quando um ciclo de gravação é concluído, o ApsaraVideo VOD armazena automaticamente o vídeo gravado.

  3. O ApsaraVideo VOD gera um ID de vídeo exclusivo e envia o callback AddLiveRecordVideoComplete com parâmetros de transmissão ao vivo, como DomainName, AppName e StreamName. Armazene o ID do vídeo para rastrear atualizações de status subsequentes.

  4. Chame a operação SubmitTranscodeJobs para acionar a transcodificação. Antes da transcodificação, execute outras operações no vídeo gravado, como a edição online.

  5. Os callbacks são enviados quando cada etapa de processamento é concluída (captura de snapshot, transcodificação de vídeo único ou transcodificação de todos os vídeos). Esses callbacks não chegam em uma ordem garantida. O callback de transcodificação inclui a URL de reprodução acelerada por CDN. Você também pode chamar a operação GetPlayInfo com o ID do vídeo para recuperar a URL de reprodução.

Prática 3: Mesclagem automática entre ciclos de gravação

Quando uma transmissão ao vivo abrange vários ciclos de gravação, o ApsaraVideo VOD pode mesclar automaticamente os vídeos resultantes em um único vídeo. Por exemplo, em um ciclo de gravação de 20 minutos e uma transmissão de 1 hora, o ApsaraVideo VOD gera três vídeos e depois os mescla.

Configure a mesclagem automática com um dos seguintes grupos de modelos:

  • Um grupo de modelos de mesclagem e transcodificação: mescla e transcodifica automaticamente (Opção A)

  • O grupo de modelos integrado No Transcoding: apenas mescla, transcodifique manualmente depois (Opção B)

Se a transmissão ao vivo for interrompida por um período maior que o tempo limite especificado, o ApsaraVideo VOD mescla automaticamente os vídeos gravados gerados e processa o vídeo mesclado com base na configuração de transcodificação. Configure o tempo limite de interrupção no ApsaraVideo Live.

Importante

A mesclagem automática não é compatível com transmissões ao vivo interrompidas por mais de 3 minutos.

Opção A: Mesclagem + Transcodificação automática

O ApsaraVideo VOD mescla e transcodifica todos os vídeos gravados automaticamente após o término da transmissão ao vivo.

Quando usar: Transmissões esportivas, cursos online e outros cenários em que todos os segmentos gravados devem ser publicados como um único vídeo.

Fluxograma:

image

Como funciona

  1. Inicie a ingestão de stream.

  2. Quando um ciclo de gravação é concluído, o ApsaraVideo VOD armazena automaticamente o vídeo gravado.

  3. O ApsaraVideo VOD gera um ID de vídeo exclusivo e envia o callback AddLiveRecordVideoComplete com parâmetros de transmissão ao vivo, como DomainName, AppName e StreamName. Armazene o ID do vídeo para rastrear atualizações de status subsequentes.

  4. A transmissão ao vivo é interrompida por um período maior que o tempo limite especificado, ou você encerra a transmissão manualmente.

  5. O ApsaraVideo VOD recebe uma notificação de fim de transmissão do ApsaraVideo Live.

  6. O ApsaraVideo VOD verifica a configuração de mesclagem nas suas configurações de Live to VOD. Se a mesclagem automática estiver ativada, ele usa o grupo de modelos de mesclagem e transcodificação especificado para mesclar e transcodificar os vídeos gravados.

  7. O ApsaraVideo VOD gera um ID de vídeo exclusivo para o vídeo mesclado e envia o callback LiveRecordVideoComposeStart com parâmetros de transmissão ao vivo, como DomainName, AppName e StreamName. Armazene o ID do vídeo para rastrear atualizações de status subsequentes.

  8. Quando a mesclagem é concluída, o ApsaraVideo VOD envia o callback FileUploadComplete.

  9. Os callbacks são enviados quando cada etapa de processamento é concluída (captura de snapshot, transcodificação de vídeo único ou transcodificação de todos os vídeos). Esses callbacks não chegam em uma ordem garantida. O callback de transcodificação inclui a URL de reprodução acelerada por CDN. Você também pode chamar a operação GetPlayInfo com o ID do vídeo para recuperar a URL de reprodução.

Opção B: Mesclagem + Transcodificação manual

Todos os vídeos gravados são mesclados automaticamente, mas a transcodificação não é acionada. Processe o vídeo mesclado antes de acionar a transcodificação manualmente. Por exemplo, insira anúncios no vídeo ou corte o conteúdo reproduzido durante o intervalo de uma partida esportiva.

Quando usar: Cenários em que o vídeo mesclado exige edição antes da publicação.

Fluxograma:

image

Como funciona

  1. Inicie a ingestão de stream.

  2. Quando um ciclo de gravação é concluído, o ApsaraVideo VOD armazena automaticamente o vídeo gravado.

  3. O ApsaraVideo VOD gera um ID de vídeo exclusivo e envia o callback AddLiveRecordVideoComplete com parâmetros de transmissão ao vivo, como DomainName, AppName e StreamName. Armazene o ID do vídeo para rastrear atualizações de status subsequentes.

  4. A transmissão ao vivo é interrompida por um período maior que o tempo limite especificado, ou você encerra a transmissão manualmente.

  5. O ApsaraVideo VOD recebe uma notificação de fim de transmissão do ApsaraVideo Live.

  6. O ApsaraVideo VOD verifica a configuração de mesclagem nas suas configurações de Live to VOD. Se a mesclagem automática estiver ativada, ele usa o grupo de modelos de apenas mesclagem especificado para mesclar os vídeos gravados.

  7. O ApsaraVideo VOD gera um ID de vídeo exclusivo para o vídeo mesclado e envia o callback LiveRecordVideoComposeStart com parâmetros de transmissão ao vivo, como DomainName, AppName e StreamName. Armazene o ID do vídeo para rastrear atualizações de status subsequentes.

  8. Quando a mesclagem é concluída, o ApsaraVideo VOD envia o callback FileUploadComplete. O vídeo mesclado agora está pronto para processamento adicional.

  9. Chame a operação SubmitTranscodeJobs para acionar a transcodificação. Antes da transcodificação, execute outras operações no vídeo mesclado, como a edição online.

  10. Os callbacks são enviados quando cada etapa de processamento é concluída (captura de snapshot, transcodificação de vídeo único ou transcodificação de todos os vídeos). Esses callbacks não chegam em uma ordem garantida. O callback de transcodificação inclui a URL de reprodução acelerada por CDN. Você também pode chamar a operação GetPlayInfo com o ID do vídeo para recuperar a URL de reprodução.

Referência de callbacks

Os seguintes callbacks são enviados durante o fluxo de trabalho de Live to VOD. Use o ID do vídeo em cada callback para correlacionar eventos e atualize seu sistema.

Callback

Gatilho

Parâmetros principais

AddLiveRecordVideoComplete

Um vídeo gravado é armazenado no ApsaraVideo VOD

DomainName, AppName, StreamName, ID do vídeo

LiveRecordVideoComposeStart

A mesclagem de vídeos gravados é iniciada

DomainName, AppName, StreamName, ID do vídeo

FileUploadComplete

A mesclagem é concluída e o arquivo mesclado está pronto

ID do vídeo, status da mesclagem

Callback de transcodificação

Um snapshot é capturado ou a transcodificação é concluída

ID do vídeo, URL de reprodução

Os callbacks não chegam em uma ordem garantida. Projete seu sistema para lidar com eventos de forma assíncrona com base no ID do vídeo.

Perguntas frequentes

Como recupero a URL de reprodução de um vídeo transcodificado?

O callback de transcodificação inclui a URL de reprodução diretamente. Você também pode chamar a operação GetPlayInfo com o ID do vídeo. Ambos os métodos retornam uma URL acelerada por CDN.

O que é o bucket do VOD?

O bucket do VOD é o bucket do OSS alocado para o ApsaraVideo VOD. O grupo de modelos integrado No Transcoding é criado automaticamente ao ativar este bucket.

Posso combinar apenas armazenamento com mesclagem automática?

Sim. Ative a mesclagem automática nas suas configurações de Live to VOD e especifique o grupo de modelos integrado No Transcoding (modo de apenas mesclagem). O ApsaraVideo VOD mescla todos os segmentos gravados sem transcodificação, e você pode processar o vídeo mesclado e acionar a transcodificação manualmente depois.

O que acontece se uma transmissão ao vivo for interrompida por mais de 3 minutos?

A mesclagem automática não é compatível com transmissões ao vivo interrompidas por mais de 3 minutos. Especifique o tempo limite de interrupção para transmissões ao vivo no ApsaraVideo Live.