Formatos compatíveis

Ao definir os formatos compatíveis com o ExoPlayer, é importante observar que os "formatos de mídia" são definidos em vários níveis. Do nível mais baixo ao mais alto, são eles:

  • O formato das amostras de mídia individuais (como um frame de vídeo ou de áudio). Estes são exemplos de formatos. Um arquivo de vídeo típico contém mídia em pelo menos dois formatos de amostra: um para vídeo (por exemplo, H.264) e outro para áudio (por exemplo, AAC).
  • O formato do contêiner que abriga as amostras de mídia e os metadados associados. Esses são formatos de contêiner. Um arquivo de mídia tem um único formato de contêiner (por exemplo, MP4), que geralmente é indicado pela extensão de arquivo. Em alguns formatos somente de áudio (por exemplo, MP3), os formatos de amostra e contêiner podem ser os mesmos.
  • Tecnologias de streaming adaptável, como DASH, SmoothStreaming e HLS. Eles não são formatos de mídia, mas ainda é necessário definir o nível de suporte que o ExoPlayer oferece.

As seções a seguir definem o suporte do ExoPlayer em cada nível, do mais alto ao mais baixo. As duas últimas seções descrevem o suporte a formatos de legenda independentes e reprodução de vídeo HDR.

Streaming adaptável

DASH

O ExoPlayer oferece suporte ao DASH com vários formatos de contêiner. Os streams de mídia precisam ser demultiplexados, ou seja, o vídeo, o áudio e o texto precisam ser definidos em elementos AdaptationSet distintos no manifesto DASH (o CEA-608 é uma exceção, conforme descrito na tabela abaixo). Os formatos de amostra de áudio e vídeo contidos também precisam ser compatíveis (consulte a seção formatos de amostra para mais detalhes).

Recurso Compatível Comentários
Contêineres
FMP4 SIM Somente streams desmultiplexados
WebM SIM Somente streams desmultiplexados
Matroska SIM Somente streams desmultiplexados
MPEG-TS NÃO Nenhum suporte planejado
Legendas descritivas / legendas
TTML SIM Bruto ou incorporado em FMP4 de acordo com a ISO/IEC 14496-30
WebVTT SIM Bruto ou incorporado em FMP4 de acordo com a ISO/IEC 14496-30
CEA-608 SIM Incorporado em FMP4 quando sinalizado usando descritores de acessibilidade SCTE
CEA-708 SIM Incorporado em FMP4 quando sinalizado usando descritores de acessibilidade SCTE
Metadados
Metadados de EMSG SIM Incorporado em FMP4
Proteção de conteúdo
Widevine SIM Esquema "cenc": API 19+; esquema "cbcs": API 25+
PlayReady SL2000 SIM Android TV, somente esquema "cenc"
ClearKey SIM API 21+, somente esquema "cenc"
Inserção de anúncios
Reprodução de vários períodos SIM
Inserção de anúncios guiada pelo servidor (xlinks) NÃO
Anúncios do IMA do lado do servidor e do lado do cliente SIM Guia de inserção de anúncios
Reprodução ao vivo
Reprodução ao vivo normal SIM
Reprodução ao vivo de CMAF com latência ultrabaixa SIM
Dados comuns do cliente de mídia (CMCD, na sigla em inglês) SIM Guia de integração do CMCD

SmoothStreaming

O ExoPlayer é compatível com o SmoothStreaming com o formato de contêiner FMP4. Os streams de mídia precisam ser demuxados, ou seja, o vídeo, o áudio e o texto precisam ser definidos em elementos StreamIndex distintos no manifesto do SmoothStreaming. Os formatos de amostra de áudio e vídeo contidos também precisam ser compatíveis (consulte a seção formatos de amostra para mais detalhes).

Recurso Compatível Comentários
Contêineres
FMP4 SIM Somente streams desmultiplexados
Legendas descritivas/legendas
TTML SIM Incorporado em FMP4
Proteção de conteúdo
PlayReady SL2000 SIM Somente no Android TV
Reprodução ao vivo
Reprodução ao vivo normal SIM
Dados comuns do cliente de mídia (CMCD, na sigla em inglês) SIM Guia de integração

HLS

