Formatos compatibles

Cuando se definen los formatos que admite ExoPlayer, es importante tener en cuenta que los "formatos multimedia" se definen en varios niveles. Del nivel más bajo al más alto, son los siguientes:

  • El formato de las muestras de contenido multimedia individuales (como un fotograma de video o un fotograma de audio) Estos son formatos de muestra. Ten en cuenta que un archivo de video típico contendrá contenido multimedia en, al menos, dos formatos de muestra: uno para video (por ejemplo, H.264) y otro para audio (por ejemplo, AAC).
  • Es el formato del contenedor que aloja las muestras de contenido multimedia y los metadatos asociados. Estos son formatos de contenedor. Un archivo multimedia tiene un solo formato de contenedor (por ejemplo, MP4), que suele indicarse con la extensión de archivo. Ten en cuenta que, para algunos formatos de solo audio (por ejemplo, MP3), los formatos de muestra y contenedor pueden ser los mismos.
  • Tecnologías de transmisión adaptable, como DASH, SmoothStreaming y HLS Estos no son formatos de contenido multimedia como tales, pero aún es necesario definir qué nivel de compatibilidad proporciona ExoPlayer.

En las siguientes secciones, se define la compatibilidad de ExoPlayer en cada nivel, de mayor a menor. En las últimas dos secciones, se describe la compatibilidad con los formatos de subtítulos independientes y la reproducción de video HDR.

Transmisión adaptable

DASH

ExoPlayer admite DASH con varios formatos de contenedor. Las transmisiones de contenido multimedia deben demultiplexarse, lo que significa que el video, el audio y el texto deben definirse en elementos AdaptationSet distintos en el manifiesto de DASH (CEA-608 es una excepción, como se describe en la siguiente tabla). También se deben admitir los formatos de muestra de audio y video incluidos (consulta la sección Formatos de muestra para obtener más detalles).

Función Compatible Comentarios
Contenedores
FMP4 SÍ Solo transmisiones demultiplexadas
WebM SÍ Solo transmisiones demultiplexadas
Matroska SÍ Solo transmisiones demultiplexadas
MPEG-TS NO No se planea brindar asistencia
Subtítulos
TTML SÍ Sin procesar o incorporado en FMP4 según ISO/IEC 14496-30
WebVTT SÍ Sin procesar o incorporado en FMP4 según ISO/IEC 14496-30
CEA-608 SÍ Se incorporan en FMP4 cuando se indican con descriptores de accesibilidad de SCTE.
CEA-708 SÍ Se incorporan en FMP4 cuando se indican con descriptores de accesibilidad de SCTE.
Metadatos
Metadatos de EMSG SÍ Incorporados en FMP4
Protección del contenido
Widevine SÍ Esquema "cenc": API 19 y versiones posteriores; esquema "cbcs": API 25 y versiones posteriores
PlayReady SL2000 SÍ Android TV, solo esquema "cenc"
ClearKey SÍ API 21+, solo esquema "cenc"
Inserción de anuncios
Reproducción de varios períodos SÍ
Inserción de anuncios guiada por el servidor (xlinks) NO
Anuncios del servidor y del cliente de IMA SÍ Guía de inserción de anuncios
Reproducción en vivo
Reproducción en vivo normal SÍ
Reproducción en vivo de CMAF con latencia ultrabaja SÍ
Datos comunes de clientes multimedia (CMCD) SÍ Guía de integración de CMCD

SmoothStreaming

ExoPlayer admite SmoothStreaming con el formato de contenedor FMP4. Las transmisiones de contenido multimedia deben demultiplexarse, lo que significa que el video, el audio y el texto deben definirse en elementos StreamIndex distintos en el manifiesto de SmoothStreaming. También se deben admitir los formatos de muestra de audio y video incluidos (consulta la sección Formatos de muestra para obtener más detalles).

Función Compatible Comentarios
Contenedores
FMP4 SÍ Solo transmisiones demultiplexadas
Subtítulos
TTML SÍ Incorporados en FMP4
Protección del contenido
PlayReady SL2000 SÍ Únicamente para Android TV
Reproducción en vivo
Reproducción en vivo normal SÍ
Datos comunes de clientes multimedia (CMCD) SÍ Guía de integración

HLS

