Điều khiển nội dung nghe nhìn

Các chế độ kiểm soát nội dung nghe nhìn trên 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:

  • Các luồng phát đang phát cục bộ trên điện thoại
  • Luồng truyền hình từ xa, chẳng hạn như luồng được phát hiện trên các 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ự lần 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ộ chế độ điều khiển nội dung nghe nhìn phong phú cho các ứng dụng phát nội dung nghe nhìn, các nút hành động trên chế độ điều khiển nội dung nghe nhì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 minh hoạ ví dụ về cách bố cục này xuất hiện trên thiết bị điện thoại và máy tính bảng.

Các chế độ điều khiển nội dung nghe nhìn về cách chúng xuất hiện trên các thiết bị điện thoại và máy tính bảng, bằng cách sử dụng ví dụ về một bản nhạc mẫu cho thấy cách các nút có thể xuất hiện
Hình 1: Các nút điều khiển nội dung nghe nhìn trên điện thoại và máy tính bảng

Hệ thống sẽ hiển thị tối đa 5 nút thao tác dựa trên trạng thái Player như mô tả trong bảng sau. Ở chế độ thu gọn, chỉ có 3 vị trí thao tác đầu tiên được hiển thị. Điều này phù hợp với cách các chế độ điều khiển nội dung nghe nhìn được kết xuất trong các nền tảng Android khác, chẳng hạn 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à true và trạng thái phát hiện tại là STATE_BUFFERING. Vòng quay đang tải
playWhenReady là true và trạng thái phát hiện tại là STATE_READY. Tạm dừng
2 Lựa chọn ưu tiên về nút nội dung nghe nhìn có một nút tuỳ chỉnh cho CommandButton.SLOT_BACK Tuỳ chỉnh
Có lệnh dành cho trình phát COMMAND_SEEK_TO_PREVIOUS hoặc COMMAND_SEEK_TO_PREVIOUS_MEDIA_ITEM. Nút trước
Không có nút tuỳ chỉnh nào cũng như không có lệnh nào trong danh sách. Trống
3 Lựa chọn ưu tiên về nút nội dung đa phương tiện có một nút tuỳ chỉnh cho CommandButton.SLOT_FORWARD Tuỳ chỉnh
Có lệnh dành cho trình phát COMMAND_SEEK_TO_NEXT hoặc COMMAND_SEEK_TO_NEXT_MEDIA_ITEM. Tiếp theo
Không có nút tuỳ chỉnh nào cũng như không có lệnh nào trong danh sách. Trống
4 Lựa chọn ưu tiên về nút nội dung đa phương tiện có một nút tuỳ chỉnh cho CommandButton.SLOT_OVERFLOW chưa được đặt. Tuỳ chỉnh
5 Lựa chọn ưu tiên về nút nội dung đa phương tiện có một nút tuỳ chỉnh cho CommandButton.SLOT_OVERFLOW chưa được đặt. Tuỳ chỉnh

Các nút tuỳ chỉnh cho trình đơn tràn được đặt theo thứ tự mà chúng được thêm vào phần lựa chọn ưu tiên cho nút đa phương tiện.

Tuỳ chỉnh nút lệnh