O ExoPlayer oferece suporte ao HLS com vários formatos de contêiner. Os formatos de amostra de áudio e vídeo contidos também precisam ser compatíveis (consulte a seção Formatos de amostra para mais detalhes). Recomendamos que os produtores de conteúdo HLS gerem transmissões HLS de alta qualidade, conforme descrito nesta postagem do blog.

Recurso Compatível Comentários
Contêineres
MPEG-TS SIM
FMP4/CMAF SIM
ADTS (AAC) SIM
MP3 SIM
Legendas descritivas / legendas
CEA-608 SIM
CEA-708 SIM
WebVTT SIM
Metadados
ID3 SIM
SCTE-35 NÃO
Proteção de conteúdo
AES-128 SIM
Exemplo de AES-128 NÃO
Widevine SIM API 19+ (esquema "cenc") e 25+ (esquema "cbcs")
PlayReady SL2000 SIM Somente no Android TV
Controle do servidor
Atualizações delta SIM
Bloqueio do recarregamento da playlist SIM
Bloqueio do carregamento de dicas de pré-carregamento SIM Exceto para intervalos de bytes com comprimentos indefinidos
Inserção de anúncios
Inserção de anúncios guiada pelo servidor (intersticiais) Parcialmente Somente VOD com X-ASSET-URI. As transmissões ao vivo e o X-ASSET-LIST serão adicionados mais tarde.
Anúncios do IMA do lado do servidor e do lado do cliente SIM Guia de inserção de anúncios
Reprodução ao vivo
Reprodução ao vivo normal SIM
HLS de baixa latência (Apple) SIM
HLS de baixa latência (comunidade) NÃO
Dados comuns do cliente de mídia CMCD SIM Guia de integração do CMCD

Formatos de contêiner progressivos

As transmissões nos seguintes formatos de contêiner podem ser reproduzidas diretamente pelo ExoPlayer. Os formatos de amostra de áudio e vídeo contidos também precisam ser compatíveis (consulte a seção Formatos de amostra para mais detalhes). Para suporte a contêineres e formatos de imagem, consulte Imagens.

Formato do contêiner Compatível Comentários
MP4 SIM
M4A SIM
FMP4 SIM
WebM SIM
Matroska SIM
MP3 SIM Alguns streams só podem ser buscados usando a busca de taxa de bits constante**
Ogg SIM Contém Vorbis, Opus e FLAC
WAV SIM
MPEG-TS SIM
MPEG-PS SIM
FLV SIM Não é possível avançar ou retroceder*
ADTS (AAC) SIM Só é possível buscar usando a busca de taxa de bits constante**
FLAC SIM Usando a biblioteca FLAC ou o extrator FLAC na biblioteca ExoPlayer***
AMR SIM Só é possível buscar usando a busca de taxa de bits constante**

* A busca não é compatível porque o contêiner não fornece metadados (por exemplo, um índice de amostra) para permitir que um player de mídia realize uma busca de maneira eficiente. Se a busca for necessária, sugerimos usar um formato de contêiner mais apropriado.

** Esses extratores têm flags FLAG_ENABLE_CONSTANT_BITRATE_SEEKING para ativar a busca aproximada usando uma suposição de taxa de bits constante. Essa funcionalidade não é ativada por padrão. A maneira mais simples de ativar essa funcionalidade para todos os extratores compatíveis é usar DefaultExtractorsFactory.setConstantBitrateSeekingEnabled, conforme descrito aqui.

*** O extrator da biblioteca FLAC gera áudio bruto, que pode ser processado pelo framework em todos os níveis da API. O extrator de FLAC da biblioteca ExoPlayer gera frames de áudio FLAC e, portanto, depende de um decodificador FLAC (por exemplo, um decodificador MediaCodec que processa FLAC, necessário a partir do nível 27 da API, ou a biblioteca FFmpeg com FLAC ativado). O DefaultExtractorsFactory usa o extrator de extensão se o aplicativo foi criado com a biblioteca FLAC. Caso contrário, ele usa o extrator da biblioteca ExoPlayer.

RTSP

O ExoPlayer é compatível com RTSP ao vivo e on demand. Os formatos de amostra e os tipos de rede compatíveis estão listados abaixo.

