Se usó la API de Cloud Translation para traducir esta página.

HLS

ExoPlayer admite HLS con varios formatos de contenedor. Los formatos de muestra de audio y video también deben ser compatibles (consulta la sección de formatos de muestra para obtener más información). Recomendamos a los productores de contenido de HLS que generen transmisiones HLS de alta calidad, como se describe aquí.

Función	Corroborado	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 de 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Í
Bloqueo de la carga de sugerencias de precarga	SÍ	Excepto para rangos de bytes con longitudes indefinidas
Reproducción en vivo
Reproducción habitual en vivo	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

Cómo usar MediaItem

Para reproducir una transmisión HLS, debes depender del módulo HLS.

Kotlin

implementation("androidx.media3:media3-exoplayer-hls:1.3.1")

Groovy

implementation "androidx.media3:media3-exoplayer-hls:1.3.1"

Luego, puedes crear un MediaItem para un URI de playlist de HLS y pasarlo al reproductor.

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 con .m3u8, puedes pasar MimeTypes.APPLICATION_M3U8 a setMimeType de MediaItem.Builder para indicar de manera explícita el tipo de contenido.

El URI del elemento multimedia puede apuntar a una playlist multimedia o a una de múltiples variantes. Si el URI apunta a una playlist de múltiples variantes que declara múltiples etiquetas #EXT-X-STREAM-INF, ExoPlayer se adaptará automáticamente entre variantes teniendo en cuenta tanto el ancho de banda disponible como las capacidades del dispositivo.

Usa HlsMediaSource

Para obtener más opciones de personalización, puedes crear un HlsMediaSource y pasarlo directamente al reproductor, en lugar de un 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();

Cómo acceder al manifiesto

Puedes recuperar el manifiesto actual llamando a Player.getCurrentManifest. Para HLS, debes convertir el objeto que se muestra en HlsManifest. También se llama a la devolución de llamada onTimelineChanged de Player.Listener cada vez que se carga el manifiesto. Esto sucederá 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 realizar una acción 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 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 de múltiples variantes 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 multiplexados que no están declaradas en la playlist de múltiples variantes con una etiqueta #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS. De lo contrario, estas pistas de subtítulos no se detectarán ni se reproducirán. 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 debe descargar un segmento multimedia para descubrir estas pistas adicionales, y es preferible declarar las pistas con 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

Si quieres aprovechar ExoPlayer al máximo, puedes seguir ciertos lineamientos para mejorar tu contenido de HLS. Lee nuestra publicación 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 una transmisión multimedia continua y evita cambios en la estructura de contenido multimedia entre los segmentos.
Usa la etiqueta #EXT-X-INDEPENDENT-SEGMENTS.
Es preferible las transmisiones demuxidas, 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 de vida prolongado. Un minuto o más es genial.