Para casos de uso simples, comenzar a usar ExoPlayer
consiste en implementar los siguientes pasos:
- Agrega ExoPlayer como una dependencia a tu proyecto.
- Crea una instancia de
ExoPlayer
. - Conecte el reproductor a una vista (para salida de video y entrada del usuario).
- Prepara el jugador con un
MediaItem
para jugar. - Suelta el reproductor cuando termines.
Estos pasos se describen con más detalle a continuación. Para ver un ejemplo completo, consulta PlayerActivity
en la app de demostración principal.
Agrega ExoPlayer como dependencia
Cómo agregar módulos de ExoPlayer
La forma más fácil de comenzar a usar AndroidX Media3 es agregar dependencias de Gradle a las bibliotecas que necesites en el archivo build.gradle
del módulo de tu app.
Por ejemplo, para depender de ExoPlayer con compatibilidad para la reproducción de DASH y componentes de IU, puedes agregar dependencias en los módulos de la siguiente manera:
Kotlin
implementation("androidx.media3:media3-exoplayer:1.3.1") implementation("androidx.media3:media3-exoplayer-dash:1.3.1") implementation("androidx.media3:media3-ui:1.3.1")
Groovy
implementation "androidx.media3:media3-exoplayer:1.3.1" implementation "androidx.media3:media3-exoplayer-dash:1.3.1" implementation "androidx.media3:media3-ui:1.3.1"
donde 1.3.1 es tu versión preferida (para encontrar la versión más reciente, puedes consultar las notas de la versión). Todos los módulos deben ser de la misma versión.
AndroidX Media3 tiene módulos de biblioteca que dependen de bibliotecas externas para proporcionar funcionalidad adicional. Algunas están disponibles en el repositorio de Maven, mientras que otras se deben compilar de forma manual. Explora el directorio de bibliotecas y consulta los archivos README individuales para obtener más detalles.
Puedes encontrar más información sobre los módulos de biblioteca disponibles en la página de Google Maven AndroidX Media.
Cómo activar la compatibilidad con Java 8
Si aún no está habilitada, debes activar la compatibilidad con Java 8 en todos los archivos build.gradle
que dependen de ExoPlayer. Para ello, agrega lo siguiente a la sección android
:
compileOptions {
targetCompatibility JavaVersion.VERSION_1_8
}
Cómo habilitar multidex
Si tu minSdkVersion
de Gradle es 20 o anterior, debes habilitar multidex para evitar errores de compilación.
Cómo crear el reproductor
Puedes crear una instancia de ExoPlayer
con ExoPlayer.Builder
, que proporciona una variedad de opciones de personalización. El siguiente código es el ejemplo más simple de la creación de una instancia.
Kotlin
val player = ExoPlayer.Builder(context).build()
Java
ExoPlayer player = new ExoPlayer.Builder(context).build();
Nota sobre los subprocesos
Se debe acceder a las instancias de ExoPlayer desde un solo subproceso de la aplicación. En la mayoría de los casos, este debería ser el subproceso principal de la aplicación. El uso del subproceso principal de la aplicación es un requisito cuando se usan los componentes de la IU de ExoPlayer o la extensión de IMA.
El subproceso en el que se debe acceder a una instancia de ExoPlayer se puede especificar de forma explícita si se pasa un Looper
cuando se crea el reproductor. Si no se especifica Looper
, se usa el Looper
del subproceso en el que se crea el reproductor. Si ese subproceso no tiene un Looper
, se usa el Looper
del subproceso principal de la aplicación. En todos los casos, se puede consultar el Looper
del subproceso desde el cual se debe acceder al reproductor con Player.getApplicationLooper
.
Para obtener más información sobre el modelo de subprocesos de ExoPlayer, consulta la sección "Modelo de subprocesos" de Javadoc de ExoPlayer.
Cómo adjuntar el reproductor a una vista
La biblioteca de ExoPlayer proporciona una variedad de componentes de IU precompilados para la reproducción de contenido multimedia. Estos incluyen PlayerView
, que encapsula un PlayerControlView
, un SubtitleView
y un Surface
en el que se renderiza el video. Se puede incluir un PlayerView
en el XML de diseño de tu aplicación.
Por ejemplo, para vincular el reproductor a la vista:
Kotlin
// Bind the player to the view. playerView.player = player
Java
// Bind the player to the view. playerView.setPlayer(player);
También puedes usar PlayerControlView
como un componente independiente, lo que es útil para casos de uso solo de audio.
El uso de los componentes de IU previamente compilados de ExoPlayer es opcional. En el caso de las apps de video que implementan su propia IU, el SurfaceView
, TextureView
, SurfaceHolder
o Surface
objetivo se puede configurar con los métodos setVideoSurfaceView
, setVideoTextureView
, setVideoSurfaceHolder
y setVideoSurface
de ExoPlayer, respectivamente. Se puede usar el método addTextOutput
de ExoPlayer para recibir subtítulos que deben renderizarse durante la reproducción.
Propagar la playlist y preparar el reproductor
En ExoPlayer, cada elemento multimedia se representa con un MediaItem
. Para reproducir un contenido multimedia, debes compilar un MediaItem
correspondiente, agregarlo al reproductor, prepararlo y llamar a play
para iniciar la reproducción:
Kotlin
// Build the media item. val mediaItem = MediaItem.fromUri(videoUri) // Set the media item to be played. player.setMediaItem(mediaItem) // Prepare the player. player.prepare() // Start the playback. player.play()
Java
// Build the media item. MediaItem mediaItem = MediaItem.fromUri(videoUri); // Set the media item to be played. player.setMediaItem(mediaItem); // Prepare the player. player.prepare(); // Start the playback. player.play();
ExoPlayer admite playlists directamente, por lo que es posible preparar el reproductor con varios elementos multimedia para que se reproduzcan uno tras otro:
Kotlin
// Build the media items. val firstItem = MediaItem.fromUri(firstVideoUri) val secondItem = MediaItem.fromUri(secondVideoUri) // Add the media items to be played. player.addMediaItem(firstItem) player.addMediaItem(secondItem) // Prepare the player. player.prepare() // Start the playback. player.play()
Java
// Build the media items. MediaItem firstItem = MediaItem.fromUri(firstVideoUri); MediaItem secondItem = MediaItem.fromUri(secondVideoUri); // Add the media items to be played. player.addMediaItem(firstItem); player.addMediaItem(secondItem); // Prepare the player. player.prepare(); // Start the playback. player.play();
La playlist se puede actualizar durante la reproducción sin necesidad de volver a preparar el reproductor. Obtén más información para propagar y manipular las listas de reproducción en la página Playlists. Obtén más información sobre las diferentes opciones disponibles a la hora de compilar elementos multimedia, como recortar y adjuntar archivos de subtítulos, en la página Elementos multimedia.
Cómo controlar el reproductor
Una vez que el reproductor esté preparado, se podrá controlar la reproducción llamando a métodos en el reproductor. Estos son algunos de los métodos más utilizados:
play
ypause
inician y pausan la reproducción.seekTo
permite la búsqueda dentro del contenido multimedia.hasPrevious
,hasNext
,previous
ynext
permiten navegar por la playlist.setRepeatMode
controla si el contenido multimedia se repite en bucle y de qué manera.setShuffleModeEnabled
controla la reproducción aleatoria de playlists.setPlaybackParameters
ajusta la velocidad de reproducción y el tono de audio.
Si el jugador está vinculado a un PlayerView
o PlayerControlView
, la interacción del usuario con estos componentes hará que se invoquen los métodos correspondientes en el reproductor.
Cómo liberar el reproductor
Es importante liberar el reproductor cuando ya no sea necesario para liberar recursos limitados, como decodificadores de video, para que los usen otras aplicaciones. Para ello, se debe llamar a ExoPlayer.release
.