CastPlayer là một phương thức triển khai Player của Jetpack Media3, hỗ trợ cả tính năng phát trên thiết bị và truyền tới một thiết bị từ xa có hỗ trợ Cast. CastPlayer đơn giản hoá việc thêm chức năng truyền vào ứng dụng và cung cấp các tính năng phong phú để chuyển đổi liền mạch giữa chế độ phát trên thiết bị và chế độ phát từ xa. Hướng dẫn này trình bày cách tích hợp CastPlayer vào ứng dụng đa phương tiện của bạn.
Để tích hợp Cast với các nền tảng khác, hãy xem Cast SDK.
Mua một thiết bị hỗ trợ Cast
Để kiểm thử CastPlayer, bạn cần có một thiết bị hỗ trợ Cast. Các lựa chọn bao gồm Android TV, Chromecast, loa thông minh và màn hình thông minh. Xác minh rằng thiết bị của bạn đã được thiết lập và kết nối với cùng một mạng Wi-Fi như thiết bị di động phát triển để khám phá.
Thêm phần phụ thuộc của bản dựng
Để bắt đầu sử dụng CastPlayer, hãy thêm các phần phụ thuộc AndroidX Media3 và CastPlayer vào tệp build.gradle của mô-đun ứng dụng.
Kotlin
implementation("androidx.media3:media3-exoplayer:1.11.1")
implementation("androidx.media3:media3-ui:1.11.1")
implementation("androidx.media3:media3-session:1.11.1")
implementation("androidx.media3:media3-cast:1.11.1")
Groovy
implementation "androidx.media3:media3-exoplayer:1.11.1"
implementation "androidx.media3:media3-ui:1.11.1"
implementation "androidx.media3:media3-session:1.11.1"
implementation "androidx.media3:media3-cast:1.11.1"
Định cấu hình CastPlayer
Để định cấu hình CastPlayer, hãy cập nhật tệp AndroidManifest.xml bằng một nhà cung cấp tuỳ chọn.
Nhà cung cấp lựa chọn
CastPlayer yêu cầu một nhà cung cấp tuỳ chọn để định cấu hình hành vi của nó. Để thiết lập cơ bản, bạn có thể sử dụng DefaultCastOptionsProvider bằng cách thêm vào tệp AndroidManifest.xml. Thao tác này sử dụng chế độ cài đặt mặc định, bao gồm cả ứng dụng nhận mặc định.
<application>
...
<meta-data
android:name="com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
android:value="androidx.media3.cast.DefaultCastOptionsProvider" />
...
</application>
Để tuỳ chỉnh cấu hình, hãy triển khai OptionsProvider tuỳ chỉnh của riêng bạn. Hãy xem hướng dẫn về CastOptions để tìm hiểu cách thực hiện.
Thêm trình nhận để chuyển nội dung nghe nhìn
Việc thêm MediaTransferReceiver vào tệp kê khai cho phép Giao diện người dùng hệ thống khám phá các thiết bị hỗ trợ Cast trên mạng và định tuyến lại nội dung nghe nhìn mà không cần mở hoạt động của ứng dụng. Ví dụ: người dùng có thể thay đổi thiết bị phát nội dung nghe nhìn của ứng dụng từ thông báo nội dung nghe nhìn.
<application>
...
<receiver android:name="androidx.mediarouter.media.MediaTransferReceiver" />
...
</application>
Tạo CastPlayer
Để phát từ xa bằng tính năng Truyền, ứng dụng của bạn phải có thể quản lý hoạt động phát ngay cả khi người dùng không tương tác với một Hoạt động trong ứng dụng, chẳng hạn như thông qua thông báo về nội dung nghe nhìn của hệ thống. Vì lý do này, bạn nên tạo các thực thể ExoPlayer (để phát trên thiết bị) và CastPlayer (để phát từ xa) trong một dịch vụ, chẳng hạn như MediaSessionService hoặc MediaLibraryService.
Trước tiên, hãy tạo thực thể ExoPlayer, sau đó khi tạo thực thể CastPlayer, hãy đặt ExoPlayer làm thực thể trình phát cục bộ. Sau đó, bạn có thể chuyển đổi chế độ phát nội dung nghe nhìn giữa thiết bị di động và thiết bị hỗ trợ Cast từ thông báo nội dung nghe nhìn hoặc thông báo trên màn hình khoá. Media3 sử dụng tính năng Trình chuyển đổi đầu ra để xử lý việc chuyển trình phát khi tuyến đầu ra thay đổi từ cục bộ sang từ xa hoặc từ xa sang cục bộ.
Kotlin
override fun onCreate() { super.onCreate() val exoPlayer = ExoPlayer.Builder(context).build() val castPlayer = CastPlayer.Builder(context).setLocalPlayer(exoPlayer).build() mediaSession = MediaSession.Builder(context, castPlayer).build() }
Java
@Override public void onCreate() { super.onCreate(); ExoPlayer exoPlayer = new ExoPlayer.Builder(context).build(); CastPlayer castPlayer = new CastPlayer.Builder(context).setLocalPlayer(exoPlayer).build(); mediaSession = new MediaSession.Builder(/* context= */ context, /* player= */ castPlayer).build(); }
Thêm các phần tử trên giao diện người dùng
Thêm MediaRouteButton vào giao diện người dùng của ứng dụng. Khi nhấn vào biểu tượng MediaRouteButton, một hộp thoại sẽ mở ra và hiển thị danh sách các thiết bị hỗ trợ Cast có sẵn trên mạng. Khi người dùng chọn một thiết bị, quá trình phát nội dung nghe nhìn sẽ được chuyển từ
thiết bị di động sang thiết bị nhận đã chọn. Phần này hướng dẫn bạn cách thêm nút và theo dõi các sự kiện để cập nhật giao diện người dùng khi quá trình phát chuyển đổi giữa thiết bị cục bộ và thiết bị từ xa.
Đặt MediaRouteButton
Có 4 cách để thêm MediaRouteButton vào giao diện người dùng của hoạt động. Lựa chọn tốt nhất sẽ phụ thuộc vào thiết kế và yêu cầu của ứng dụng.
- Giao diện người dùng Compose: Thêm một thành phần kết hợp nút.
- Giao diện người dùng của Khung hiển thị:
- Thêm nút vào trình đơn thanh ứng dụng.
- Thêm nút bên trong
PlayerView. - Thêm nút dưới dạng
Viewtiêu chuẩn.
Thêm một thành phần kết hợp MediaRouteButton vào trình phát
Bạn có thể thêm thành phần kết hợp MediaRouteButton vào giao diện người dùng của trình phát. Để biết thêm thông tin, hãy xem hướng dẫn về Compose.
@Composable fun PlayerComposeView(player: Player, modifier: Modifier = Modifier) { var controlsVisible by remember { mutableStateOf(false) } Box( modifier = modifier.clickable { controlsVisible = true }, contentAlignment = Alignment.Center, ) { PlayerSurface(player = player, modifier = modifier) AnimatedVisibility(visible = controlsVisible, enter = fadeIn(), exit = fadeOut()) { Box(modifier = Modifier.fillMaxSize()) { MediaRouteButton(modifier = Modifier.align(Alignment.TopEnd)) PrimaryControls(player = player, modifier = Modifier.align(Alignment.Center)) } } } } @Composable fun PrimaryControls(player: Player, modifier: Modifier = Modifier) { // ... }
Thêm MediaRouteButton vào PlayerView
Bạn có thể thêm MediaRouteButton trực tiếp vào các thành phần điều khiển trên giao diện người dùng của PlayerView. Sau khi đặt MediaController làm trình phát cho PlayerView, hãy cung cấp MediaRouteButtonViewProvider để hiển thị nút Truyền trên Trình phát.
Kotlin
override fun onStart() { super.onStart() playerView.player = mediaController playerView.setMediaRouteButtonViewProvider(MediaRouteButtonViewProvider()) }
Java
@Override public void onStart() { super.onStart(); playerView.setPlayer(mediaController); playerView.setMediaRouteButtonViewProvider(new MediaRouteButtonViewProvider()); }
Thêm MediaRouteButton vào trình đơn thanh ứng dụng
Để thiết lập MediaRouteButton trong trình đơn thanh ứng dụng, hãy tạo một trình đơn XML và ghi đè onCreateOptionsMenu trong Activity.
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item android:id="@+id/media_route_menu_item"
android:title="@string/media_route_menu_title"
app:showAsAction="always"
app:actionProviderClass="androidx.mediarouter.app.MediaRouteActionProvider"/>
</menu>
Kotlin
override fun onCreateOptionsMenu(menu: Menu): Boolean { // ... menuInflater.inflate(R.menu.sample_media_route_button_menu, menu) val menuItemFuture: ListenableFuture<MenuItem> = MediaRouteButtonFactory.setUpMediaRouteButton(context, menu, R.id.media_route_menu_item) Futures.addCallback( menuItemFuture, object : FutureCallback<MenuItem> { override fun onSuccess(menuItem: MenuItem) { // Do something with the menu item. } override fun onFailure(t: Throwable) { // Handle the failure. } }, executor, ) // ... return true }
Java
@Override public boolean onCreateOptionsMenu(Menu menu) { // ... getMenuInflater().inflate(R.menu.sample_media_route_button_menu, menu); ListenableFuture<MenuItem> menuItemFuture = MediaRouteButtonFactory.setUpMediaRouteButton(context, menu, R.id.media_route_menu_item); Futures.addCallback( menuItemFuture, new FutureCallback<MenuItem>() { @Override public void onSuccess(MenuItem menuItem) { // Do something with the menu item. } @Override public void onFailure(Throwable t) { // Handle the failure. } }, executor); // ... return true; }
Thêm MediaRouteButton làm Chế độ xem
Bạn có thể thiết lập MediaRouteButton trong tệp layout.xml của hoạt động.
<androidx.mediarouter.app.MediaRouteButton
android:id="@+id/media_route_button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:mediaRouteButtonTint="@android:color/white" />
Để hoàn tất việc thiết lập cho MediaRouteButton, hãy sử dụng Media3 Cast MediaRouteButtonFactory trong mã Activity.
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) findViewById<MediaRouteButton>(R.id.media_route_button)?.also { val unused = MediaRouteButtonFactory.setUpMediaRouteButton(context, it) } }
Java
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // ... MediaRouteButton button = findViewById(R.id.media_route_button); ListenableFuture<Void> setUpFuture = MediaRouteButtonFactory.setUpMediaRouteButton(context, button); }
Trình theo dõi hoạt động
Tạo Player.Listener trong Activity để theo dõi các thay đổi đối với vị trí phát nội dung nghe nhìn. Khi playbackType thay đổi giữa PLAYBACK_TYPE_LOCAL và PLAYBACK_TYPE_REMOTE, bạn có thể điều chỉnh giao diện người dùng nếu cần. Để ngăn chặn rò rỉ bộ nhớ và giới hạn hoạt động của trình nghe chỉ khi ứng dụng của bạn hiển thị, hãy đăng ký trình nghe trong onStart và huỷ đăng ký trong onStop:
Kotlin
private val playerListener: Player.Listener = object : Player.Listener { override fun onDeviceInfoChanged(deviceInfo: DeviceInfo) { if (deviceInfo.playbackType == DeviceInfo.PLAYBACK_TYPE_LOCAL) { // Add UI changes for local playback. } else if (deviceInfo.playbackType == DeviceInfo.PLAYBACK_TYPE_REMOTE) { // Add UI changes for remote playback. } } } override fun onStart() { super.onStart() mediaController.addListener(playerListener) } override fun onStop() { super.onStop() mediaController.removeListener(playerListener) }
Java
private final Player.Listener playerListener = new Player.Listener() { @Override public void onDeviceInfoChanged(DeviceInfo deviceInfo) { if (deviceInfo.playbackType == DeviceInfo.PLAYBACK_TYPE_LOCAL) { // Add UI changes for local playback. } else if (deviceInfo.playbackType == DeviceInfo.PLAYBACK_TYPE_REMOTE) { // Add UI changes for remote playback. } } }; @Override protected void onStart() { super.onStart(); mediaController.addListener(playerListener); } @Override protected void onStop() { super.onStop(); mediaController.removeListener(playerListener); }
Để biết thêm thông tin về cách nghe và phản hồi các sự kiện phát, hãy xem hướng dẫn về sự kiện của trình phát.