미디어 앱에 연결

미디어 컨트롤러는 미디어 세션과 상호작용하여 미디어 앱의 재생을 쿼리하고 제어합니다. Media3에서 MediaController API는 Player 인터페이스를 구현합니다. 미디어 컨트롤러를 사용하는 클라이언트 앱의 예는 다음과 같습니다.

미디어 컨트롤러는 미디어 앱 내에서도 유용할 수 있습니다. 예를 들어 플레이어와 미디어 세션이 UI가 있는 Activity 또는 Fragment와 별도의 Service에 있는 경우입니다.

MediaController를 만드는 방법

MediaController을 만들려면 먼저 해당 MediaSession의 SessionToken을 만듭니다. Activity 또는 Fragment의 onStart() 메서드가 적합합니다.

Kotlin

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

자바

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

이 SessionToken를 사용하여 MediaController를 빌드하면 컨트롤러가 지정된 세션에 연결됩니다. 이는 비동기적으로 발생하므로 결과를 수신 대기하고 사용 가능한 경우 사용해야 합니다.

Kotlin

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());

MediaController 사용

MediaController는 Player 인터페이스를 구현하므로 인터페이스에 정의된 명령어를 사용하여 연결된 MediaSession의 재생을 제어할 수 있습니다. 즉, MediaController에서 play()를 호출하면 연결된 MediaSession에 명령어가 전송되고, MediaSession는 이후에 기본 Player에 명령어를 위임합니다.

Player 상태의 변경사항을 수신 대기하도록 컨트롤러에 Player.Listener를 추가할 수 있습니다. Player.Listener 사용에 관한 자세한 내용은 플레이어 이벤트 가이드를 참고하세요.

MediaController.Listener 인터페이스는 연결된 MediaSession의 이벤트 및 맞춤 명령어에 대한 추가 콜백을 정의합니다. 예를 들어 세션이 맞춤 명령어를 전송하는 경우 onCustomCommand(), 세션이 사용 가능한 세션 명령어를 변경하는 경우 onAvailableSessionCommandsChanged(), 컨트롤러가 세션에서 연결 해제되는 경우 onDisconnected()가 있습니다.

MediaController.Listener는 Builder로 컨트롤러를 빌드할 때 설정할 수 있습니다.

Kotlin

MediaController.Builder(context, sessionToken)
    .setListener(
      object : MediaController.Listener {
        override fun onCustomCommand(
          controller: MediaController,
          command: SessionCommand,
          args: Bundle,
        ): ListenableFuture<SessionResult> {
          // Handle custom command.
          return Futures.immediateFuture(SessionResult(SessionResult.RESULT_SUCCESS))
        }

        override fun onDisconnected(controller: MediaController) {
          // Handle disconnection.
        }
      }
    )
    .buildAsync()

자바

new MediaController.Builder(context, sessionToken)
    .setListener(
        new MediaController.Listener() {
          @Override
          public ListenableFuture<SessionResult> onCustomCommand(
              MediaController controller, SessionCommand command, Bundle args) {
            // Handle custom command.
            return Futures.immediateFuture(new SessionResult(SessionResult.RESULT_SUCCESS));
          }

          @Override
          public void onDisconnected(MediaController controller) {
            // Handle disconnection.
          }
        })
    .buildAsync();

다른 구성요소와 마찬가지로 Activity 또는 Fragment의 onStop() 메서드와 같이 더 이상 필요하지 않을 때 MediaController를 해제해야 합니다.

Kotlin

MediaController.releaseFuture(controllerFuture)

자바

MediaController.releaseFuture(controllerFuture);

컨트롤러를 해제해도 세션에 전송된 모든 대기 중인 명령어가 전송되며 이러한 명령어가 처리된 후 또는 제한 시간이 지난 후에만 세션 서비스에서 바인딩이 해제됩니다(둘 중 먼저 발생하는 경우).

MediaBrowser 만들기 및 사용

MediaBrowser는 MediaController에서 제공하는 기능을 기반으로 미디어 앱의 MediaLibraryService에서 제공하는 미디어 라이브러리도 탐색할 수 있도록 합니다.

Kotlin

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());

미디어 앱의 콘텐츠 라이브러리 탐색을 시작하려면 먼저 getLibraryRoot()를 사용하여 루트 노드를 가져옵니다.

Kotlin

// 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());

그런 다음 getChildren()를 사용하여 라이브러리에서 MediaItem의 하위 요소를 검색하여 미디어 라이브러리를 탐색할 수 있습니다. 예를 들어 루트 노드 MediaItem의 하위 요소를 검색하려면 다음을 실행합니다.

Kotlin

// 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());

다른 미디어 앱의 재생 컨트롤 표시

다른 미디어 앱의 버튼이 있는 UI 컨트롤을 표시할 때는 해당 앱의 선언된 미디어 버튼 환경설정을 따라야 합니다.

앱의 환경설정과 UI의 제약 조건 및 요구사항을 해결하는 가장 좋은 방법은 CommandButton.DisplayConstraints를 사용하는 것입니다. UI에서 할 수 있는 작업의 제한사항을 정의할 수 있으며 resolve 메서드는 아이콘, 위치, 의도된 작업과 함께 표시할 버튼의 명확한 목록을 제공합니다.