Elementos multimedia

La API de playlist se basa en instancias de MediaItem, que se pueden compilar de forma conveniente con MediaItem.Builder. Dentro del reproductor, un MediaItem se convierte en un MediaSource reproducible por un MediaSource.Factory. Sin una configuración personalizada, esta conversión la lleva a cabo un DefaultMediaSourceFactory, que es capaz de compilar fuentes de contenido multimedia complejas que corresponden a las propiedades del elemento multimedia. Algunas de las propiedades que se pueden establecer en los elementos multimedia se describen en las siguientes secciones.

Elementos multimedia simples

Se puede compilar un elemento multimedia que solo conste del URI de transmisión con el método de conveniencia fromUri:

val mediaItem = MediaItem.fromUri(videoUri)
MediaItems.kt

MediaItem mediaItem = MediaItem.fromUri(videoUri);
MediaItems.java

En todos los demás casos, se puede usar un MediaItem.Builder. En el siguiente ejemplo, se compila un elemento multimedia con un ID y algunos metadatos adjuntos:

val mediaItem =
  MediaItem.Builder().setMediaId(mediaId).setTag(myAppData).setUri(videoUri).build()
MediaItems.kt

MediaItem mediaItem =
    new MediaItem.Builder().setMediaId(mediaId).setTag(myAppData).setUri(videoUri).build();
MediaItems.java

Adjuntar metadatos puede ser útil para actualizar la IU de tu app cuando se producen transiciones de playlists.

Imágenes

La reproducción de imágenes requiere una duración en el elemento multimedia para especificar durante cuánto tiempo se debe mostrar la imagen durante la reproducción. Consulta la página de la guía de Imágenes para obtener más información sobre las fotos en movimiento y las bibliotecas de carga de imágenes (por ejemplo, Glide).

val mediaItem = MediaItem.Builder().setUri(imageUri).setImageDurationMs(3000).build()
MediaItems.kt

MediaItem mediaItem =
    new MediaItem.Builder().setUri(imageUri).setImageDurationMs(3_000).build();
MediaItems.java

Extensiones de archivo no estándar para contenido multimedia adaptable

ExoPlayer proporciona fuentes de contenido multimedia adaptables para DASH, HLS y SmoothStreaming. Si el URI de un elemento multimedia adaptable de este tipo termina con una extensión de archivo estándar, se crea automáticamente la fuente de contenido multimedia correspondiente. Si el URI tiene una extensión no estándar o no tiene ninguna, el tipo de MIME se puede establecer de forma explícita para indicar el tipo de elemento multimedia:

val mediaItem =
  MediaItem.Builder().setUri(hlsUri).setMimeType(MimeTypes.APPLICATION_M3U8).build()
MediaItems.kt

MediaItem mediaItem =
    new MediaItem.Builder().setUri(hlsUri).setMimeType(MimeTypes.APPLICATION_M3U8).build();
MediaItems.java

No se requiere un tipo de MIME para las transmisiones de contenido multimedia progresivas.

Contenido protegido

En el caso del contenido protegido, se deben establecer las propiedades de DRM del elemento multimedia. El UUID es obligatorio, mientras que todas las demás propiedades son opcionales.

A continuación, se muestra un ejemplo de configuración para reproducir un elemento protegido con Widevine DRM en el que el URI de la licencia no está disponible directamente en el contenido multimedia (p.ej., en una playlist de DASH) y se requieren varias sesiones (p.ej., debido a la rotación de claves):

val mediaItem =
  MediaItem.Builder()
    .setUri(videoUri)
    .setDrmConfiguration(
      MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID)
        .setLicenseUri(licenseUri)
        .setMultiSession(true)
        .setLicenseRequestHeaders(httpRequestHeaders)
        .build()
    )
    .build()
MediaItems.kt

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setDrmConfiguration(
            new MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID)
                .setLicenseUri(licenseUri)
                .setMultiSession(true)
                .setLicenseRequestHeaders(httpRequestHeaders)
                .build())
        .build();
MediaItems.java

Dentro del reproductor, DefaultMediaSourceFactory pasará estas propiedades a un DrmSessionManagerProvider para obtener un DrmSessionManager, que luego se insertará en el MediaSource creado. El comportamiento de la DRM se puede personalizar aún más según tus necesidades.

Sideloading de pistas de subtítulos

Para realizar la carga lateral de pistas de subtítulos, se pueden agregar instancias de MediaItem.Subtitle cuando se compila un elemento multimedia:

val subtitle =
  MediaItem.SubtitleConfiguration.Builder(subtitleUri)
    .setMimeType(mimeType) // The correct MIME type (required).
    .setLanguage(language) // The subtitle language (optional).
    .setSelectionFlags(selectionFlags) // Selection flags for the track (optional).
    .build()
val mediaItem =
  MediaItem.Builder().setUri(videoUri).setSubtitleConfigurations(listOf(subtitle)).build()
MediaItems.kt

MediaItem.SubtitleConfiguration subtitle =
    new MediaItem.SubtitleConfiguration.Builder(subtitleUri)
        .setMimeType(mimeType) // The correct MIME type (required).
        .setLanguage(language) // The subtitle language (optional).
        .setSelectionFlags(selectionFlags) // Selection flags for the track (optional).
        .build();
MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setSubtitleConfigurations(ImmutableList.of(subtitle))
        .build();
MediaItems.java

De forma interna, DefaultMediaSourceFactory usará un MergingMediaSource para combinar la fuente de contenido multimedia con un SingleSampleMediaSource para cada pista de subtítulos. DefaultMediaSourceFactory no admite la carga lateral de subtítulos para DASH de varios períodos.

Cómo recortar una transmisión de contenido multimedia

Para recortar el contenido al que hace referencia un elemento multimedia, establece posiciones de inicio y finalización personalizadas:

val mediaItem =
  MediaItem.Builder()
    .setUri(videoUri)
    .setClippingConfiguration(
      MediaItem.ClippingConfiguration.Builder()
        .setStartPositionMs(startPositionMs)
        .setEndPositionMs(endPositionMs)
        .build()
    )
    .build()
MediaItems.kt

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setClippingConfiguration(
            new ClippingConfiguration.Builder()
                .setStartPositionMs(startPositionMs)
                .setEndPositionMs(endPositionMs)
                .build())
        .build();
MediaItems.java

De forma interna, DefaultMediaSourceFactory usará un ClippingMediaSource para unir la fuente de contenido multimedia. Existen propiedades de recorte adicionales. Consulta el Javadoc de MediaItem.Builder para obtener más detalles.

Inserción de anuncios

Para insertar anuncios, se debe establecer la propiedad del URI de la etiqueta de anuncio de un elemento multimedia:

val mediaItem =
  MediaItem.Builder()
    .setUri(videoUri)
    .setAdsConfiguration(MediaItem.AdsConfiguration.Builder(adTagUri).build())
    .build()
MediaItems.kt

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(videoUri)
        .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build())
        .build();
MediaItems.java

De forma interna, DefaultMediaSourceFactory unirá la fuente de contenido multimedia en un AdsMediaSource para insertar anuncios según lo defina la etiqueta de anuncio. Para que esto funcione, el reproductor también debe tener su DefaultMediaSourceFactory configurado según corresponda.