Các nút điều khiển nội dung nghe nhìn trong Android nằm gần phần Cài đặt nhanh. Các phiên từ nhiều ứng dụng được sắp xếp trong một băng chuyền có thể vuốt. Băng chuyền liệt kê các phiên theo thứ tự sau:
- Luồng phát cục bộ trên điện thoại
- Luồng từ xa, chẳng hạn như những luồng được phát hiện trên thiết bị bên ngoài hoặc phiên truyền
- Các phiên có thể tiếp tục trước đó, theo thứ tự phát gần đây nhất
Kể từ Android 13 (API cấp 33), để đảm bảo người dùng có thể truy cập vào một bộ điều khiển nội dung đa phương tiện phong phú cho các ứng dụng phát nội dung đa phương tiện, các nút hành động trên các chế độ điều khiển nội dung đa phương tiện được lấy từ trạng thái Player.
Bằng cách này, bạn có thể trình bày một bộ điều khiển nội dung nghe nhìn nhất quán và trải nghiệm điều khiển nội dung nghe nhìn tinh tế hơn trên các thiết bị.
Hình 1 cho thấy ví dụ về giao diện này trên điện thoại và máy tính bảng tương ứng.
Hệ thống hiển thị tối đa 5 nút hành động dựa trên trạng thái Player như mô tả trong bảng sau. Ở chế độ thu gọn, chỉ 3 khe hành động đầu tiên mới hiển thị. Điều này phù hợp với cách hiển thị các chế độ điều khiển nội dung nghe nhìn trong các nền tảng Android khác như Auto, Trợ lý và Wear OS.
| Khe | Tiêu chí | Thao tác |
|---|---|---|
| 1 |
playWhenReady là sai hoặc trạng thái phát hiện tại là STATE_ENDED.
|
Phát |
playWhenReady là đúng và trạng thái phát hiện tại là STATE_BUFFERING.
|
Vòng quay đang tải | |
playWhenReady là đúng và trạng thái phát hiện tại là STATE_READY. |
Tạm dừng | |
| 2 | Có lệnh phát COMMAND_SEEK_TO_PREVIOUS hoặc COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM. |
Trước |
Không có lệnh người chơi COMMAND_SEEK_TO_PREVIOUS hoặc COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM nào và bạn có thể sử dụng lệnh tuỳ chỉnh từ bố cục tuỳ chỉnh chưa được đặt để điền vào vị trí này. |
Điều chỉnh | |
Thông tin bổ sung về phiên bao gồm giá trị boolean true cho khoá EXTRAS_KEY_SLOT_RESERVATION_SEEK_TO_PREV. |
Trống | |
| 3 | Có lệnh phát COMMAND_SEEK_TO_NEXT hoặc COMMAND_SEEK_TO_NEXT_MEDIA_ITEM. |
Tiếp theo |
Không có lệnh người chơi COMMAND_SEEK_TO_NEXT hoặc COMMAND_SEEK_TO_NEXT_MEDIA_ITEM nào và bạn có thể sử dụng lệnh tuỳ chỉnh từ bố cục tuỳ chỉnh chưa được đặt để điền vào vị trí này. |
Điều chỉnh | |
Thông tin bổ sung về phiên bao gồm giá trị boolean true cho khoá EXTRAS_KEY_SLOT_RESERVATION_SEEK_TO_NEXT. |
Trống | |
| 4 | Bạn có thể sử dụng một lệnh tuỳ chỉnh từ bố cục tuỳ chỉnh chưa được đặt để lấp đầy vị trí. | Điều chỉnh |
| 5 | Bạn có thể sử dụng một lệnh tuỳ chỉnh từ bố cục tuỳ chỉnh chưa được đặt để lấp đầy vị trí. | Điều chỉnh |
Các lệnh tuỳ chỉnh được đặt theo thứ tự được thêm vào bố cục tuỳ chỉnh.
Tuỳ chỉnh nút lệnh
Để tuỳ chỉnh các chế độ điều khiển nội dung nghe nhìn của hệ thống bằng Jetpack Media3, bạn có thể đặt bố cục tuỳ chỉnh của phiên và các lệnh có sẵn của trình điều khiển cho phù hợp khi triển khai MediaSessionService:
Trong
onCreate(), hãy tạo mộtMediaSessionvà xác định bố cục tuỳ chỉnh của các nút lệnh.Trong
MediaSession.Callback.onConnect(), hãy uỷ quyền cho bộ điều khiển bằng cách xác định các lệnh có sẵn, bao gồm cả lệnh tuỳ chỉnh trongConnectionResult.Trong
MediaSession.Callback.onCustomCommand(), hãy phản hồi lệnh tuỳ chỉnh mà người dùng chọn.
Kotlin
class PlaybackService : MediaSessionService() { private val customCommandFavorites = SessionCommand(ACTION_FAVORITES, Bundle.EMPTY) private var mediaSession: MediaSession? = null override fun onCreate() { super.onCreate() val favoriteButton = CommandButton.Builder() .setDisplayName("Save to favorites") .setIconResId(R.drawable.favorite_icon) .setSessionCommand(customCommandFavorites) .build() val player = ExoPlayer.Builder(this).build() // Build the session with a custom layout. mediaSession = MediaSession.Builder(this, player) .setCallback(MyCallback()) .setCustomLayout(ImmutableList.of(favoriteButton)) .build() } private inner class MyCallback : MediaSession.Callback { override fun onConnect( session: MediaSession, controller: MediaSession.ControllerInfo ): ConnectionResult { // Set available player and session commands. return AcceptedResultBuilder(session) .setAvailablePlayerCommands( ConnectionResult.DEFAULT_PLAYER_COMMANDS.buildUpon() .remove(COMMAND_SEEK_TO_NEXT) .remove(COMMAND_SEEK_TO_NEXT_MEDIA_ITEM) .remove(COMMAND_SEEK_TO_PREVIOUS) .remove(COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM) .build() ) .setAvailableSessionCommands( ConnectionResult.DEFAULT_SESSION_COMMANDS.buildUpon() .add(customCommandFavorites) .build() ) .build() } override fun onCustomCommand( session: MediaSession, controller: MediaSession.ControllerInfo, customCommand: SessionCommand, args: Bundle ): ListenableFuture{ if (customCommand.customAction == ACTION_FAVORITES) { // Do custom logic here saveToFavorites(session.player.currentMediaItem) return Futures.immediateFuture(SessionResult(SessionResult.RESULT_SUCCESS)) } return super.onCustomCommand(session, controller, customCommand, args) } } }
Java
public class PlaybackService extends MediaSessionService { private static final SessionCommand CUSTOM_COMMAND_FAVORITES = new SessionCommand("ACTION_FAVORITES", Bundle.EMPTY); @Nullable private MediaSession mediaSession; public void onCreate() { super.onCreate(); CommandButton favoriteButton = new CommandButton.Builder() .setDisplayName("Save to favorites") .setIconResId(R.drawable.favorite_icon) .setSessionCommand(CUSTOM_COMMAND_FAVORITES) .build(); Player player = new ExoPlayer.Builder(this).build(); // Build the session with a custom layout. mediaSession = new MediaSession.Builder(this, player) .setCallback(new MyCallback()) .setCustomLayout(ImmutableList.of(favoriteButton)) .build(); } private static class MyCallback implements MediaSession.Callback { @Override public ConnectionResult onConnect( MediaSession session, MediaSession.ControllerInfo controller) { // Set available player and session commands. return new AcceptedResultBuilder(session) .setAvailablePlayerCommands( ConnectionResult.DEFAULT_PLAYER_COMMANDS.buildUpon() .remove(COMMAND_SEEK_TO_NEXT) .remove(COMMAND_SEEK_TO_NEXT_MEDIA_ITEM) .remove(COMMAND_SEEK_TO_PREVIOUS) .remove(COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM) .build()) .setAvailableSessionCommands( ConnectionResult.DEFAULT_SESSION_COMMANDS.buildUpon() .add(CUSTOM_COMMAND_FAVORITES) .build()) .build(); } public ListenableFutureonCustomCommand( MediaSession session, MediaSession.ControllerInfo controller, SessionCommand customCommand, Bundle args) { if (customCommand.customAction.equals(CUSTOM_COMMAND_FAVORITES.customAction)) { // Do custom logic here saveToFavorites(session.getPlayer().getCurrentMediaItem()); return Futures.immediateFuture(new SessionResult(SessionResult.RESULT_SUCCESS)); } return MediaSession.Callback.super.onCustomCommand( session, controller, customCommand, args); } } }
Để tìm hiểu thêm về cách định cấu hình MediaSession để các ứng dụng như hệ thống có thể kết nối với ứng dụng đa phương tiện, hãy xem phần Cấp quyền kiểm soát cho các ứng dụng khác.
Với Jetpack Media3, khi bạn triển khai MediaSession, PlaybackState sẽ tự động được cập nhật bằng trình phát nội dung nghe nhìn. Tương tự, khi bạn triển khai MediaSessionService, thư viện sẽ tự động phát hành thông báo MediaStyle cho bạn và cập nhật thông báo đó.
Phản hồi nút hành động
Khi người dùng nhấn vào một nút hành động trong các chế độ điều khiển nội dung nghe nhìn của hệ thống, MediaController của hệ thống sẽ gửi lệnh phát đến MediaSession. Sau đó, MediaSession sẽ uỷ quyền các lệnh đó cho người chơi. Các lệnh được xác định trong giao diện Player của Media3 sẽ tự động được xử lý bằng phiên nội dung nghe nhìn.
Hãy tham khảo bài viết Thêm lệnh tuỳ chỉnh để biết hướng dẫn về cách phản hồi lệnh tuỳ chỉnh.
Hành vi trước Android 13
Để tương thích ngược, Giao diện người dùng hệ thống tiếp tục cung cấp một bố cục thay thế sử dụng các hành động thông báo cho những ứng dụng không cập nhật để nhắm đến Android 13 hoặc không bao gồm thông tin PlaybackState. Các nút hành động được lấy từ danh sách Notification.Action đính kèm vào thông báo MediaStyle. Hệ thống sẽ hiển thị tối đa 5 thao tác theo thứ tự được thêm. Ở chế độ thu gọn, tối đa 3 nút sẽ hiển thị, được xác định theo các giá trị được truyền vào setShowActionsInCompactView().
Các thao tác tuỳ chỉnh được đặt theo thứ tự được thêm vào PlaybackState.
Mã ví dụ sau đây minh hoạ cách thêm thao tác vào thông báo MediaStyle :
Kotlin
import androidx.core.app.NotificationCompat import androidx.media3.session.MediaStyleNotificationHelper var notification = NotificationCompat.Builder(context, CHANNEL_ID) // Show controls on lock screen even when user hides sensitive content. .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) .setSmallIcon(R.drawable.ic_stat_player) // Add media control buttons that invoke intents in your media service .addAction(R.drawable.ic_prev, "Previous", prevPendingIntent) // #0 .addAction(R.drawable.ic_pause, "Pause", pausePendingIntent) // #1 .addAction(R.drawable.ic_next, "Next", nextPendingIntent) // #2 // Apply the media style template .setStyle(MediaStyleNotificationHelper.MediaStyle(mediaSession) .setShowActionsInCompactView(1 /* #1: pause button */)) .setContentTitle("Wonderful music") .setContentText("My Awesome Band") .setLargeIcon(albumArtBitmap) .build()
Java
import androidx.core.app.NotificationCompat; import androidx.media3.session.MediaStyleNotificationHelper; NotificationCompat.Builder notification = new NotificationCompat.Builder(context, CHANNEL_ID) .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) .setSmallIcon(R.drawable.ic_stat_player) .addAction(R.drawable.ic_prev, "Previous", prevPendingIntent) .addAction(R.drawable.ic_pause, "Pause", pausePendingIntent) .addAction(R.drawable.ic_next, "Next", nextPendingIntent) .setStyle(new MediaStyleNotificationHelper.MediaStyle(mediaSession) .setShowActionsInCompactView(1 /* #1: pause button */)) .setContentTitle("Wonderful music") .setContentText("My Awesome Band") .setLargeIcon(albumArtBitmap) .build();
Hỗ trợ tiếp tục phát nội dung nghe nhìn
Tính năng tiếp tục phát nội dung nghe nhìn cho phép người dùng khởi động lại các phiên trước đó từ băng chuyền mà không cần khởi động ứng dụng. Khi quá trình phát bắt đầu, người dùng tương tác với các nút điều khiển nội dung nghe nhìn theo cách thông thường.
Bạn có thể bật và tắt tính năng tiếp tục phát bằng ứng dụng Cài đặt, trong phần Âm thanh > Nội dung nghe nhìn. Người dùng cũng có thể truy cập vào phần Cài đặt bằng cách nhấn vào biểu tượng bánh răng xuất hiện sau khi vuốt trên băng chuyền mở rộng.
Media3 cung cấp các API giúp hỗ trợ việc tiếp tục phát nội dung nghe nhìn dễ dàng hơn. Hãy xem tài liệu về Tiếp tục phát bằng Media3 để biết hướng dẫn triển khai tính năng này.
Sử dụng API đa phương tiện cũ
Phần này giải thích cách tích hợp với các chế độ điều khiển nội dung nghe nhìn của hệ thống bằng các API MediaCompat cũ.
Hệ thống truy xuất thông tin sau từ MediaMetadata của MediaSession và hiển thị thông tin đó khi có:
METADATA_KEY_ALBUM_ART_URIMETADATA_KEY_TITLEMETADATA_KEY_DISPLAY_TITLEMETADATA_KEY_ARTISTMETADATA_KEY_DURATION(Nếu bạn không đặt thời lượng, thanh tua sẽ không hiển thị tiến trình)
Để đảm bảo bạn có thông báo điều khiển nội dung đa phương tiện hợp lệ và chính xác, hãy đặt giá trị của siêu dữ liệu METADATA_KEY_TITLE hoặc METADATA_KEY_DISPLAY_TITLE thành tiêu đề của nội dung đa phương tiện đang phát.
Trình phát nội dung đa phương tiện hiển thị thời gian đã trôi qua cho nội dung đa phương tiện đang phát, cùng với thanh tua lại được liên kết với MediaSession
PlaybackState.
Trình phát nội dung nghe nhìn cho biết tiến trình của nội dung nghe nhìn đang phát, cùng với thanh tua được liên kết với MediaSession PlaybackState. Thanh tua đi cho phép người dùng thay đổi vị trí và hiển thị thời gian đã trôi qua cho mục nội dung nghe nhìn. Để bật thanh tua, bạn phải triển khai PlaybackState.Builder#setActions và đưa ACTION_SEEK_TO vào.
| Khe | Thao tác | Tiêu chí |
|---|---|---|
| 1 | Phát |
Trạng thái hiện tại của PlaybackState là một trong những trạng thái sau:
|
| Vòng quay đang tải |
Trạng thái hiện tại của PlaybackState là một trong những trạng thái sau:
|
|
| Tạm dừng | Trạng thái hiện tại của PlaybackState không phải là trạng thái nào nêu trên. |
|
| 2 | Trước | Thao tác PlaybackState bao gồm ACTION_SKIP_TO_PREVIOUS. |
| Điều chỉnh | Thao tác PlaybackState không bao gồm ACTION_SKIP_TO_PREVIOUS và Thao tác tuỳ chỉnh PlaybackState bao gồm một thao tác tuỳ chỉnh chưa được đặt. |
|
| Trống | PlaybackState thông tin bổ sung bao gồm giá trị boolean true cho khoá SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_PREV. |
|
| 3 | Tiếp theo | Thao tác PlaybackState bao gồm ACTION_SKIP_TO_NEXT. |
| Điều chỉnh | Thao tác PlaybackState không bao gồm ACTION_SKIP_TO_NEXT và Thao tác tuỳ chỉnh PlaybackState bao gồm một thao tác tuỳ chỉnh chưa được đặt. |
|
| Trống | PlaybackState thông tin bổ sung bao gồm giá trị boolean true cho khoá SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_NEXT. |
|
| 4 | Điều chỉnh | Hành động tuỳ chỉnh PlaybackState bao gồm một hành động tuỳ chỉnh chưa được đặt. |
| 5 | Điều chỉnh | Hành động tuỳ chỉnh PlaybackState bao gồm một hành động tuỳ chỉnh chưa được đặt. |
Thêm thao tác chuẩn
Các ví dụ về mã sau đây minh hoạ cách thêm thao tác tuỳ chỉnh và thao tác chuẩn PlaybackState.
Đối với các thao tác phát, tạm dừng, trước và tiếp theo, hãy đặt các thao tác này trong PlaybackState cho phiên phát nội dung nghe nhìn.
Kotlin
val session = MediaSessionCompat(context, TAG) val playbackStateBuilder = PlaybackStateCompat.Builder() val style = NotificationCompat.MediaStyle() // For this example, the media is currently paused: val state = PlaybackStateCompat.STATE_PAUSED val position = 0L val playbackSpeed = 1f playbackStateBuilder.setState(state, position, playbackSpeed) // And the user can play, skip to next or previous, and seek val stateActions = PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PLAY_PAUSE or PlaybackStateCompat.ACTION_SKIP_TO_PREVIOUS or PlaybackStateCompat.ACTION_SKIP_TO_NEXT or PlaybackStateCompat.ACTION_SEEK_TO // adding the seek action enables seeking with the seekbar playbackStateBuilder.setActions(stateActions) // ... do more setup here ... session.setPlaybackState(playbackStateBuilder.build()) style.setMediaSession(session.sessionToken) notificationBuilder.setStyle(style)
Java
MediaSessionCompat session = new MediaSessionCompat(context, TAG); PlaybackStateCompat.Builder playbackStateBuilder = new PlaybackStateCompat.Builder(); NotificationCompat.MediaStyle style = new NotificationCompat.MediaStyle(); // For this example, the media is currently paused: int state = PlaybackStateCompat.STATE_PAUSED; long position = 0L; float playbackSpeed = 1f; playbackStateBuilder.setState(state, position, playbackSpeed); // And the user can play, skip to next or previous, and seek long stateActions = PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PLAY_PAUSE | PlaybackStateCompat.ACTION_SKIP_TO_PREVIOUS | PlaybackStateCompat.ACTION_SKIP_TO_NEXT | PlaybackStateCompat.ACTION_SEEK_TO; // adding this enables the seekbar thumb playbackStateBuilder.setActions(stateActions); // ... do more setup here ... session.setPlaybackState(playbackStateBuilder.build()); style.setMediaSession(session.getSessionToken()); notificationBuilder.setStyle(style);
Nếu bạn không muốn có nút nào trong khe trước hoặc khe tiếp theo, đừng thêm ACTION_SKIP_TO_PREVIOUS hoặc ACTION_SKIP_TO_NEXT, thay vào đó, hãy thêm các nút bổ sung vào phiên:
Kotlin
session.setExtras(Bundle().apply { putBoolean(SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_PREV, true) putBoolean(SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_NEXT, true) })
Java
Bundle extras = new Bundle(); extras.putBoolean(SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_PREV, true); extras.putBoolean(SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_NEXT, true); session.setExtras(extras);
Thêm thao tác tuỳ chỉnh
Đối với các thao tác khác mà bạn muốn hiển thị trên các nút điều khiển nội dung nghe nhìn, bạn có thể tạo một PlaybackStateCompat.CustomAction rồi thêm thao tác đó vào PlaybackState. Các hành động này sẽ xuất hiện theo thứ tự được thêm.
Kotlin
val customAction = PlaybackStateCompat.CustomAction.Builder( "com.example.MY_CUSTOM_ACTION", // action ID "Custom Action", // title - used as content description for the button R.drawable.ic_custom_action ).build() playbackStateBuilder.addCustomAction(customAction)
Java
PlaybackStateCompat.CustomAction customAction = new PlaybackStateCompat.CustomAction.Builder( "com.example.MY_CUSTOM_ACTION", // action ID "Custom Action", // title - used as content description for the button R.drawable.ic_custom_action ).build(); playbackStateBuilder.addCustomAction(customAction);
Phản hồi các hành động PlaybackState
Khi người dùng nhấn vào một nút, SystemUI sẽ sử dụng MediaController.TransportControls để gửi lệnh trở lại MediaSession. Bạn cần đăng ký một lệnh gọi lại có thể phản hồi đúng cách các sự kiện này.
Kotlin
val callback = object: MediaSession.Callback() { override fun onPlay() { // start playback } override fun onPause() { // pause playback } override fun onSkipToPrevious() { // skip to previous } override fun onSkipToNext() { // skip to next } override fun onSeekTo(pos: Long) { // jump to position in track } override fun onCustomAction(action: String, extras: Bundle?) { when (action) { CUSTOM_ACTION_1 -> doCustomAction1(extras) CUSTOM_ACTION_2 -> doCustomAction2(extras) else -> { Log.w(TAG, "Unknown custom action $action") } } } } session.setCallback(callback)
Java
MediaSession.Callback callback = new MediaSession.Callback() { @Override public void onPlay() { // start playback } @Override public void onPause() { // pause playback } @Override public void onSkipToPrevious() { // skip to previous } @Override public void onSkipToNext() { // skip to next } @Override public void onSeekTo(long pos) { // jump to position in track } @Override public void onCustomAction(String action, Bundle extras) { if (action.equals(CUSTOM_ACTION_1)) { doCustomAction1(extras); } else if (action.equals(CUSTOM_ACTION_2)) { doCustomAction2(extras); } else { Log.w(TAG, "Unknown custom action " + action); } } };
Tiếp tục phát nội dung nghe nhìn
Để ứng dụng trình phát của bạn xuất hiện trong khu vực cài đặt chế độ cài đặt nhanh, bạn phải tạo thông báo MediaStyle bằng mã thông báo MediaSession hợp lệ.
Để hiển thị tiêu đề cho thông báo MediaStyle, hãy sử dụng NotificationBuilder.setContentTitle().
Để hiển thị biểu tượng thương hiệu cho trình phát nội dung nghe nhìn, hãy sử dụng NotificationBuilder.setSmallIcon().
Để hỗ trợ tính năng tiếp tục phát, ứng dụng phải triển khai MediaBrowserService và MediaSession. MediaSession phải triển khai lệnh gọi lại onPlay().
Triển khai MediaBrowserService
Sau khi thiết bị khởi động, hệ thống sẽ tìm 5 ứng dụng đa phương tiện được sử dụng gần đây nhất và cung cấp các chế độ điều khiển có thể dùng để bắt đầu lại phát từ mỗi ứng dụng.
Hệ thống sẽ cố gắng liên hệ với MediaBrowserService của bạn bằng một kết nối từ SystemUI. Ứng dụng của bạn phải cho phép các kết nối như vậy, nếu không, ứng dụng sẽ không thể hỗ trợ việc tiếp tục phát.
Bạn có thể xác định và xác minh các kết nối từ SystemUI bằng cách sử dụng tên gói com.android.systemui và chữ ký. SystemUI được ký bằng chữ ký nền tảng. Bạn có thể xem ví dụ về cách kiểm tra chữ ký nền tảng trong ứng dụng UAMP.
Để hỗ trợ tính năng tiếp tục phát, MediaBrowserService phải triển khai các hành vi sau:
onGetRoot()phải nhanh chóng trả về một gốc không rỗng. Bạn nên xử lý các logic phức tạp khác trongonLoadChildren()Khi
onLoadChildren()được gọi trên mã nội dung nghe nhìn gốc, kết quả phải chứa một FLAG_PLAYABLE con.MediaBrowserServicesẽ trả về mục nội dung nghe nhìn được phát gần đây nhất khi nhận được truy vấn EXTRA_RECENT. Giá trị được trả về phải là một mục nội dung nghe nhìn thực tế thay vì hàm chung.MediaBrowserServicephải cung cấp một MediaDescription thích hợp với tiêu đề và phụ đề không trống. Tệp này cũng phải đặt URI biểu tượng hoặc bitmap biểu tượng.
Các ví dụ về mã sau đây minh hoạ cách triển khai onGetRoot().
Kotlin
override fun onGetRoot( clientPackageName: String, clientUid: Int, rootHints: Bundle? ): BrowserRoot? { ... // Verify that the specified package is SystemUI. You'll need to write your // own logic to do this. if (isSystem(clientPackageName, clientUid)) { rootHints?.let { if (it.getBoolean(BrowserRoot.EXTRA_RECENT)) { // Return a tree with a single playable media item for resumption. val extras = Bundle().apply { putBoolean(BrowserRoot.EXTRA_RECENT, true) } return BrowserRoot(MY_RECENTS_ROOT_ID, extras) } } // You can return your normal tree if the EXTRA_RECENT flag is not present. return BrowserRoot(MY_MEDIA_ROOT_ID, null) } // Return an empty tree to disallow browsing. return BrowserRoot(MY_EMPTY_ROOT_ID, null)
Java
@Override public BrowserRoot onGetRoot(String clientPackageName, int clientUid, Bundle rootHints) { ... // Verify that the specified package is SystemUI. You'll need to write your // own logic to do this. if (isSystem(clientPackageName, clientUid)) { if (rootHints != null) { if (rootHints.getBoolean(BrowserRoot.EXTRA_RECENT)) { // Return a tree with a single playable media item for resumption. Bundle extras = new Bundle(); extras.putBoolean(BrowserRoot.EXTRA_RECENT, true); return new BrowserRoot(MY_RECENTS_ROOT_ID, extras); } } // You can return your normal tree if the EXTRA_RECENT flag is not present. return new BrowserRoot(MY_MEDIA_ROOT_ID, null); } // Return an empty tree to disallow browsing. return new BrowserRoot(MY_EMPTY_ROOT_ID, null); }