Kết nối với một ứng dụng đa phương tiện

Bộ điều khiển nội dung nghe nhìn tương tác với một phiên phát nội dung đa phương tiện để truy vấn và điều khiển chế độ phát của ứng dụng đa phương tiện. Trong Media3, API MediaController sẽ triển khai giao diện Player. Ví dụ về các ứng dụng khách sử dụng bộ điều khiển nội dung nghe nhìn bao gồm:

Trình điều khiển nội dung nghe nhìn cũng có thể hữu ích trong một ứng dụng đa phương tiện, chẳng hạn như nếu trình phát và phiên phát nội dung nghe nhìn nằm trong một Service tách biệt với Activity hoặc Fragment với giao diện người dùng.

Tạo một MediaController

Để tạo MediaController, hãy bắt đầu bằng cách tạo SessionToken cho MediaSession tương ứng. Phương thức onStart() của Activity hoặc Fragment có thể là phương thức phù hợp để làm việc này.

Kotlin

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

Java

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

Sau đó, việc sử dụng SessionToken này để tạo MediaController sẽ kết nối tay điều khiển với phiên nhất định. Việc này diễn ra không đồng bộ, vì vậy, bạn nên theo dõi kết quả và sử dụng kết quả khi có.

Kotlin

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

Java

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

Sử dụng MediaController

MediaController triển khai giao diện Player, vì vậy, bạn có thể sử dụng các lệnh được xác định trong giao diện để điều khiển chế độ phát MediaSession đã kết nối. Tức là việc gọi play() trên MediaController sẽ gửi lệnh đến MediaSession được kết nối, sau đó uỷ quyền lệnh đến Player cơ bản của nó.

Tương tự, bạn có thể thêm Player.Listener vào bộ điều khiển để theo dõi các thay đổi ở trạng thái Player. Tham khảo hướng dẫn về Sự kiện của người chơi để biết thêm thông tin về cách sử dụng Player.Listener. Giao diện MediaController.Listener xác định các lệnh gọi lại bổ sung cho các sự kiện và lệnh đến từ MediaSession đã kết nối, chẳng hạn như onAvailableSessionCommandsChanged() khi phiên phát nội dung đa phương tiện thay đổi các lệnh có trong phiên và onDisconnected() khi tay điều khiển bị ngắt kết nối khỏi phiên.

Giống như các thành phần khác, hãy nhớ phát hành MediaController khi không còn cần thiết, chẳng hạn như trong phương thức onStop() của Activity hoặc Fragment.

Kotlin

MediaController.releaseFuture(controllerFuture)

Java

MediaController.releaseFuture(controllerFuture);

Việc huỷ bỏ bộ điều khiển sẽ vẫn phân phối tất cả lệnh đang chờ xử lý được gửi đến phiên hoạt động này và chỉ huỷ liên kết với dịch vụ phiên sau khi các lệnh này đã được xử lý hoặc sau một khoảng thời gian chờ, tuỳ vào thời điểm nào xảy ra trước.

Tạo và sử dụng MediaBrowser

MediaBrowser được xây dựng dựa trên các tính năng do MediaController cung cấp để cho phép duyệt qua thư viện nội dung nghe nhìn do MediaLibraryService của ứng dụng đa phương tiện cung cấp.

Kotlin

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

Java

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

Để bắt đầu duyệt thư viện nội dung của ứng dụng đa phương tiện, trước tiên, hãy truy xuất nút gốc bằng 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())

Java

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

Sau đó, bạn có thể điều hướng qua thư viện nội dung nghe nhìn bằng cách truy xuất phần tử con của MediaItem trong thư viện bằng getChildren(). Ví dụ: để truy xuất phần tử con của nút gốc 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())

Java

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