Introdução ao ApsaraVideo Player SDK for web - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Visão geral

O ApsaraVideo Player SDK for web utiliza a tag <video> do HTML5 (H5) para reproduzir vídeos em aplicações web. O SDK é compatível com diversos navegadores, como Chrome e Safari, garantindo uma experiência de reprodução consistente em várias plataformas. Quando utilizado com o ApsaraVideo Live e o ApsaraVideo VOD, o ApsaraVideo Player SDK for web também suporta recursos como proteção contra hotlink, reprodução criptografada para vídeos com direitos autorais e monitoramento de qualidade.

Atualização de licença

A partir de 1º de dezembro de 2024, é necessário obter uma licença para usar o ApsaraVideo Player SDK for web V2.28.0 e versões posteriores. Para obter instruções, consulte Gerenciar licenças. Se você utiliza uma versão anterior à 2.28.0, essa alteração não o afeta. No entanto, recomendamos atualizar para a versão mais recente para receber serviços e suporte mais abrangentes.

Protocolos suportados

Cenários de VOD

A tabela a seguir descreve os protocolos de reprodução e formatos de codificação de VOD suportados pelo ApsaraVideo Player SDK for web.

Formato de codificação de vídeo	Protocolo de vídeo	Formato de arquivo de áudio	Formato de codificação de áudio
H.264	MP4 FLV HLS	MP3	AAC
H.265 Nota Para reproduzir fluxos de vídeo codificados em H.265, preencha primeiro um formulário para solicitar uma licença. Alguns navegadores não suportam a reprodução de vídeo H.265. Ative a reprodução de vídeo H.265 aumenta o consumo de tráfego e a latência de inicialização.	MP4 FLV HLS	-
H.266 Nota Para reproduzir fluxos de vídeo codificados em H.266, preencha primeiro um formulário para solicitar uma licença. Alguns navegadores não suportam a reprodução de vídeo H.266. Ative a reprodução de vídeo H.266 aumenta o consumo de tráfego e a latência de inicialização.	MP4	-

Cenários de transmissão ao vivo

A tabela a seguir descreve os protocolos de reprodução e formatos de codificação de transmissão ao vivo suportados pelo ApsaraVideo Player SDK for web.

Formato de codificação de vídeo	Protocolo de vídeo	Formato de codificação de áudio	Formato de arquivo de áudio
H.264	HLS, FLV, RTS, DASH	AAC	-
H.265	HLS, FLV (codecId=12)
H.266	HLS, FLV

A tabela a seguir descreve os benefícios e as limitações de cada protocolo de transmissão ao vivo.

Protocolo de transmissão ao vivo	Vantagem	Desvantagem	Latência
HLS	Alta compatibilidade com navegadores.	Alta latência.	> 10s
FLV	Suporta cenários de alta concorrência e é mais adequado para aplicativos nativos.	A reprodução exige a integração do navegador com o ApsaraVideo Player SDK for web.	1s a 3s
RTS	Bom desempenho em condições de rede precárias. Os vídeos são reproduzidos suavemente mesmo com uma taxa de perda de pacotes de 30%.	A reprodução exige a integração do navegador com o ApsaraVideo Player SDK for web.	< 1s
DASH	Taxa de bits adaptativa.	Alta latência.	> 10s

Compatibilidade com navegadores

Compatibilidade com navegadores desktop

Importante

Para reproduzir vídeos FLV e HLS em navegadores desktop, ative o acesso entre domínios.

Navegador	MP4	FLV	HLS	MP3
Chrome	✓	34 e posterior	34 e posterior	✓
Firefox	✓	49 e posterior	49 e posterior	✓
Edge	✓	✓	✓	✓
Opera	✓	✓	✓	✓
Safari	✓	8 e posterior	8 e posterior	✓

Compatibilidade com navegadores móveis

Nota

O ApsaraVideo Player SDK for web não suporta a reprodução de vídeo FLV em dispositivos móveis.

Tabela 1. Compatibilidade de navegadores H5 no Android

