Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Get playback URLs

Última atualização: Jul 10, 2026

Obtenha URLs de reprodução por meio de notificações de eventos ou chamadas de API/SDK.

Obter URLs via notificações de eventos

O sistema envia notificações de eventos quando um stream de vídeo é transcodificado para uma definição específica (StreamTranscodeComplete) ou quando todos os streams transcodificados são gerados (TranscodeComplete). Essas notificações contêm as URLs de reprodução. Salve-as no servidor e retorne-as aos clientes mediante solicitações de reprodução.

Nota

Este método é ideal para reprodução com alta concorrência. Armazene as URLs em cache no servidor e pré-aqueça o conteúdo com o recurso de limpeza e pré-busca para escalar a milhões de visualizadores simultâneos. Consulte Limpeza e pré-busca.

Observações de uso

  • As URLs de reprodução obtidas nas notificações de eventos são URLs estáticas. Se a Assinatura de URL estiver ativada, gere a URL assinada manualmente.

  • Ao desativar ou excluir um domínio antigo, substitua-o pelo novo domínio ao recuperar as URLs de reprodução salvas.

  • Se a criptografia de vídeo estiver configurada, a URL de reprodução retornada apontará para um stream criptografado. O player deve descriptografá-lo antes da reprodução.

Obter URLs por chamadas de API/SDK

O ApsaraVideo VOD atribui um VideoId ao enviar um arquivo de mídia. Chame a operação GetPlayInfo com o VideoId para obter a URL de reprodução.

Observações de uso

  • Por padrão, essa operação retorna apenas o stream transcodificado mais recente de cada definição e formato. Ao chamar a API GetPlayInfo, defina ResultType como Multiple para recuperar todos os streams concluídos do vídeo.

  • Se a Criptografia proprietária da Alibaba Cloud estiver ativada, a reprodução do vídeo só será possível com o ApsaraVideo Player. A API GetPlayInfo não retorna streams com criptografia privada por padrão. Defina ResultType como Multiple para obter todos os streams concluídos, incluindo os criptografados.

  • Quando a Criptografia HLS estiver ativada, a API retornará prioritariamente o stream criptografado padrão para reprodução.

  • Para arquivos de mídia com armazenamento em camadas configurado, esta API apresenta o seguinte comportamento:

    • A API retorna streams de reprodução da classe de armazenamento Standard por padrão. Para camadas não padrão, como Archive, nenhum stream de reprodução é retornado. Se o arquivo source estiver em uma camada não padrão, a API retorna os streams transcodificados, mas não o stream de vídeo source.

    • Defina o campo StorageClass no parâmetro PlayConfig para solicitar streams de uma camada de armazenamento não padrão específica.

Fluxo de trabalho

O diagrama a seguir ilustra o fluxo de trabalho para recuperação e reprodução de vídeo por meio de um domínio acelerado por CDN.

image
  1. O cliente envia uma solicitação ao servidor de aplicativos para obter uma URL de reprodução.

  2. O servidor chama a operação GetPlayInfo usando o Server SDK para obter a autorização de reprodução.

  3. O ApsaraVideo VOD retorna a URL de reprodução ao servidor.

  4. O servidor retorna a URL de reprodução ao cliente.

  5. O player do cliente solicita o recurso de mídia com base na URL de reprodução retornada.

  6. Se o recurso não estiver em cache no POP da CDN ou se o cache tiver expirado, a CDN executará uma busca na origem no bucket do OSS.

  7. O bucket do OSS retorna o recurso ao POP da CDN, que então o armazena em cache.

  8. O POP da CDN entrega o recurso de mídia ao cliente.

Próximas etapas