ExoPlayer admite HLS con varios formatos de contenedor. Los formatos de muestra de audio y video contenidos también deben ser compatibles (consulta la sección Formatos de muestra para obtener más información). Recomendamos encarecidamente a los productores de contenido HLS que generen transmisiones HLS de alta calidad, como se describe aquí.
Función | Compatible | Comentarios |
---|---|---|
Contenedores | ||
MPEG-TS | SÍ | |
FMP4/CMAF | SÍ | |
ADTS (AAC) | SÍ | |
MP3 | SÍ | |
Subtítulos opcionales | ||
CEA-608 | SÍ | |
CEA-708 | SÍ | |
WebVTT | SÍ | |
Metadatos | ||
ID3 | SÍ | |
SCTE-35 | NO | |
Protección del contenido | ||
AES-128 | SÍ | |
Muestra de AES-128 | NO | |
Widevine | SÍ | Niveles de API 19 y superiores ("cenc") y 25 y superiores ("cbcs") |
PlayReady SL2000 | SÍ | Únicamente para Android TV |
Control de servidores | ||
Actualizaciones delta | SÍ | |
Cómo bloquear la recarga de una playlist | SÍ | |
Bloquea la carga de sugerencias de carga previa | SÍ | Excepto para los rangos de bytes con longitudes no definidas |
Reproducción en vivo | ||
Reproducción en vivo normal | SÍ | |
HLS de baja latencia (Apple) | SÍ | |
HLS de baja latencia (comunitario) | NO | |
Datos comunes de clientes multimedia (CMCD) | SÍ | Guía de integración |
Cómo usar MediaItem
Para reproducir una transmisión HLS, debes depender del módulo HLS.
implementation("androidx.media3:media3-exoplayer-hls:1.4.1")
implementation "androidx.media3:media3-exoplayer-hls:1.4.1"
Luego, puedes crear un MediaItem
para un URI de playlist HLS y pasarlo al reproductor.
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri))
// Prepare the player.
player.prepare()
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri));
// Prepare the player.
player.prepare();
Si tu URI no termina con .m3u8
, puedes pasar MimeTypes.APPLICATION_M3U8
a setMimeType
de MediaItem.Builder
para indicar de forma explícita el tipo de contenido.
El URI del elemento multimedia puede apuntar a una playlist multimedia o a una playlist multivariante. Si el URI apunta a una playlist multivariante que declara varias etiquetas #EXT-X-STREAM-INF
, ExoPlayer se adaptará automáticamente entre las variantes, teniendo en cuenta el ancho de banda disponible y las capacidades del dispositivo.
Cómo usar HlsMediaSource
Para obtener más opciones de personalización, puedes crear un HlsMediaSource
y pasarlo directamente al reproductor en lugar de un MediaItem
.
// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a HLS media source pointing to a playlist uri.
val hlsMediaSource =
HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource)
// Prepare the player.
player.prepare()
// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a HLS media source pointing to a playlist uri.
HlsMediaSource hlsMediaSource =
new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource);
// Prepare the player.
player.prepare();
Cómo acceder al manifiesto
Para recuperar el manifiesto actual, llama a Player.getCurrentManifest
.
Para HLS, debes transmitir el objeto que se muestra a HlsManifest
. También se llama a la devolución de llamada onTimelineChanged
de Player.Listener
cada vez que se carga el manifiesto. Esto ocurrirá una vez para el contenido on demand y, posiblemente, muchas veces para el contenido en vivo. En el siguiente fragmento de código, se muestra cómo una app puede hacer algo cada vez que se carga el manifiesto.
player.addListener(
object : Player.Listener {
override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
val manifest = player.currentManifest
if (manifest is HlsManifest) {
// Do something with the manifest.
}
}
}
)
player.addListener(
new Player.Listener() {
@Override
public void onTimelineChanged(
Timeline timeline, @Player.TimelineChangeReason int reason) {
Object manifest = player.getCurrentManifest();
if (manifest != null) {
HlsManifest hlsManifest = (HlsManifest) manifest;
// Do something with the manifest.
}
}
});
Cómo personalizar la reproducción
ExoPlayer ofrece varias formas de personalizar la experiencia de reproducción según las necesidades de tu app. Consulta la página Personalización para ver ejemplos.
Inhabilita la preparación sin fragmentos
De forma predeterminada, ExoPlayer usará la preparación sin fragmentos. Esto significa que ExoPlayer solo usará la información de la playlist multivariante para preparar la transmisión, lo que funciona si las etiquetas #EXT-X-STREAM-INF
contienen el atributo CODECS
.
Es posible que debas inhabilitar esta función si tus segmentos multimedia contienen pistas de subtítulos multiplexadas que no se declaran en la playlist multivariante con una etiqueta #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS
. De lo contrario, no se detectarán ni reproducirán estas pistas de subtítulos. Puedes inhabilitar la preparación sin fragmentos en HlsMediaSource.Factory
, como se muestra en el siguiente fragmento. Ten en cuenta que esto aumentará el tiempo de inicio, ya que ExoPlayer necesita descargar un segmento de contenido multimedia para descubrir estas pistas adicionales. En su lugar, es preferible declarar las pistas de subtítulos en la playlist multivariante.
val hlsMediaSource =
HlsMediaSource.Factory(dataSourceFactory)
.setAllowChunklessPreparation(false)
.createMediaSource(MediaItem.fromUri(hlsUri))
HlsMediaSource hlsMediaSource =
new HlsMediaSource.Factory(dataSourceFactory)
.setAllowChunklessPreparation(false)
.createMediaSource(MediaItem.fromUri(hlsUri));
Crea contenido HLS de alta calidad
Para aprovechar al máximo ExoPlayer, hay ciertos lineamientos que puedes seguir para mejorar tu contenido HLS. Lee nuestra entrada de Medium sobre la reproducción de HLS en ExoPlayer para obtener una explicación completa. Los puntos principales son los siguientes:
- Usa duraciones de segmentos precisas.
- Usa un flujo de contenido multimedia continuo y evita los cambios en la estructura del contenido multimedia en los segmentos.
- Usa la etiqueta
#EXT-X-INDEPENDENT-SEGMENTS
. - Se prefieren las transmisiones demuxadas, en lugar de los archivos que incluyen video y audio.
- Incluye toda la información que puedas en la playlist multivariante.
Los siguientes lineamientos se aplican específicamente a las transmisiones en vivo:
- Usa la etiqueta
#EXT-X-PROGRAM-DATE-TIME
. - Usa la etiqueta
#EXT-X-DISCONTINUITY-SEQUENCE
. - Proporciona una ventana de publicación activa prolongada. Un minuto o más es ideal.