Interfaz del reproductor

Un reproductor es el componente de tu app que facilita la reproducción de elementos multimedia. La interfaz Player de Media3 configura un esquema para la funcionalidad que generalmente controla un reproductor. Esto incluye lo siguiente:

• Afectar los controles de reproducción, como reproducir, pausar y buscar
• Consultar las propiedades del contenido multimedia que se está reproduciendo, como la posición de reproducción
• Administrar una playlist o una fila de elementos multimedia
• Configurar propiedades de reproducción, como reproducción aleatoria, repetición, velocidad y volumen
• Procesando video en la pantalla

Media3 también proporciona una implementación de la interfaz Player, llamada ExoPlayer.

Una interfaz común entre los componentes

Varios componentes de Media3 implementan la interfaz de Player, por ejemplo:

Aunque un MediaSession no implementa la interfaz de Player, requiere un Player cuando se crea uno. Su propósito es proporcionar acceso a Player desde otros procesos o subprocesos.

Arquitectura de reproducción de Media3

Si tienes acceso a un Player, debes llamar a sus métodos directamente para emitir comandos de reproducción. Puedes anunciar tu reproducción y otorgar el control de reproducción a fuentes externas implementando un MediaSession. Estas fuentes externas implementan un MediaController, que facilita la conexión a una sesión multimedia y la emisión de solicitudes de comandos de reproducción.

Cuando se reproduce contenido multimedia en segundo plano, debes alojar la sesión y el reproductor dentro de un MediaSessionService o MediaLibraryService que se ejecute como servicio en primer plano. Si lo haces, puedes separar el reproductor de la actividad de tu app que contiene la IU para el control de la reproducción. Es posible que debas usar un controlador de contenido multimedia.

Estado del reproductor

El estado de un reproductor multimedia que implementa la interfaz Player consta principalmente de 4 categorías de información:

1. Estado de reproducción
   • Recupera con getPlaybackState().
   • Los valores de estado que define la interfaz son STATE_IDLE, STATE_BUFFERING, STATE_READY y STATE_ENDED.
2. Playlist de elementos multimedia
   • Es una secuencia de instancias de MediaItem para la reproducción.
   • Cómo recuperar con getCurrentTimeline()
   • Las instancias de Player pueden proporcionar métodos de operación de playlist, como agregar o quitar un MediaItem, y métodos convenientes, como getCurrentMediaItem().
3. Propiedades de reproducción y pausa, como las siguientes:
   • playWhenReady: Indica si el usuario desea que el contenido multimedia se reproduzca cuando sea posible o si permanece pausado.
   • Motivo de la supresión de reproducción: Indica por qué se suprimió la reproducción, si corresponde, incluso si playWhenReady es true.
   • isPlaying: Indica si el reproductor está reproduciendo contenido actualmente, que solo será true si el estado de reproducción es STATE_READY, playWhenReady es true y no se suprime la reproducción.
4. Posición de reproducción, incluido lo siguiente:
   • Índice actual de elementos multimedia: Es el índice del MediaItem actual en la playlist.
   • isPlayingAd: Indica si se está reproduciendo un anuncio insertado.
   • Posición de reproducción actual: Es la posición de reproducción actual dentro del MediaItem actual o el anuncio insertado.

Además, la interfaz Player permite acceder a los pistas disponibles, los metadatos multimedia, la velocidad de reproducción, el volumen y otras propiedades auxiliares de la reproducción.

Escucha los cambios

Usa un Player.Listener para detectar cambios en un Player. Consulta la documentación de ExoPlayer sobre los eventos del reproductor para obtener detalles sobre cómo crear y usar un objeto de escucha.

Ten en cuenta que la interfaz del objeto de escucha no incluye ninguna devolución de llamada para hacer un seguimiento de la progresión normal de la reproducción. Para supervisar de forma continua el progreso de la reproducción, como la configuración de una IU de la barra de progreso, debes consultar la posición actual en intervalos adecuados.

val handler = Handler(Looper.getMainLooper())
fun checkPlaybackPosition(delayMs: Long): Boolean =
  handler.postDelayed(
    {
      val currentPosition = player.currentPosition
      // Update UI based on currentPosition
      checkPlaybackPosition(delayMs)
    },
    delayMs)

Handler handler = new Handler(Looper.getMainLooper());
boolean checkPlaybackPosition(long delayMs) {
    return handler.postDelayed(() -> {
        long currentPosition = player.getCurrentPosition();
        // Update UI based on currentPosition
        checkPlaybackPosition(delayMs);
    }, delayMs);
}

Controlar la reproducción

La interfaz Player ofrece muchas formas de manipular el estado y controlar la reproducción:

• Controles de reproducción básicos, como play(), pause(), prepare() y stop().
• Operaciones de playlist, como addMediaItem() o removeMediaItem()
• Saltos para cambiar el elemento o la posición actuales
• Configura los modos de repetición y el modo aleatorio.
• Actualiza las preferencias de selección de pistas.
• Establece la velocidad de reproducción.

Implementaciones personalizadas de Player

Para crear un reproductor personalizado, puedes extender el SimpleBasePlayer incluido en Media3. Esta clase proporciona una implementación base de la interfaz Player para reducir al mínimo la cantidad de métodos que debes implementar.

Para comenzar, anula el método getState(). Este método debe propagar el estado del reproductor actual cuando se lo llame, lo que incluye lo siguiente:

• El conjunto de comandos disponibles
• Propiedades de reproducción, como si el reproductor debe comenzar a reproducir contenido cuando el estado de reproducción es STATE_READY, el índice del elemento multimedia que se está reproduciendo y la posición de reproducción dentro del elemento actual

class CustomPlayer : SimpleBasePlayer(looper) {
  override fun getState(): State {
    return State.Builder()
      .setAvailableCommands(...) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build()
  }
}

public class CustomPlayer extends SimpleBasePlayer {
  public CustomPlayer(Looper looper) {
    super(looper);
  }

  @Override
  protected State getState() {
    return new State.Builder()
      .setAvailableCommands(...) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build();
  }
}

SimpleBasePlayer aplicará que State se cree con una combinación válida de valores de estado. También controlará los objetos de escucha y, además, informará a los objetos de escucha sobre los cambios de estado. Si necesitas activar una actualización de estado de forma manual, llama a invalidateState().

Además del método getState(), solo debes implementar los métodos que se usan para los comandos que tu jugador declara como disponibles. Busca el método del controlador anulable que corresponda a la funcionalidad que deseas implementar. Por ejemplo, anula el método handleSeek() para admitir operaciones como COMMAND_SEEK_IN_CURRENT_MEDIA_ITEM y COMMAND_SEEK_TO_NEXT_MEDIA_ITEM.