Navegador	HLS	MP4	MP3	FLV
Chrome	34 e posterior	✓	✓	×
Firefox	49 e posterior
WeChat	✓
Edge	✓
Opera	✓

Tabela 2. Compatibilidade de navegadores H5 no iOS

Navegador	HLS	MP4	MP3	FLV
Chrome	34 e posterior	✓	✓	×
Firefox	49 e posterior
WeChat	✓
Edge	✓
Opera	✓
Safari	8 e posterior

Compatibilidade de recursos

Recurso	Desktop	Móvel	Como configurar
Reprodução em tela cheia	Por padrão, os vídeos não são reproduzidos em tela cheia.	Por padrão, os vídeos são reproduzidos em tela cheia. Configurações diferentes são necessárias para cenários distintos. Nota Não é possível desativar a reprodução automática em tela cheia no Safari em dispositivos com versões do iOS anteriores à 10. Ao reproduzir vídeos fora do modo de tela cheia, ajuste o tamanho do vídeo com base na proporção da resolução transcodificada para evitar barras pretas.	Configurações de tela cheia
Reprodução automática	A restrição vem do navegador, não do ApsaraVideo Player SDK for web. A reprodução automática é restrita no Safari 11 e posterior no macOS High Sierra. A reprodução automática é restrita no Chrome 55 e posterior.	Desativado por padrão. Configurações especiais são necessárias para ativá-lo. Nota Alguns navegadores e WebViews podem permitir a reprodução automática. Isso é comum em sistemas Android.	Reprodução automática
Ajuste de volume	Suportado	Como a propriedade `video.volume` é somente leitura no iOS e em alguns sistemas Android, os métodos `getVolume` e `setVolume` fornecidos pelo ApsaraVideo Player SDK for web não funcionam no iOS e em alguns sistemas Android.	Ajuste de volume
Velocidade de reprodução	Suportado	Alguns navegadores móveis não suportam o ajuste da velocidade de reprodução, como o WeChat no Android.	Velocidade de reprodução
Reprodução de vídeo criptografado padrão HLS	Chrome FireFox Safari Edge	Suportado	Como reproduzir um vídeo criptografado
Criptografia HLS proprietária da Alibaba Cloud Nota Por motivos de segurança, a criptografia proprietária da Alibaba Cloud não suporta depuração com vídeos reais criptografados.	Chrome FireFox Safari Edge Nota Alguns navegadores de terceiros sequestram forçosamente o player. Isso desativa a criptografia proprietária da Alibaba Cloud e causa falha na reprodução. Nesse caso, use a criptografia padrão HLS ou criptografia DRM.	Suportado em navegadores no iOS 14 e posterior. Nota Para ativar o suporte a versões do iOS anteriores à 17,1, implante um script de plugin adicional para o player. Este script aplica-se apenas ao navegador Safari. Outros navegadores, como WeChat, DingTalk e QQ Browser, não podem ser usados devido a limitações do sistema. Oriente os usuários a reproduzir o vídeo no navegador Safari. Para mais informações, consulte Instruções de implantação do plugin de criptografia proprietária em versões do iOS anteriores à 17,1. Suportado na maioria dos navegadores na plataforma Android. Nota Como alguns navegadores sequestram a reprodução de vídeo, sabe-se que os seguintes navegadores não suportam a reprodução de vídeos criptografados com a criptografia proprietária da Alibaba Cloud: UC Browser, Quark e Baidu. Oriente os usuários a reproduzir os vídeos em outros navegadores.	Como reproduzir um vídeo criptografado
Reprodução de transmissões ao vivo criptografadas com DRM	Windows Chrome Opera FireFox Edge macOS Chrome Safari FireFox Opera Edge	iOS Chrome Safari Android Chrome no Android 10 e posterior Edge	Como reproduzir um vídeo criptografado
Reprodução de fluxos VOD criptografados com DRM	Windows Chrome Opera FireFox Edge macOS Chrome Safari FireFox Opera Edge	iOS Chrome Safari Android Chrome no Android 10 e posterior Edge	Como reproduzir um vídeo criptografado