Formatos de amostra compatíveis

  • H264 (a descrição de mídia SDP precisa incluir dados SPS/PPS no atributo fmtp para inicialização do decodificador).
  • AAC (com bitstream ADTS).
  • AC3.

Tipos de rede compatíveis

  • RTP por unicast UDP (multicast não é compatível).
  • RTSP intercalado, RTP sobre RTSP usando TCP.

Formatos de amostra

Por padrão, o ExoPlayer usa os decodificadores da plataforma Android. Portanto, os formatos de amostra compatíveis dependem da plataforma em questão, e não do ExoPlayer. Consulte Formatos de mídia compatíveis para ver a documentação sobre formatos de amostra compatíveis com dispositivos Android. Dispositivos individuais podem aceitar outros formatos além dos listados.

Além dos decodificadores da plataforma Android, o ExoPlayer também pode usar extensões de decodificador de software. Eles precisam ser criados manualmente e incluídos em projetos que queiram usá-los. No momento, oferecemos bibliotecas de decodificadores de software para AV1, VP9, FLAC, Opus, FFmpeg, MIDI, IAMF e MPEG-H.

Biblioteca FFmpeg

A biblioteca FFmpeg (link em inglês) é compatível com a decodificação de vários formatos de amostra de áudio. É possível escolher quais decodificadores incluir ao criar a biblioteca, conforme documentado no README.md dela. A tabela a seguir fornece um mapeamento do formato de amostra de áudio para o nome do decodificador FFmpeg correspondente.

Formato de amostra Nomes dos decodificadores
Vorbis vorbis
Opus opus
FLAC flac
ALAC alac
PCM μ-law pcm_mulaw
PCM A-law pcm_alaw
MP1, MP2, MP3 mp3
AMR-NB amrnb
AMR-WB amrwb
AAC aac
AC-3 ac3
E-AC-3 eac3
DTS, DTS-HD dca
TrueHD mlp truehd

Imagens

O ExoPlayer é compatível com os seguintes formatos de imagem. Consulte Bibliotecas de carregamento de imagens para saber como fazer a integração com bibliotecas externas que podem oferecer suporte a um conjunto diferente de formatos.

Formato da imagem Compatível Observações
BMP SIM
GIF NÃO Sem suporte para Extractor
JPEG SIM
Foto com movimento JPEG SIM Compatível com imagens estáticas e vídeos
JPEG Ultra HDR SIM Volta para SDR antes do Android 14 ou em telas não HDR
PNG SIM
WebP SIM
HEIF/HEIC SIM
Foto com movimento HEIC SIM
AVIF (valor de referência) SIM Decodificado apenas no Android 14 ou mais recente

Formatos de legenda independentes

O ExoPlayer é compatível com arquivos de legenda independentes em vários formatos. Os arquivos de legenda podem ser carregados por sideload, conforme descrito na página de itens de mídia.

Formato do contêiner Compatível Tipo MIME
WebVTT SIM MimeTypes.TEXT_VTT
TTML / SMPTE-TT SIM MimeTypes.APPLICATION_TTML
SubRip SIM MimeTypes.APPLICATION_SUBRIP
SubStationAlpha (SSA/ASS) SIM MimeTypes.TEXT_SSA

Reprodução de vídeo HDR

O ExoPlayer processa a extração de vídeos em High Dynamic Range (HDR) em vários contêineres, incluindo Dolby Vision em MP4 e HDR10+ em Matroska/WebM. A decodificação e a exibição de conteúdo HDR dependem do suporte da plataforma Android e do dispositivo. Consulte Reprodução de vídeo HDR para Aprenda Mais sobre como verificar os recursos de decodificação e exibição de HDR e as limitações do suporte a HDR em todas as versões do Android.

Ao reproduzir um stream HDR que exige suporte para um perfil de codec específico, o seletor MediaCodec padrão do ExoPlayer vai escolher um decodificador compatível com esse perfil (se disponível), mesmo que outro decodificador para o mesmo tipo MIME que não seja compatível com esse perfil apareça mais acima na lista de codecs. Isso pode resultar na seleção de um decodificador de software nos casos em que o stream excede os recursos de um decodificador de hardware para o mesmo tipo MIME.