ExoPlayer admite HLS con varios formatos de contenedor. También se deben admitir los formatos de muestra de audio y video que contiene (consulta la sección Formatos de muestra para obtener más detalles). Recomendamos que los productores de contenido de HLS generen transmisiones de HLS de alta calidad, como se describe en esta entrada de blog.

Función Compatible Comentarios
Contenedores
MPEG-TS SÍ
FMP4/CMAF SÍ
ADTS (AAC) SÍ
MP3 SÍ
Subtítulos
CEA-608 SÍ
CEA-708 SÍ
WebVTT SÍ
Metadatos
ID3 SÍ
SCTE-35 NO
Protección del contenido
AES-128 SÍ
AES-128 de muestra NO
Widevine SÍ API 19 o superior (esquema "cenc") y 25 o superior (esquema "cbcs")
PlayReady SL2000 SÍ Únicamente para Android TV
Control del servidor
Actualizaciones delta SÍ
Bloqueo de la recarga de la playlist SÍ
Bloqueo de la carga de sugerencias de precarga SÍ Excepto para los rangos de bytes con longitudes indefinidas
Inserción de anuncios
Inserción de anuncios guiada por el servidor (intersticiales) De forma parcial Solo VOD con X-ASSET-URI. Las transmisiones en vivo y X-ASSET-LIST se agregarán más adelante.
Anuncios del servidor y del cliente de IMA SÍ Guía de inserción de anuncios
Reproducción en vivo
Reproducción en vivo normal SÍ
HLS de baja latencia (Apple) SÍ
HLS de baja latencia (comunidad) NO
Datos comunes de clientes multimedia CMCD SÍ Guía de integración de CMCD

Formatos de contenedor progresivos

ExoPlayer puede reproducir directamente las transmisiones en los siguientes formatos de contenedor. También se deben admitir los formatos de muestra de audio y video incluidos (consulta la sección Formatos de muestra para obtener más detalles). Para obtener información sobre la compatibilidad con contenedores y formatos de imagen, consulta Imágenes.

Formato del contenedor Compatible Comentarios
MP4 SÍ
M4A SÍ
FMP4 SÍ
WebM SÍ
Matroska SÍ
MP3 SÍ Algunas transmisiones solo se pueden buscar con la búsqueda de tasa de bits constante**
Ogg SÍ Contiene Vorbis, Opus y FLAC
WAV SÍ
MPEG-TS SÍ
MPEG-PS SÍ
FLV SÍ No se puede buscar*
ADTS (AAC) SÍ Solo se puede buscar con la búsqueda de tasa de bits constante**
FLAC SÍ Uso de la biblioteca de FLAC o el extractor de FLAC en la biblioteca de ExoPlayer***
AMR SÍ Solo se puede buscar con la búsqueda de tasa de bits constante**

* No se admite la búsqueda porque el contenedor no proporciona metadatos (por ejemplo, un índice de muestra) para permitir que un reproductor multimedia realice una búsqueda de manera eficiente. Si se requiere la búsqueda, sugerimos usar un formato de contenedor más apropiado.

** Estos extractores tienen marcas FLAG_ENABLE_CONSTANT_BITRATE_SEEKING para habilitar la búsqueda aproximada con una suposición de tasa de bits constante. Esta funcionalidad no está habilitada de forma predeterminada. La forma más sencilla de habilitar esta funcionalidad para todos los extractores que la admiten es usar DefaultExtractorsFactory.setConstantBitrateSeekingEnabled, como se describe aquí.

*** El extractor de la biblioteca de FLAC genera audio sin procesar, que el framework puede controlar en todos los niveles de API. El extractor de FLAC de la biblioteca de ExoPlayer genera fotogramas de audio FLAC y, por lo tanto, depende de tener un decodificador de FLAC (por ejemplo, un decodificador MediaCodec que controle FLAC [obligatorio a partir del nivel de API 27] o la biblioteca de FFmpeg con FLAC habilitado). DefaultExtractorsFactory usa el extractor de extensiones si la aplicación se compiló con la biblioteca de FLAC. De lo contrario, usa el extractor de la biblioteca de ExoPlayer.

RTSP

ExoPlayer admite RTSP en vivo y on demand. A continuación, se indican los formatos de muestra y los tipos de red compatibles.

