Conectar a um app de música

Um controlador de mídia interage com uma sessão para consultar e controlar uma mídia. a reprodução do app. Na Media3, a classe MediaController A API implementa a interface Player. Exemplos de apps clientes que usam uma interface de mídia incluem:

• Controles de mídia do sistema Android
• App complementar do Android Wear OS
• Android Auto e Automotive OS
• Assistentes por voz, como o Google Assistente
• O app de teste do controle de mídia

Um controlador de mídia também pode ser útil em um app de mídia, por exemplo, se o player e a sessão de mídia estiverem em um Service separado do Activity ou Fragment com a interface.

Criar um MediaController.

Para criar um MediaController, comece criando um SessionToken para o o MediaSession correspondente. O método onStart() da classe Activity ou Fragment pode ser um bom lugar para isso.

KotlinJava

val sessionToken = 
  SessionToken(context, ComponentName(context, PlaybackService::class.java))

SessionToken sessionToken = 
  new SessionToken(context, new ComponentName(context, PlaybackService.class));

O uso dessa SessionToken para criar uma MediaController conecta o controlador à sessão especificada. Isso acontece de forma assíncrona. Portanto, você precisa detectar o resultado e usá-lo quando disponível.

KotlinJava

val controllerFuture =
  MediaController.Builder(context, sessionToken).buildAsync()
controllerFuture.addListener({
  // MediaController is available here with controllerFuture.get()
}, MoreExecutors.directExecutor())

ListenableFuture<MediaController> controllerFuture =
  new MediaController.Builder(context, sessionToken).buildAsync();
controllerFuture.addListener(() -> {
  // MediaController is available here with controllerFuture.get()
}, MoreExecutors.directExecutor());

Observação: use ContextCompat.getMainExecutor() em vez de MoreExecutors.directExecutor(). caso você execute o serviço em outro processo que não seja a interface.

Observação: os apps destinados ao SDK de nível 30 ou mais recente precisam incluir um elemento <queries>. no manifesto para se conectar ao MediaSessionService de um app diferente (ou um componente semelhante). Consulte o guia de visibilidade do pacote para mais detalhes.

Use um MediaController

O MediaController implementa a interface Player para que você possa usar os comandos definidos na interface para controlar a reprodução do MediaSession conectado. Isso significa que chamar play() em um MediaController vai enviar o comando para o MediaSession conectado, que vai delegar o comando para o Player subjacente.

Dica: um controlador de mídia implementa a interface Player e, assim, você pode atribui-lo ao player na interface.

Da mesma forma, você pode adicionar um Player.Listener ao controlador para detectar muda no estado Player. Consulte a Guia de eventos de jogador para mais detalhes sobre como usar um Player.Listener. O MediaController.Listener define retornos de chamada adicionais para eventos e comandos de entrada da MediaSession conectado, como onAvailableSessionCommandsChanged() para quando a sessão de mídia altera os comandos de sessão disponíveis e onDisconnected() para quando o controlador é desconectado da sessão.

Assim como em outros componentes, lembre-se de liberar a MediaController quando ela estiver não são mais necessários, como no método onStop() de um Activity ou Fragment.

KotlinJava

MediaController.releaseFuture(controllerFuture)

MediaController.releaseFuture(controllerFuture);

Liberar o controlador ainda entregará todos os comandos pendentes enviados ao sessão e só se desvinculem do serviço de sessão quando esses comandos forem ou após um tempo limite, o que ocorrer primeiro.

Criar e usar um MediaBrowser

Um MediaBrowser é criado com base nos recursos oferecidos por um MediaController para permitir a navegação na biblioteca de mídia oferecida pelo MediaLibraryService de um app de mídia.

KotlinJava

val browserFuture = MediaBrowser.Builder(context, sessionToken).buildAsync()
browserFuture.addListener({
  // MediaBrowser is available here with browserFuture.get()
}, MoreExecutors.directExecutor())

ListenableFuture<MediaBrowser> browserFuture =
  new MediaBrowser.Builder(context, sessionToken).buildAsync();
browserFuture.addListener(() -> {
  // MediaBrowser is available here with browserFuture.get()
}, MoreExecutors.directExecutor());

Para começar a navegar pela biblioteca de conteúdo do app de mídia, primeiro recupere o nó raiz com getLibraryRoot():

KotlinJava

// Get the library root to start browsing the library tree.
val rootFuture = mediaBrowser.getLibraryRoot(/* params= */ null)
rootFuture.addListener({
  // Root node MediaItem is available here with rootFuture.get().value
}, MoreExecutors.directExecutor())

// Get the library root to start browsing the library tree.
ListenableFuture<LibraryResult<MediaItem>> rootFuture =
  mediaBrowser.getLibraryRoot(/* params= */ null);
rootFuture.addListener(() -> {
  // Root node MediaItem is available here with rootFuture.get().value
}, MoreExecutors.directExecutor());

É possível navegar pela biblioteca de mídia, recuperando os filhos de uma MediaItem na biblioteca com getChildren(). Por exemplo, para recuperar o filhos do nó raiz MediaItem:

KotlinJava

// Get the library root to start browsing the library tree.
val childrenFuture = 
  mediaBrowser.getChildren(rootMediaItem.mediaId, 0, Int.MAX_VALUE, null)
childrenFuture.addListener({
  // List of children MediaItem nodes is available here with
  // childrenFuture.get().value
}, MoreExecutors.directExecutor())

ListenableFuture<LibraryResult<ImmutableList<MediaItem>>> childrenFuture =
  mediaBrowser.getChildren(rootMediaItem.mediaId, 0, Integer.MAX_VALUE, null);
childrenFuture.addListener(() -> {
  // List of children MediaItem nodes is available here with
  // childrenFuture.get().value
}, MoreExecutors.directExecutor());