O ApsaraVideo Player SDK, parte do MediaBox Audio and Video SDK, oferece reprodução de vídeo para streaming ao vivo e VOD em Android, iOS, Flutter, HarmonyOS, Web, Windows e macOS. As tabelas a seguir listam os recursos compatíveis e a disponibilidade por plataforma.
A partir de 14 de fevereiro de 2025 (versão 7.0.0), a Edição Profissional está disponível para o ApsaraVideo Player SDK móvel, além da Edição Standard. Entre em contato com a equipe de desenvolvimento de negócios para obtê-la e ative-a conforme Activate a player license.
Se os gastos com recursos do ApsaraVideo VOD, ApsaraVideo Live ou Intelligent Media Services atingirem um determinado valor, uma licença gratuita de um ano da Edição Profissional será incluída. ApsaraVideo Player SDK billing.
Licenças da Edição Profissional recém-obtidas para dispositivos móveis requerem a versão 7.0.0 ou posterior. Verifique a versão do seu SDK antes de solicitar a licença.
Símbolos das tabelas
|
Símbolo |
Significado |
|
Compatível |
O recurso está disponível nesta plataforma. |
|
Não compatível |
O recurso não está disponível nesta plataforma. |
|
N/A |
O recurso não se aplica a esta plataforma. |
|
Pro |
O recurso exige a Edição Profissional. |
Recursos padrão
Protocolos e formatos de reprodução
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Reprodução sob demanda |
Reproduz formatos de áudio e vídeo sob demanda: FLV, HLS, MP4 e MP3. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^1] |
|
Reprodução ao vivo |
Executa formatos de streaming ao vivo: RTMP, FLV e HLS. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^2] |
|
Time shifting |
Permite reproduzir streams ao vivo com deslocamento temporal. Defina o horário de início, término e o tempo atual suportado. Inclui suporte a busca por arraste. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Codec H.264 |
Decodifica fluxos de vídeo codificados em H.264. Permite alternar entre decodificação via software e hardware. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^3] |
|
Codec H.265 |
Processa fluxos de vídeo codificados em H.265. Oferece alternância entre decodificação por software e hardware. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^4] |
|
Codec H.266 |
Compatível com fluxos de vídeo codificados em H.266. |
Compatível (Pro) [^5] |
Compatível (Pro) [^6] |
Não compatível |
Não compatível |
Compatível [^4] |
|
Reprodução adaptativa H.265 |
Caso a decodificação por hardware H.265 falhe e haja um stream de backup H.264 configurado, o player muda para o fluxo H.264. Caso contrário, reverte para decodificação por software H.265. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Não compatível |
Não compatível |
|
Real-Time Streaming (RTS) |
Integração com o RTS da Alibaba Cloud para alta concorrência, baixa taxa de travamentos e latência na casa dos milissegundos. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível |
|
Streaming ao vivo de baixa latência |
Reproduz fluxos de baixa latência utilizando os protocolos LL-HLS e DASH. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Protocolo DASH |
Executa fluxos de vídeo DASH padrão, incluindo SegmentBase e SegmentTemplate. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Compatível |
|
Aceleração QUIC |
Utiliza o protocolo de transporte QUIC para aumentar a eficiência na transmissão de vídeo. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
|
Reprodução de vídeo HDR |
Compatível com formatos HDR, incluindo HDR10 e HLG. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível [^3] |
|
Reprodução via URL |
Executa vídeos online e locais a partir de uma URL. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Reprodução por VID |
Reproduz vídeos pelo ID do vídeo (VID). Recupera URLs de streaming para múltiplas definições. Compatível com VidAuth e VidSts. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Mensagens SEI |
Recebe e lê mensagens de Supplemental Enhancement Information (SEI). |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
Protocolos de rede
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Cabeçalho personalizado |
Personaliza cabeçalhos HTTP nas solicitações de recursos de áudio ou vídeo. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^7] |
|
HTTPDNS para domínio cloud |
Resolve domínios via HTTP em vez de DNS local para evitar sequestro de DNS e falhas entre redes. Apenas domínios da Alibaba Cloud. |
Compatível |
Compatível |
Compatível |
Compatível |
Não compatível |
|
HTTP/2 |
Aproveita o enquadramento binário, multiplexação e compressão de cabeçalho do HTTP/2 para reduzir a latência. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^8] |
|
HTTP/3 |
Utiliza HTTP/3 baseado em QUIC para entrega de vídeo mais rápida. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^9] |
Controle de reprodução
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Controles básicos |
Iniciar, parar, pausar, buscar e reprodução automática. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Busca |
Avança para uma posição específica com suporte a gestos. Preserva o conteúdo em buffer. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Busca precisa |
Localiza uma posição específica com precisão no nível de quadro. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^10] |
|
Busca no cache |
Realiza busca dentro do conteúdo em buffer sem limpá-lo, garantindo maior rapidez. |
Compatível |
Compatível |
Compatível |
Compatível |
Não compatível |
|
Retomada de reprodução |
Define um horário inicial para continuar a reprodução a partir de uma posição anterior. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Reprodução em loop |
Repete automaticamente o áudio ou vídeo após o término da reprodução. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Reprodução em lista |
Reprodução baseada em playlist para vídeos curtos, com carregamento mais rápido. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Controle de velocidade |
Ajusta a velocidade de reprodução sem alterar o tom do áudio. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Troca manual de definição |
Alterna entre múltiplas definições para fluxos de vídeo sob demanda. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Troca contínua |
Muda a resolução de streams ao vivo durante a reprodução (switchStream). Apenas URLs ao vivo da Alibaba Cloud. |
Compatível |
Compatível |
Compatível |
Não compatível |
Não compatível [^11] |
|
Alternar faixas de áudio |
Troca entre várias faixas de áudio em fluxos de vídeo sob demanda. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível |
|
Captura de tela |
Captura o quadro atual do vídeo e salva como imagem estática. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
|
Bloqueio de tela |
Bloqueia a rotação da tela e oculta elementos da interface. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
|
Legendas externas |
Importa arquivos de legenda personalizados. Clientes móveis aceitam legendas SRT, SSA, ASS e VTT. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Compatível [^12] |
|
Transmissão de tela |
O SDK de transmissão de tela foi descontinuado e o recurso não é mais compatível. Para implementar essa funcionalidade, utilize as URLs de vídeo fornecidas pelo ApsaraVideo VOD com protocolos de terceiros como DLNA, AirPlay ou Miracast, ou use SDKs do fabricante do dispositivo. |
Não compatível |
Não compatível |
Não compatível |
Não compatível |
Não compatível |
Efeitos de vídeo
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Preenchimento |
Dois modos de exibição: preencher e recortar. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Rotação |
Define o ângulo de renderização do vídeo para 0, 90, 180 ou 270 graus. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Espelhamento |
Três modos de espelho: nenhum, horizontal e vertical. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Prévia de miniatura (sprite) |
Exibe prévias em miniatura na barra de progresso. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível |
|
Ajuste de brilho |
Modifica o brilho do sistema. A interface suporta gestos. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
|
Tamanho personalizado do player |
Define largura e altura personalizadas para o player. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Reprodução Picture-in-Picture (PiP) |
Muda para o modo PiP para reprodução em janela pequena. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
Efeitos de áudio
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Ajuste de volume |
Controla o volume do vídeo por meio de APIs do sistema. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Mudo |
Ativa e desativa o silenciamento. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Reprodução apenas de áudio |
Toca somente o áudio de um arquivo de vídeo ou reproduz arquivos de áudio como MP3 e AAC. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Áudio de canal duplo |
Reproduz áudio com dois canais. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Múltiplas faixas de áudio |
Executa arquivos de vídeo com várias faixas de áudio. Permite trocar de faixa durante a reprodução. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível |
|
Reprodução em segundo plano |
Continua a reprodução de áudio depois que o aplicativo vai para o segundo plano. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
Desempenho de reprodução
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Nova tentativa em caso de falha |
Tenta novamente de forma automática quando a reprodução falha. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Reconexão automática |
Restabelece a conexão automaticamente para streams ao vivo. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Cache local |
Armazena conteúdo localmente durante a reprodução. Reduz o consumo de largura de banda em loops de vídeos curtos. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
|
Pré-carregamento |
Controla dinamicamente o pré-carregamento com política de janela deslizante. Melhora a velocidade do primeiro quadro e a fluidez da rolagem. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Não compatível |
|
Pré-renderização |
Pré-renderiza o primeiro quadro do próximo vídeo para reduzir telas pretas durante transições. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Não compatível |
Não compatível |
|
Demo multi-instância baseada em cenário |
Demonstrações completas de código-fonte para cenários como curtas-metragens. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Não compatível |
Não compatível |
|
Múltiplas instâncias |
Adiciona vários players a uma única interface para reprodução simultânea. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Streaming adaptativo de bitrate |
Alterna perfeitamente entre streams HLS e DASH com múltiplos bitrates. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Sincronização dinâmica de quadros |
Sincroniza quadros dinamicamente para streams ao vivo, reduzindo a latência. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Política avançada de ABR |
ABR aprimorado para streams HLS e DASH com múltiplos bitrates. Diminui travamentos e eleva o bitrate médio em comparação às políticas padrão. |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Compatível (Pro) |
Não compatível |
Recursos interativos
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Legendas |
Importa arquivos de legenda personalizados. |
Compatível [^13] |
Compatível [^13] |
Compatível [^13] |
Não compatível [^14] |
Compatível [^12] |
Segurança de vídeo
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Listas de bloqueio e permissão de Referer |
Filtra solicitações pelo cabeçalho Referer usando listas de bloqueios ou de permissões. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Criptografia HLS |
Compatível com o esquema de criptografia padrão AES-128. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Criptografia Alibaba Cloud (privada) |
Criptografa vídeos HLS e MP4 com a criptografia privada da Alibaba Cloud para evitar vazamentos e hotlinking. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^15] |
|
Criptografia de vídeo Alibaba Cloud (baseada em licença privada) |
Reproduz diretamente a partir de URLs criptografadas. Início mais rápido e melhor suporte entre regiões do que a criptografia privada padrão. |
Compatível |
Compatível |
Compatível |
Compatível |
Não compatível |
|
Download seguro |
Baixa e criptografa vídeos por meio de um aplicativo exclusivo. |
Compatível |
Compatível |
Compatível |
Compatível |
N/A |
|
DRM comercial |
Suporta esquemas de criptografia DRM Widevine e FairPlay. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível |
Qualidade de service
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Relatório de logs |
Envia logs do SDK e coleta métricas de reprodução para VOD e streaming ao vivo. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Rastreamento de problemas de reprodução |
Acompanha o histórico de reprodução por usuário ou sessão para diagnosticar falhas. |
Compatível [^16] |
Compatível [^16] |
Compatível [^16] |
Compatível [^16] |
Compatível [^16] |
|
Painel de dados de reprodução |
Monitora métricas agregadas de reprodução, como contagem de execuções e usuários únicos. |
Compatível [^16] |
Compatível [^16] |
Compatível [^16] |
Compatível [^16] |
Compatível [^16] |
Suporte ao desenvolvedor
|
Recurso |
Descrição |
Android |
iOS |
Flutter |
HarmonyOS |
Web |
|
Saída de dados renderizados |
Exporta dados PCM e YUV durante a renderização. |
Compatível |
Compatível |
Compatível |
Não compatível |
Não compatível |
|
Callbacks de eventos |
Fornece callbacks para status de reprodução, primeiro quadro, conclusão e falha na reprodução. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível |
|
Lista de bloqueio de política de decodificação |
Lista modelos de dispositivos que não suportam decodificação por hardware, com suporte a otimizações. |
Compatível |
Compatível |
Compatível |
Não compatível |
N/A |
|
Exibição de velocidade de rede |
Informa a velocidade da rede em tempo real para a instância do player. |
Compatível |
Compatível |
Compatível |
Compatível |
Compatível [^17] |
|
Componentes de UI |
Oferece uma interface completa pronta para uso. |
Compatível |
Compatível |
Compatível |
Não compatível |
Compatível |
Recursos de valor agregado
Para usar esses recursos, primeiro envie um ticket para solicitar e ativar o service.
Recurso | Descrição | Android | iOS | Flutter | HarmonyOS | Web |
Reprodução de vídeo H.265/H.266 na web | Reproduz fluxos de vídeo codificados em H.265 e H.266. Permite alternar entre decodificação por software e hardware. Advanced features. Para ativar, envie um ticket ou entre em contato com um gerente de negócios da Alibaba Cloud. | Não compatível | Não compatível | Não compatível | Não compatível | Compatível |
Notas de rodapé
[^1]: Alguns clientes móveis não suportam FLV. [^2]: RTMP não é suportado. Alguns clientes móveis não suportam FLV. [^3]: A decodificação por software ou hardware depende das configurações do navegador. [^4]: A decodificação por software ou hardware depende das configurações do navegador. Requer ativação. Value-added features. [^5]: Requer o H.266 decoding plugin. [^6]: Requer o H.266 decoding plugin. [^7]: Não compatível com MP4. Parcialmente compatível com HLS e DASH. [^8]: Depende do suporte do navegador. Can I use http2? [^9]: Depende do suporte do navegador. Can I use http3? [^10]: Oferece precisão no nível de milissegundo. [^11]: A troca contínua é compatível com HLS e DASH. [^12]: Suporta legendas VTT. [^13]: Compatível com legendas SRT, SSA, ASS e VTT. [^14]: Apenas análise de texto de legenda. [^15]: Compatível com alguns navegadores. Feature compatibility. [^16]: A Edição Gratuita permite consultar dados dos últimos 3 dias. [^17]: Compatível apenas com Real-Time Streaming (RTS).