Phiên phát nội dung nghe nhìn là cách thức tương tác phổ biến với trình phát âm thanh hoặc trình phát video. Bằng cách thông báo cho Android rằng nội dung nghe nhìn đang phát trong một ứng dụng, bạn có thể uỷ quyền bộ điều khiển chế độ phát cho ứng dụng đó. Việc tích hợp với phiên phát nội dung nghe nhìn cho phép ứng dụng quảng cáo nội dung nghe nhìn phát ra bên ngoài và nhận lệnh phát từ các nguồn bên ngoài. Các nguồn này có thể là nút vật lý (chẳng hạn như nút phát trên tai nghe hoặc điều khiển TV) hoặc lệnh gián tiếp (chẳng hạn như ra lệnh "tạm dừng" cho Trợ lý Google). Sau đó, phiên phát nội dung nghe nhìn sẽ uỷ quyền các lệnh này cho ứng dụng áp dụng các lệnh đó cho trình phát nội dung nghe nhìn, nơi các lệnh bắt nguồn một cách minh bạch.
Phiên phát nội dung nghe nhìn hoạt động cùng với trình phát mà phiên đó quản lý. Bạn nên tạo và khởi động một phiên phát nội dung nghe nhìn trong phương thức onCreate() của activity hoặc service sở hữu phiên phát nội dung nghe nhìn và trình phát liên kết.
Khởi động phiên nội dung nghe nhìn
Phiên phát nội dung nghe nhìn mới tạo không có chức năng nào. Bạn phải khởi chạy phiên bằng cách thực hiện các bước sau:
- Đặt cờ để phiên đa phương tiện có thể nhận lệnh gọi lại từ bộ điều khiển nội dung nghe nhìn và nút nội dung nghe nhìn.
- Tạo và khởi động một thực thể của
PlaybackStateCompatrồi chỉ định thực thể đó cho phiên. Trạng thái phát thay đổi trong suốt phiên, vì vậy, bạn nên lưuPlaybackStateCompat.Buildervào bộ nhớ đệm để sử dụng lại. - Tạo một thực thể của
MediaSessionCompat.Callbackvà chỉ định thực thể đó cho phiên (xem thêm về lệnh gọi lại bên dưới).
Bạn nên tạo và khởi chạy một phiên phát nội dung nghe nhìn trong phương thức onCreate() của hoạt động hoặc dịch vụ sở hữu phiên đó.
Để nút nội dung nghe nhìn hoạt động khi ứng dụng của bạn mới được khởi chạy (hoặc
dừng), PlaybackState của ứng dụng phải chứa một hành động phát khớp với ý định
mà nút nội dung nghe nhìn gửi. Đây là lý do ACTION_PLAY được gán cho trạng thái phiên trong quá trình khởi chạy. Để biết thêm thông tin, hãy xem phần Phản hồi các nút nội dung nghe nhìn.
Duy trì trạng thái phát và siêu dữ liệu
Có hai lớp đại diện cho trạng thái của một phiên phát nội dung nghe nhìn.
Lớp PlaybackStateCompat mô tả trạng thái hoạt động hiện tại của trình phát. Điều này bao gồm:
- Trạng thái truyền tải (cho biết trình phát đang phát/tạm dừng/đang lưu vào vùng đệm, v.v.
Xem
getState()) - Mã lỗi và thông báo lỗi không bắt buộc (nếu có). (Xem
getErrorCode()và đọc phần Trạng thái và lỗi bên dưới.) - Vị trí trình phát
- Các thao tác hợp lệ của tay điều khiển có thể được xử lý ở trạng thái hiện tại
Lớp MediaMetadataCompat mô tả nội dung đang phát:
- Tên nghệ sĩ, đĩa nhạc và bản nhạc
- Thời lượng bản nhạc
- Ảnh bìa đĩa nhạc để hiển thị trên màn hình khoá. Hình ảnh là một bitmap có kích thước tối đa là 320x320dp (nếu lớn hơn, hình ảnh sẽ được thu nhỏ).
- Một thực thể của
ContentUristrỏ đến phiên bản lớn hơn của hình minh hoạ
Trạng thái và siêu dữ liệu của trình phát có thể thay đổi trong suốt thời gian hoạt động của phiên phát nội dung nghe nhìn. Mỗi khi trạng thái hoặc siêu dữ liệu thay đổi, bạn phải sử dụng trình tạo tương ứng cho mỗi lớp, PlaybackStateCompat.Builder() hoặc MediaMetadataCompat.Builder(), sau đó truyền thực thể mới đến phiên phát nội dung nghe nhìn bằng cách gọi setPlaybackState() hoặc setMetaData(). Để giảm mức tiêu thụ bộ nhớ tổng thể từ các thao tác thường xuyên này, bạn nên tạo trình tạo một lần và sử dụng lại trong suốt thời gian của phiên.
Trạng thái và lỗi
Lưu ý rằng PlaybackState là một đối tượng chứa các giá trị riêng biệt cho trạng thái phát của phiên (getState()) và mã lỗi liên quan (getErrorCode()) khi cần thiết. Lỗi có thể nghiêm trọng hoặc không nghiêm trọng:
Bất cứ khi nào quá trình phát bị gián đoạn, bạn nên tạo một lỗi nghiêm trọng: Đặt trạng thái truyền tải thành STATE_ERROR và chỉ định lỗi liên quan bằng setErrorMessage(int, CharSequence). Miễn là quá trình phát bị lỗi chặn, PlaybackState sẽ tiếp tục báo cáo STATE_ERROR và lỗi.
Lỗi không nghiêm trọng xảy ra khi ứng dụng của bạn không thể xử lý yêu cầu nhưng vẫn có thể tiếp tục phát: Trình truyền tải vẫn ở trạng thái "bình thường" (chẳng hạn như STATE_PLAYING) nhưng PlaybackState chứa mã lỗi. Ví dụ: nếu bài hát cuối cùng đang phát và người dùng yêu cầu chuyển sang bài hát tiếp theo, thì quá trình phát có thể tiếp tục, nhưng bạn nên tạo một PlaybackState mới có mã lỗi ERROR_CODE_END_OF_QUEUE rồi gọi setPlaybackState(). Trình điều khiển nội dung nghe nhìn được đính kèm vào phiên sẽ nhận được lệnh gọi lại onPlaybackStateChanged() và giải thích cho người dùng về những gì đã xảy ra. Lỗi không nghiêm trọng chỉ nên được báo cáo một lần, tại thời điểm xảy ra lỗi. Vào lần tiếp theo phiên cập nhật PlaybackState, đừng đặt lại cùng một lỗi không nghiêm trọng (trừ phi lỗi xảy ra khi phản hồi một yêu cầu mới).
Màn hình khoá phiên phát nội dung nghe nhìn
Kể từ Android 4.0 (cấp độ API 14), hệ thống có thể truy cập vào trạng thái phát và siêu dữ liệu của phiên phát nội dung nghe nhìn. Đây là cách màn hình khoá có thể hiển thị các nút điều khiển nội dung nghe nhìn và hình minh hoạ. Hành vi sẽ khác nhau tuỳ theo phiên bản Android.
Hình minh họa album
Trong Android 4.0 (cấp độ API 14) đến Android 10 (cấp độ API 29), nền của màn hình khoá sẽ hiển thị ảnh bìa đĩa nhạc, nhưng chỉ khi siêu dữ liệu của phiên phát nội dung nghe nhìn có chứa bitmap nền.
Các nút điều khiển phương tiện giao thông
Trong Android 4.0 (API cấp 14) đến Android 4.4 (API cấp 19), khi một phiên phát nội dung nghe nhìn đang hoạt động và siêu dữ liệu của phiên phát nội dung nghe nhìn đó có chứa bitmap nền, thì màn hình khoá sẽ tự động hiển thị các nút điều khiển truyền tải.
Trong Android 5.0 (cấp độ API 21) trở lên, hệ thống không cung cấp các nút điều khiển truyền tải trên màn hình khoá. Thay vào đó, bạn nên sử dụng thông báo MediaStyle để hiển thị các nút điều khiển truyền tải.
Thêm thao tác tuỳ chỉnh
Ứng dụng đa phương tiện có thể xác định các thao tác tuỳ chỉnh; ví dụ: thích, không thích hoặc tua lại 30 giây. Thao tác tuỳ chỉnh phải triển khai hành vi hoàn toàn mới. Không sử dụng thao tác tuỳ chỉnh để thay thế một trong các thao tác điều khiển truyền tải tiêu chuẩn được xác định trong PlaybackStateCompat.
Thêm thao tác tuỳ chỉnh bằng addCustomAction(). Ví dụ sau đây cho thấy
cách thêm một nút điều khiển cho hành động thích:
Kotlin
stateBuilder.addCustomAction(
PlaybackStateCompat.CustomAction.Builder(
CUSTOM_ACTION_THUMBS_UP,
resources.getString(R.string.thumbs_up),
thumbsUpIcon
).run {
setExtras(customActionExtras)
build()
}
)
Java
stateBuilder.addCustomAction(new PlaybackStateCompat.CustomAction.Builder(
CUSTOM_ACTION_THUMBS_UP, resources.getString(R.string.thumbs_up), thumbsUpIcon)
.setExtras(customActionExtras)
.build());
Hãy xem Universal Music Player để biết ví dụ hoàn chỉnh.
Bạn phản hồi hành động bằng onCustomAction().
Kotlin
override fun onCustomAction(action: String, extras: Bundle?) {
when(action) {
CUSTOM_ACTION_THUMBS_UP -> {
...
}
}
}
Java
@Override
public void onCustomAction(@NonNull String action, Bundle extras) {
if (CUSTOM_ACTION_THUMBS_UP.equals(action)) {
...
}
}
Hãy xem thêm Trình phát nhạc chung.
Lệnh gọi lại phiên đa phương tiện
Các phương thức gọi lại phiên đa phương tiện chính là onPlay(), onPause() và onStop(). Đây là nơi bạn thêm mã điều khiển trình phát.
Vì bạn tạo thực thể và đặt lệnh gọi lại của phiên trong thời gian chạy (trong onCreate()), nên ứng dụng của bạn có thể xác định các lệnh gọi lại thay thế sử dụng nhiều trình phát và chọn tổ hợp lệnh gọi lại và trình phát phù hợp tuỳ thuộc vào thiết bị và cấp hệ thống. Bạn có thể thay đổi trình phát mà không cần thay đổi phần còn lại của ứng dụng. Ví dụ: bạn có thể sử dụng ExoPlayer khi chạy trên Android 4.1 (cấp độ API 16) trở lên và sử dụng MediaPlayer trên các hệ thống cũ hơn.
Bên cạnh việc kiểm soát trình phát và quản lý quá trình chuyển đổi trạng thái của phiên phát nội dung nghe nhìn, các lệnh gọi lại cũng bật và tắt các tính năng của ứng dụng, đồng thời kiểm soát cách ứng dụng tương tác với các ứng dụng khác và phần cứng của thiết bị. (Xem phần Kiểm soát đầu ra âm thanh).
Việc triển khai các phương thức gọi lại phiên phát nội dung nghe nhìn phụ thuộc vào cấu trúc của ứng dụng. Hãy xem các trang riêng biệt mô tả cách sử dụng lệnh gọi lại trong ứng dụng âm thanh và ứng dụng video, mô tả cách triển khai lệnh gọi lại cho từng loại ứng dụng.