Để tuỳ chỉnh 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 các lựa chọn ưu tiên về nút nội dung nghe nhìn của phiên và các lệnh có sẵn của bộ điều khiển cho phù hợp:

  1. Tạo một MediaSessionxác định các lựa chọn ưu tiên cho nút nội dung nghe nhìn đối với các nút lệnh tuỳ chỉnh.

  2. 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, trong ConnectionResult.

  3. 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(CommandButton.ICON_HEART_UNFILLED)
        .setDisplayName("Save to favorites")
        .setSessionCommand(customCommandFavorites)
        .build()
    val player = ExoPlayer.Builder(this).build()
    // Build the session with a custom layout.
    mediaSession =
      MediaSession.Builder(this, player)
        .setCallback(MyCallback())
        .setMediaButtonPreferences(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)
      .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(CommandButton.ICON_HEART_UNFILLED)
            .setDisplayName("Save to favorites")
            .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())
            .setMediaButtonPreferences(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)
          .setAvailableSessionCommands(
              ConnectionResult.DEFAULT_SESSION_COMMANDS.buildUpon()
                .add(CUSTOM_COMMAND_FAVORITES)
                .build())
          .build();
    }

    public ListenableFuture onCustomCommand(
        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 của bạ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 một MediaSession, PlaybackState của bạn sẽ tự động được cập nhật theo trình phát nội dung nghe nhìn. Tương tự, khi bạn triển khai một MediaSessionService, thư viện sẽ tự động xuất bản một MediaStyle thông báo cho bạn và luôn cập nhật thông báo đó.

Phản hồi các nút thao tác

Khi người dùng nhấn vào một nút hành động trong 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 của bạn. Sau đó, MediaSession sẽ uỷ quyền các lệnh đó cho trình phát. Các lệnh được xác định trong giao diện Player của Media3 sẽ được phiên phát nội dung nghe nhìn tự động xử lý.

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 một lệnh tuỳ chỉnh.

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 phải khởi động ứng dụng. Khi quá trình phát bắt đầu, người dùng sẽ 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 bạn dễ dàng hỗ trợ tính năng tiếp tục phát nội dung nghe nhìn. Hãy xem tài liệu Tiếp tục phát bằng Media3 để được hướng dẫn về cách 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 nút điều khiển nội dung nghe nhìn của hệ thống bằng cách sử dụng MediaCompat API cũ.

Hệ thống truy xuất thông tin sau đây từ MediaMetadata của MediaSession và hiển thị thông tin đó khi có:

  • METADATA_KEY_ALBUM_ART_URI
  • METADATA_KEY_TITLE
  • METADATA_KEY_DISPLAY_TITLE
  • METADATA_KEY_ARTIST
  • METADATA_KEY_DURATION (Nếu bạn không đặt thời lượng, thanh tìm kiếm sẽ không hiển thị tiến trình)

Để đảm bảo bạn có một thông báo điều khiển nội dung nghe nhì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 nghe nhìn đang phát.

Trình phát nội dung nghe nhìn cho biết thời gian đã trôi qua của nội dung nghe nhìn đang phát, cùng với một thanh tua đượ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 một thanh tua được liên kết với MediaSession PlaybackState. Thanh tua cho phép người dùng thay đổi vị trí và hiển thị thời gian đã trôi qua của mục nội dung nghe nhìn. Để bật thanh tìm kiếm, bạn phải triển khai PlaybackState.Builder#setActions và thêm ACTION_SEEK_TO.

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:
  • STATE_NONE
  • STATE_STOPPED
  • STATE_PAUSED
  • STATE_ERROR
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:
  • STATE_CONNECTING
  • STATE_BUFFERING
Tạm dừng Trạng thái hiện tại của PlaybackState không thuộc trạng thái nào kể trên.
2 Nút trước PlaybackState hành động bao gồm ACTION_SKIP_TO_PREVIOUS.
Tuỳ chỉnh PlaybackState hành động không bao gồm ACTION_SKIP_TO_PREVIOUSPlaybackState hành động tuỳ chỉnh bao gồm một hành động tuỳ chỉnh chưa được đặt.
Trống PlaybackState extras bao gồm giá trị boolean true cho khoá SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_PREV.
3 Tiếp theo PlaybackState hành động bao gồm ACTION_SKIP_TO_NEXT.
Tuỳ chỉnh PlaybackState hành động không bao gồm ACTION_SKIP_TO_NEXTPlaybackState hành động tuỳ chỉnh bao gồm một hành động tuỳ chỉnh chưa được đặt.
Trống PlaybackState extras bao gồm giá trị boolean true cho khoá SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_NEXT.
4 Tuỳ chỉnh PlaybackState Các thao tác tuỳ chỉnh bao gồm một thao tác tuỳ chỉnh chưa được đặt.
5 Tuỳ chỉnh PlaybackState Các thao tác tuỳ chỉnh bao gồm một thao tác tuỳ chỉnh chưa được đặt.

Thêm thao tác tiêu chuẩn

Các ví dụ về mã sau đây minh hoạ cách thêm các thao tác tuỳ chỉnh và tiêu 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 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 ở vị trí trước hoặc tiếp theo, đừng thêm ACTION_SKIP_TO_PREVIOUS hoặc ACTION_SKIP_TO_NEXT mà hãy thêm các phần 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 những 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 và thêm thao tác đó vào PlaybackState. Các thao tác này xuất hiện theo thứ tự được thêm vào.

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 thao tác PlaybackState

Khi người dùng nhấn vào một nút, SystemUI 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 cho những 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ợ tiếp tục phát, các ứng dụng phải triển khai MediaBrowserServiceMediaSession. MediaSession của bạn 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 nội dung nghe nhìn được dùng gần đây nhất và cung cấp các chế độ điều khiển có thể dùng để khởi động lại quá trình phát từ mỗi ứng dụng.

Hệ thống cố gắng liên hệ với MediaBrowserService 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 thì ứng dụng sẽ không hỗ trợ tính năng 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 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 của bạn phải triển khai các hành vi sau:

  • onGetRoot() phải nhanh chóng trả về một gốc khác rỗng. Các logic phức tạp khác phải được xử lý trong onLoadChildren()

  • Khi onLoadChildren() được gọi trên mã nhận dạng nội dung nghe nhìn gốc, kết quả phải chứa một phần tử con FLAG_PLAYABLE.

  • MediaBrowserService sẽ 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ế chứ không phải là hàm chung.

  • MediaBrowserService phải cung cấp một MediaDescription phù hợp có titlesubtitle không có dữ liệu. Bạn cũng nên đặt một URI biểu tượng hoặc một 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);
}

Hành vi trước Android 13

Để đảm bảo khả năng tương thích ngược, Giao diện người dùng hệ thống sẽ tiếp tục cung cấp một bố cục thay thế sử dụng các thao tác trên 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 có thông tin PlaybackState. Các nút hành động được lấy từ danh sách Notification.Action được đí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ự mà bạn đã thêm. Ở chế độ thu gọn, tối đa 3 nút sẽ xuất hiện, được xác định bằng các giá trị được truyền vào setShowActionsInCompactView().

Các thao tác tuỳ chỉnh được đặt theo thứ tự mà chúng được thêm vào PlaybackState.

Ví dụ về mã sau đây minh hoạ cách thêm các 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)
// 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(new MediaStyleNotificationHelper.MediaStyle(mediaSession)
.setShowActionsInCompactView(1 /* #1: pause button */))
.setContentTitle("Wonderful music")
.setContentText("My Awesome Band")
.setLargeIcon(albumArtBitmap)
.build();