Có hai cách để kết nối với một ứng dụng đa phương tiện:
MediaControllerMediaBrowser
MediaController
Trình điều khiển nội dung nghe nhìn tương tác với phiên phát nội dung nghe nhìn để truy vấn và kiểm soát quá trình phát của ứng dụng đa phương tiện. Trong Media3, API MediaController triển khai giao diện Player. Sau đây là ví dụ về các ứng dụng khách sử dụng trình điều khiển nội dung nghe nhìn:
- Các nút điều khiển nội dung nghe nhìn của hệ thống Android
- Ứng dụng đồng hành Wear OS của Android
- Android Auto và Automotive OS
- Trợ lý thoại, chẳng hạn như Trợ lý Google
- Ứng dụng Kiểm thử trình điều khiển nội dung nghe nhìn
Trình điều khiển nội dung nghe nhìn cũng có thể hữu ích trong ứ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 có 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à một nơi phù hợp cho 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 bộ điều khiển với phiên đã cho. Quá trình này diễn ra không đồng bộ, vì vậy, bạn nên lắng nghe kết quả và sử dụng kết quả đó khi có sẵn.
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 quá trình phát của MediaSession đã kết nối.
Điều này có nghĩa là việc gọi play() trên MediaController sẽ gửi lệnh đến MediaSession đã kết nối, sau đó sẽ uỷ quyền lệnh cho Player cơ bản.
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 chi tiết 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 tuỳ chỉnh từ MediaSession đã kết nối. Ví dụ: onCustomCommand() khi phiên gửi lệnh tuỳ chỉnh, onAvailableSessionCommandsChanged() khi phiên thay đổi các lệnh phiên có sẵn hoặc onDisconnected() khi bộ điều khiển bị ngắt kết nối khỏi phiên.
Bạn có thể đặt MediaController.Listener khi tạo trình điều khiển bằng
Builder:
Kotlin
val controllerFuture = 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()
Java
ListenableFuture<MediaController> controllerFuture = 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();
Giống như các thành phần khác, hãy nhớ giải phóng MediaController khi không cần đến nữa, 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 giải phóng bộ điều khiển vẫn sẽ phân phối tất cả lệnh đang chờ xử lý được gửi đến phiên và chỉ huỷ liên kết khỏ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ỳ theo điều kiện nào xảy ra trước.
MediaBrowser
MediaBrowser được xây dựng dựa trên các chức năng do MediaController cung cấp để cho phép duyệt xem thư viện nội dung nghe nhìn do MediaLibraryService của ứng dụng đa phương tiện cung cấp.
Tạo một MediaBrowser
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());
Sử dụng MediaBrowser
Để bắt đầu duyệt xem 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ể di chuyển trong thư viện nội dung nghe nhìn bằng cách truy xuất các phần tử con của một MediaItem trong thư viện bằng getChildren(). Ví dụ: để truy xuất các 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());
Hiển thị bộ điều khiển chế độ phát cho một ứng dụng đa phương tiện khác
Khi hiển thị các thành phần điều khiển trên giao diện người dùng có nút cho một ứng dụng đa phương tiện khác, bạn cần phải tuân theo lựa chọn ưu tiên về nút đa phương tiện đã khai báo của ứng dụng đó.
Để giải quyết các lựa chọn ưu tiên của ứng dụng bằng các quy tắc ràng buộc và yêu cầu của giao diện người dùng, hãy sử dụng CommandButton.DisplayConstraints. Bạn có thể xác định các giới hạn và hạn chế mà giao diện người dùng có thể thực hiện, đồng thời phương thức resolve() cung cấp danh sách nút nhất định để hiển thị cùng với biểu tượng, vị trí và hành động dự kiến của các nút đó. Nếu người dùng nhấp vào một trong các nút này, bạn có thể sử dụng CommandButton.executeAction để kích hoạt hành động liên quan trong ứng dụng đa phương tiện.
Kotlin
// Get media button preferences from media app val mediaButtonPreferences = controller.getMediaButtonPreferences() // Declare constraints of UI (example: limit overflow button to one) val displayConstraints = DisplayConstraints.Builder().setMaxButtonsForSlot(CommandButton.SLOT_OVERFLOW, 1).build() // Resolve media app preferences with constraints val resolvedButtons = displayConstraints.resolve(mediaButtonPreferences, controller) // Display buttons in UI for (button in resolvedButtons) { generateUiButton( uiPosition = button.slots[0], icon = getIconRes(button.icon), onClick = { button.executeAction(controller) }, ) }
Java
// Get media button preferences from media app List<CommandButton> mediaButtonPreferences = controller.getMediaButtonPreferences(); // Declare constraints of UI (example: limit overflow button to one) DisplayConstraints displayConstraints = new DisplayConstraints.Builder() .setMaxButtonsForSlot(CommandButton.SLOT_OVERFLOW, 1) .build(); // Resolve media app preferences with constraints List<CommandButton> resolvedButtons = displayConstraints.resolve(mediaButtonPreferences, controller); // Display buttons in UI for (CommandButton button : resolvedButtons) { generateUiButton( /* uiPosition= */ button.slots.get(0), /* icon= */ getIconRes(button.icon), /* onClick= */ () -> button.executeAction(controller)); }