Formatos de muestra admitidos

  • H264 (la descripción de medios de SDP debe incluir datos de SPS/PPS en el atributo fmtp para la inicialización del decodificador)
  • AAC (con flujo de bits ADTS)
  • AC3.

Tipos de redes compatibles

  • RTP sobre unidifusión UDP (no se admite la multidifusión)
  • RTSP intercalado, RTP sobre RTSP con TCP.

Formatos de muestra

De forma predeterminada, ExoPlayer usa los decodificadores de la plataforma de Android. Por lo tanto, los formatos de muestra admitidos dependen de la plataforma subyacente, no de ExoPlayer. Consulta Formatos multimedia compatibles para obtener documentación sobre los formatos de muestra compatibles con dispositivos Android. Ten en cuenta que los dispositivos individuales pueden admitir formatos adicionales además de los que se indican.

Además de los decodificadores de la plataforma de Android, ExoPlayer también puede usar extensiones de decodificadores de software. Estas deben compilarse de forma manual y, luego, incluirse en los proyectos que quieran usarlas. Actualmente, proporcionamos bibliotecas de decodificadores de software para AV1, VP9, FLAC, Opus, FFmpeg, MIDI, IAMF y MPEG-H.

Biblioteca de FFmpeg

La biblioteca de FFmpeg admite la decodificación de una variedad de formatos de muestra de audio diferentes. Puedes elegir qué decodificadores incluir cuando compiles la biblioteca, como se documenta en el archivo README.md de la biblioteca. En la siguiente tabla, se proporciona una asignación del formato de muestra de audio al nombre del decodificador de FFmpeg correspondiente.

Formato de la muestra Nombres de los decodificadores
Vorbis vorbis
Opus opus
FLAC flac
ALAC alac
PCM μ-law pcm_mulaw
PCM con ley A 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

Imágenes

ExoPlayer admite los siguientes formatos de imagen. Consulta Bibliotecas de carga de imágenes para obtener información sobre cómo integrarlas con bibliotecas externas que pueden proporcionar compatibilidad con un conjunto diferente de formatos.

Formato de imagen Compatible Notas
BMP SÍ
GIF NO No hay compatibilidad con Extractor
JPEG SÍ
Foto en movimiento JPEG SÍ Se admiten imágenes estáticas y videos
JPEG Ultra HDR SÍ Se recurre a SDR antes de Android 14 o en pantallas que no son HDR
PNG SÍ
WebP SÍ
HEIF/HEIC SÍ
Foto en movimiento HEIC SÍ
AVIF (modelo de referencia) SÍ Se decodifica solo en Android 14 y versiones posteriores

Formatos de subtítulos independientes

ExoPlayer admite archivos de subtítulos independientes en una variedad de formatos. Los archivos de subtítulos se pueden transferir de forma alternativa, como se describe en la página de elementos multimedia.

Formato del contenedor Compatible Tipo de MIME
WebVTT SÍ MimeTypes.TEXT_VTT
TTML / SMPTE-TT SÍ MimeTypes.APPLICATION_TTML
SubRip SÍ MimeTypes.APPLICATION_SUBRIP
SubStationAlpha (SSA/ASS) SÍ MimeTypes.TEXT_SSA

Reproducción de video HDR

ExoPlayer controla la extracción de videos de alto rango dinámico (HDR) en varios contenedores, incluidos Dolby Vision en MP4 y HDR10+ en Matroska/WebM. La decodificación y la visualización de contenido HDR dependen de la compatibilidad con la plataforma y el dispositivo Android. Consulta Reproducción de video HDR para obtener información sobre cómo verificar las capacidades de decodificación y visualización de HDR, y las limitaciones de la compatibilidad con HDR en las versiones de Android.

Cuando se reproduce una transmisión HDR que requiere compatibilidad con un perfil de códec en particular, el selector MediaCodec predeterminado de ExoPlayer elegirá un decodificador que admita ese perfil (si está disponible), incluso si otro decodificador para el mismo tipo de MIME que no admite ese perfil aparece más arriba en la lista de códecs. Esto puede dar como resultado la selección de un decodificador de software en los casos en que la transmisión supere las capacidades de un decodificador de hardware para el mismo tipo de MIME.