ApsaraVideo VOD:Get playback URLs

Obter URLs via notificações de eventos

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

Observações de uso

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

• Ao desativar ou exclua 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 fluxo criptografado. O player deverá descriptografá-lo antes da reprodução.

Obter URLs por chamadas de API/SDK

Ao fazer upload de um arquivo de mídia no ApsaraVideo VOD, o sistema atribui um VideoId. Chame a operação GetPlayInfo com o VideoId para recuperar a URL de reprodução.

Observações de uso

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

• Se você tiver ativado a Alibaba Cloud proprietary cryptography, a reprodução do vídeo só será possível com o ApsaraVideo Player. A API GetPlayInfo não retorna fluxos com criptografia privada por padrão. Defina ResultType como Multiple para obter todos os fluxos concluídos, inclusive os criptografados.

• Se a HLS encryption estiver ativada, a API priorizará o retorno do fluxo com criptografia padrão para reprodução.

• Para arquivos de mídia com tiered storage configurado, a API apresenta o seguinte comportamento:

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

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

• Dentro do período de validade, a URL de reprodução não se restringe a um dispositivo específico. Vários dispositivos (PC, dispositivos móveis, ApsaraVideo Player SDK, etc.) podem usar a mesma URL simultaneamente, pois o player não impõe restrições à reutilização da URL.

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.

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

2. O servidor chama a 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 encaminha 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 recebida.

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 armazena o recurso em cache.

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