ApsaraVideo VOD:Media playback

Como funciona

A reprodução de um arquivo de áudio ou vídeo depende do seu Status. Apenas vídeos no estado Normal (campo Status definido como Normal) podem ser reproduzidos. Nesse caso, obtenha as URLs de reprodução por meio da API ou do SDK do ApsaraVideo VOD.

Os diagramas a seguir mostram a alteração do status de um vídeo desde o upload até a reprodução:

• Com transcodificação

  

• Sem transcodificação

  

Portanto, antes de obter uma URL de reprodução, certifique-se de que o status do vídeo mudou para Normal.

Método de determinação

Após o upload, o vídeo não fica imediatamente pronto para reprodução, pois o ApsaraVideo VOD precisa confirmar o recebimento do arquivo. Use notificações de eventos para determinar quando um vídeo enviado pode ser reproduzido.

• Para arquivos de vídeo ou áudio não transcodificados, a reprodução é possível após o recebimento da notificação de evento Video upload completed. Em seguida, chame a operação GetPlayInfo para obter a URL de reprodução. Apenas arquivos nos seguintes formatos podem ser reproduzidos diretamente sem transcodificação: MP4, FLV, M3U8, MP3 e WEBM.

• Para vídeos transcodificados, a reprodução é liberada após o recebimento da notificação de evento Single definition transcoding complete. Para garantir a disponibilidade de todas as definições, aguarde a notificação de evento Transcode complete antes de processar o vídeo.

Pré-requisitos

• Configure um nome de domínio acelerado . Para mais informações, consulte Domain name requirements. O ApsaraVideo VOD não exige a configuração de um nome de domínio acelerado. A necessidade de configurar um nome de domínio CDN depende do método de acesso ao vídeo: sem um nome de domínio acelerado, chame a operação GetPlayInfo (GetPlayInfo) para obter uma URL do OSS com parâmetros de autenticação por tempo limitado e use essa URL para reprodução. A reprodução funciona mesmo sem a configuração de um nome de domínio acelerado. Após configurar um nome de domínio acelerado, use o nome de domínio CDN para acesso anônimo ou utilize a assinatura de URL para implementar controle de cache mais flexível. Ambos os métodos suportam reprodução normal; portanto, configurar um nome de domínio acelerado não é obrigatório para reproduzir vídeos.

• Resolva o registro CNAME do nome de domínio: verifique se há um registro CNAME associado ao nome de domínio. Caso contrário, a reprodução falhará. Para saber como associar um registro CNAME, consulte Configure a CNAME record with Alibaba Cloud DNS. Registros CNAME configurados no DNSPod também são suportados.

• Confirme a configuração de transcodificação: o ApsaraVideo VOD pode transcodificar ou não transcodificar os arquivos de mídia enviados. Para mais informações, consulte Audio and video transcoding.

• Verifique a configuração de segurança: o ApsaraVideo VOD oferece diversos mecanismos para proteger seu conteúdo de vídeo, incluindo controle de acesso, assinatura de URL, autenticação remota, criptografia de vídeo e download seguro. A possibilidade de reproduzir um vídeo depende dessas configurações de segurança. Para mais informações, consulte Video security.

• Configure uma licença para o ApsaraVideo Player SDK for web: a partir da versão 2.37.8 do ApsaraVideo Player SDK for web, é necessário configurar uma License para usar o SDK. Uma licença válida também é necessária em ambientes de teste localhost, e não há licenças temporárias disponíveis. Crie um Web Application no console do ApsaraVideo VOD e adquira gratuitamente uma licença vinculada. Após obter a License Key e o nome de domínio vinculado, integre o código. Versões anteriores do SDK apresentam problemas de conformidade de dados. Se você utilizar o SDK fora da China continental, atualize para uma nova versão do SDK e vincule uma licença. Para obter as etapas detalhadas de solicitação e configuração de uma licença, consulte o License FAQ do ApsaraVideo Player SDK for web.

URLs de reprodução

