ExoPlayer admite HLS con varios formatos de contenedor. El audio y el Los formatos de muestra de video también deben ser compatibles (consulte la formatos de muestra para obtener más detalles). Mié recomiendan 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 y 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Í | |
Ejemplo de AES-128 | NO | |
Widevine | SÍ | API 19+ (esquema “cenc”) y 25+ (“esquema cbcs”) |
PlayReady SL2000 | SÍ | Únicamente para Android TV |
Control del servidor | ||
Actualizaciones delta | SÍ | |
Bloqueando la recarga de la playlist | SÍ | |
Carga de bloqueo de sugerencias de precarga | SÍ | Excepto para los rangos de bytes con longitudes no definidas |
Reproducción en vivo | ||
Reproducción en vivo habitual | SÍ | |
HLS de baja latencia (Apple) | SÍ | |
HLS de baja latencia (Comunidad) | NO | |
Datos de clientes de medios comunes (CMCD) | SÍ | Guía de integración |
Cómo usar MediaItem
Para reproducir una transmisión HLS, debes depender del módulo HLS.
Kotlin
implementation("androidx.media3:media3-exoplayer-hls:1.4.0")
Groovy
implementation "androidx.media3:media3-exoplayer-hls:1.4.0"
Luego, puedes crear un MediaItem
para un URI de playlist HLS y pasarlo al
de fútbol favorito.
Kotlin
// 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()
Java
// 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 en .m3u8
, puedes pasar MimeTypes.APPLICATION_M3U8
.
a setMimeType
de MediaItem.Builder
para indicar explícitamente el tipo de
contenido.
El URI del elemento multimedia puede apuntar a una playlist de contenido multimedia o a una variante múltiple.
playlist. Si el URI apunta a una playlist de múltiples variantes que declara múltiples
#EXT-X-STREAM-INF
, y ExoPlayer se adaptará automáticamente entre
en función del ancho de banda disponible y de 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 una MediaItem
.
Kotlin
// 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()
Java
// 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();
Accede al manifiesto
Puedes recuperar el manifiesto actual llamando a Player.getCurrentManifest
.
Para HLS, debes convertir el objeto que se muestra en HlsManifest
. El
También se llama a la devolución de llamada onTimelineChanged
de Player.Listener
cada vez que se realiza
se cargue el manifiesto. Esto sucederá una vez para el contenido a pedido y
muchas veces con 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.
Kotlin
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. } } } )
Java
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 proporciona varias formas de personalizar la experiencia de reproducción a tu las necesidades de la app. Consulta la página de 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 de múltiples variantes para preparar
transmisión, que funciona si las etiquetas #EXT-X-STREAM-INF
contienen la CODECS
.
Es posible que debas inhabilitar esta función si tus segmentos multimedia contienen multiplexados
pistas de subtítulos que no están declaradas en la playlist de múltiples variantes con un
#EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS
. De lo contrario, estas pistas de subtítulos
no se detectará ni se jugará. Puedes inhabilitar la preparación sin fragmentos en la
HlsMediaSource.Factory
, como se muestra en el siguiente fragmento. Ten en cuenta que esta
aumentará el tiempo de inicio, ya que ExoPlayer necesita descargar un segmento de contenido multimedia para
descubrir estas pistas adicionales y es preferible declarar las
pistas de subtítulos en la playlist de múltiples variantes.
Kotlin
val hlsMediaSource = HlsMediaSource.Factory(dataSourceFactory) .setAllowChunklessPreparation(false) .createMediaSource(MediaItem.fromUri(hlsUri))
Java
HlsMediaSource hlsMediaSource = new HlsMediaSource.Factory(dataSourceFactory) .setAllowChunklessPreparation(false) .createMediaSource(MediaItem.fromUri(hlsUri));
Crea contenido HLS de alta calidad
Para aprovechar ExoPlayer al máximo, hay ciertos lineamientos que puedes para mejorar tu contenido HLS. Lee nuestra publicación de Medium sobre la reproducción en HLS en ExoPlayer para obtener una explicación completa. Los puntos principales son los siguientes:
- Usar duraciones de segmentos precisas
- Usar una transmisión multimedia continua y evitar cambios en la estructura de los medios segmentos.
- Usa la etiqueta
#EXT-X-INDEPENDENT-SEGMENTS
. - Prefiere las transmisiones con desMUx, en lugar de los archivos que incluyen video y audio.
- Incluye toda la información que puedas en la playlist de múltiples variantes.
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
. - Proporcionar un período prolongado. Un minuto o más es genial.