• Configuração de nome de domínio acelerado

  Após configurar um nome de domínio acelerado no console do ApsaraVideo VOD, a URL de reprodução de um vídeo será uma URL de arquivo CDN. Visualize a URL na página Audio/Video > Manage > Video URL no console do ApsaraVideo VOD. As URLs de reprodução dividem-se em dois tipos, fixas e dinâmicas, dependendo da ativação da opção de assinatura de URL no gerenciamento de nomes de domínio. Para saber como ativar e configurar a assinatura de URL, consulte URL signing.

  • Endereço fixo

    Endereços fixos são adequados para cenários com baixos requisitos de segurança e permanecem válidos permanentemente. Trata-se do endereço sem informações de autenticação gerado quando a opção de autenticação está desativada. O valor do parâmetro auth_key na URL corresponde às informações de autenticação. Por padrão, a opção de autenticação fica desativada após a adição de um nome de domínio no console.

  • Endereço dinâmico

    Endereços dinâmicos são indicados para cenários com altos requisitos de segurança. O endereço é gerado dinamicamente e expira após um determinado período. O período de validade padrão de um endereço dinâmico corresponde ao default validity period configurado na assinatura de URL. Também é possível definir um tempo de expiração ao Generate Playback URLs ou ao chamar a operação GetPlayInfo. Se o endereço expirar, o CDN retornará HTTP 403 ao acessar o endereço.

    Exemplo de endereço dinâmico:

    http://example.aliyundoc.com/video/aliyun-sample.mp4?auth_key=1500523200-0-0-80cd3862d699b7118eed99103f2a****

    Nota

    Neste exemplo, o valor do parâmetro auth_key começa com o prefixo 1500523200, que corresponde às 12:00:00 de 20 de julho de 2017. Se o Default Validity Period estiver definido como 60 minutos, o endereço expirará às 13:00:00 de 20 de julho de 2017.

• Nenhum nome de domínio acelerado configurado

  • Sem a configuração de um nome de domínio acelerado, as URLs de reprodução retornadas serão URLs de arquivos do OSS. Nesse caso, a assinatura de URL não está disponível, mas as informações de autenticação do OSS são geradas por padrão. Para mais informações, consulte OSS - Include Signatures in URLs. Ao chamar a operação GetPlayInfo para obter uma URL de reprodução, ainda é possível usar o parâmetro AuthTimeout para especificar o tempo de expiração da URL do OSS do vídeo, mas não é permitido personalizar as informações de autenticação com base em um AccessKey.

  • Se você definir o Bucket de armazenamento como public-read na página Storage Management no console, poderá ignorar as informações de autenticação do OSS. Para mais informações, consulte Storage Management. Nessa situação, o endereço é permanentemente válido, mas o vídeo fica exposto a riscos de hotlinking e downloads ilegais. Portanto, sempre que possível, defina o Bucket de armazenamento como private.

Para mais informações sobre configurações comuns de URLs de reprodução, consulte Common playback settings.

Obtenha uma URL de reprodução das seguintes maneiras:

• Obtenção direta: visualize a notificação de evento enviada após a conclusão da transcodificação ou chame a operação GetPlayInfo.

• Troca automática via credencial de reprodução: use o ApsaraVideo Player SDK e chame a operação GetVideoPlayAuth para obter uma credencial de reprodução. O ApsaraVideo Player SDK usa automaticamente essa credencial para obter a URL de reprodução e reproduzir o vídeo.

Métodos de reprodução

• Visualização no console do ApsaraVideo VOD

  O player de visualização do ApsaraVideo VOD oferece recursos como avanço rápido, controle de volume, legendas, faixas de áudio, definições e comentários ao vivo, facilitando a visualização de vídeo.

  • Na página Audio/Video do console, selecione um vídeo para visualizar. Streams criptografados têm prioridade na reprodução.

  • Na página Audio/Video > Manage > Video URL do console, selecione um stream para visualizar. Para proteger a segurança do seu vídeo, apenas streams não criptografados podem ser visualizados.

• Integração do ApsaraVideo Player SDK

  • Obtenha uma credencial de reprodução no servidor e envie-a ao cliente para reprodução. Este método oferece maior segurança. Para mais informações, consulte Obtain a playback credential. Ao usar o ApsaraVideo Player SDK for web, observe que é necessário configurar uma licença. Para requisitos específicos, consulte a seção "Pré-requisitos".

  • O ApsaraVideo Player suporta reprodução direta de vídeo por meio de uma URL de reprodução. Passe a URL obtida diretamente para o player. Para mais informações, consulte Play a video using a playback URL.

  • O ApsaraVideo Player SDK está disponível nas edições standard e professional. A edição professional oferece suporte adicional a recursos avançados, como codificação H.266, protocolo DASH, legendas externas, pré-carregamento, pré-renderização e estratégias avançadas de ABR. A edição standard não inclui esses recursos. Se você precisar apenas de funcionalidades básicas de controle de reprodução, como reprodução de vídeos sob demanda ou ao vivo, velocidade variável e troca de resolução, a edição standard é suficiente. Caso necessite dos recursos avançados descritos acima, recomendamos adquirir a edição professional.

• Integração de player de terceiros

  • Integre um player de terceiros para play a video using a playback URL.

  • Após obter uma URL de reprodução, passe-a para seu próprio player. Embora este método seja flexível, requer implementação manual de recursos como troca de resolução e tratamento de exceções.

Segurança da reprodução (limites de reprodução e download)

• Segurança de vídeo

  Para proteger seu conteúdo de vídeo, o ApsaraVideo VOD fornece vários recursos de segurança, incluindo blacklists and whitelists, URL signing e criptografia de vídeo (Alibaba Cloud proprietary cryptography e HLS encryption). Para mais informações, consulte Video security overview.

• Segurança da conta

  Para garantir a segurança, não armazene o par AccessKey da sua conta Alibaba Cloud ou de um usuário do Resource Access Management (RAM) em clientes, especialmente clientes web, para acessar o ApsaraVideo VOD. Para mais informações, consulte Overview.

Descrição do faturamento

• Ao configurar um nome de domínio acelerado, haverá cobrança pelo service CDN durante a reprodução de arquivos de áudio ou vídeo.

• Sem a configuração de um nome de domínio acelerado, haverá cobrança pelo tráfego de saída do armazenamento durante a reprodução de arquivos de áudio ou vídeo.

Para mais informações, consulte Basic service billing.

FAQ

Como solucionar falhas na reprodução de vídeo?

1. Verifique a rede: confirme se o cliente possui conectividade de rede normal.

2. Verifique o status do vídeo: chame a operação Get Audio and Video Playback URLs ou verifique no console se o status do vídeo é Normal.

3. Verifique a URL ou credencial de reprodução: confira se o auth_key expirou ou se a assinatura está correta.

4. Verifique o player: confirme se o player utilizado suporta o formato do vídeo. Para informações sobre os formatos suportados pelo ApsaraVideo Player, consulte Features of ApsaraVideo Player SDK.

5. Travamentos ou falhas de carregamento ao abrir uma URL de reprodução copiada diretamente em um navegador móvel: isso ocorre porque a URL de reprodução não possui assinatura de URL ou porque o nome de domínio tem proteção contra hotlinking de Referer ativada, bloqueando a solicitação. Solução: verifique se a assinatura de URL está habilitada para a URL de reprodução e se a URL contém uma assinatura auth_key válida. Verifique também a configuração da lista de permissões de proteção contra hotlinking de Referer do nome de domínio. Recomendamos usar uma URL de reprodução assinada ou acessar o vídeo através do ApsaraVideo Player SDK em vez de expor diretamente a URL de reprodução original.

6. **Áudio e vídeo dessincronizados durante a reprodução em velocidade variável no componente video de um mini programa WeChat**: isso acontece porque o componente nativo video do mini programa WeChat não suporta totalmente listas de edição no nível subjacente. Consequentemente, o deslocamento inicial de áudio se acumula e é amplificado durante a reprodução em velocidade variável ou operações de busca. Solução: recomendamos usar o ApsaraVideo Player SDK for web em vez do componente nativo video, ou transcodificar o vídeo para melhorar a compatibilidade.

7. O player web para de funcionar após atualização do navegador Chrome (problema de compatibilidade HLS): recomendamos atualizar o ApsaraVideo Player SDK for web para a versão 2.37.8 ou posterior para resolver esse problema de compatibilidade e solicitar/configurar uma licença gratuita conforme necessário. Para informações sobre como solicitar uma licença, consulte a descrição na seção "Pré-requisitos".

Para mais informações sobre outras exceções, consulte Troubleshoot playback errors.

Como reproduzir vídeos criptografados?

O ApsaraVideo VOD oferece várias soluções de criptografia, como criptografia proprietária da Alibaba Cloud e criptografia HLS. Configure um grupo de modelos de transcodificação criptografada para transcodificar o vídeo e use o ApsaraVideo Player SDK para descriptografar e reproduzir o vídeo. Para mais informações, consulte Video encryption.

**A reprodução criptografada relata um erro InvalidParameter e indica que o parâmetro Rand é inválido**

Se um erro InvalidParameter for relatado e o parâmetro Rand for indicado como inválido durante a reprodução de um vídeo criptografado, defina o parâmetro encryptType correspondente na configuração de reprodução. Para informações sobre o método de configuração, consulte Video encryption.