Để sử dụng khung MediaRouter trong ứng dụng, bạn phải lấy một thực thể của đối tượng MediaRouter và đính kèm đối tượng MediaRouter.Callback để theo dõi các sự kiện định tuyến.
Nội dung được gửi qua một tuyến nội dung nghe nhìn sẽ đi qua MediaRouteProvider được liên kết của tuyến đó (ngoại trừ một số trường hợp đặc biệt, chẳng hạn như thiết bị đầu ra Bluetooth). Hình 1 cung cấp thông tin tổng quan về các lớp dùng để định tuyến nội dung giữa các thiết bị.
Hình 1. Tổng quan về các lớp bộ định tuyến nội dung nghe nhìn chính mà ứng dụng sử dụng.
Lưu ý: Nếu muốn ứng dụng của mình hỗ trợ các thiết bị Google Cast, bạn nên sử dụng Cast SDK và xây dựng ứng dụng dưới dạng một trình gửi Cast. Làm theo hướng dẫn trong tài liệu về Cast thay vì sử dụng trực tiếp khung MediaRouter.
Nút định tuyến nội dung nghe nhìn
Ứng dụng Android nên sử dụng nút tuyến nội dung nghe nhìn để kiểm soát việc định tuyến nội dung nghe nhìn. Khung MediaRouter cung cấp một giao diện chuẩn cho nút, giúp người dùng nhận ra và sử dụng tính năng định tuyến khi có sẵn. Nút tuyến nội dung nghe nhìn thường được đặt ở bên phải thanh thao tác của ứng dụng, như trong Hình 2.
Hình 2. Nút định tuyến nội dung nghe nhìn trong thanh thao tác.
Khi người dùng nhấn vào nút tuyến nội dung nghe nhìn, các tuyến nội dung nghe nhìn hiện có sẽ xuất hiện trong danh sách như trong hình 3.
Hình 3. Danh sách các tuyến nội dung nghe nhìn có sẵn, xuất hiện sau khi nhấn nút tuyến nội dung nghe nhìn.
Hãy làm theo các bước sau để tạo nút tuyến nội dung nghe nhìn:
- Sử dụng AppCompatActivity
- Xác định mục trong trình đơn của nút tuyến nội dung nghe nhìn
- Tạo MediaRouteSelector
- Thêm nút tuyến nội dung nghe nhìn vào thanh thao tác
- Tạo và quản lý các phương thức MediaRouter.Callback trong vòng đời hoạt động của bạn
Phần này mô tả 4 bước đầu tiên. Phần tiếp theo mô tả các phương thức gọi lại.
Sử dụng AppCompatActivity
Khi sử dụng khung bộ định tuyến nội dung nghe nhìn trong một hoạt động, bạn nên mở rộng hoạt động từ AppCompatActivity và nhập gói androidx.appcompat.app. Bạn phải thêm các thư viện hỗ trợ androidx.appcompat:appcompat và androidx.mediarouter:mediarouter vào dự án phát triển ứng dụng của mình. Để biết thêm thông tin về cách thêm thư viện hỗ trợ vào dự án, hãy xem phần Làm quen với Android Jetpack.
Thận trọng: Hãy nhớ sử dụng cách triển khai androidx của khung trình định tuyến nội dung nghe nhìn. Đừng sử dụng gói android.media cũ.
Xác định mục trong trình đơn của nút tuyến nội dung nghe nhìn
Tạo một tệp xml xác định mục trong trình đơn cho nút tuyến nội dung nghe nhìn.
Hành động của mục phải là lớp MediaRouteActionProvider.
Sau đây là tệp ví dụ:
<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:actionProviderClass="androidx.mediarouter.app.MediaRouteActionProvider" app:showAsAction="always" /> </menu>
Tạo MediaRouteSelector
Các tuyến xuất hiện trong trình đơn nút tuyến nội dung nghe nhìn được xác định bằng MediaRouteSelector.
Mở rộng hoạt động của bạn từ AppCompatActivity và tạo bộ chọn khi hoạt động được tạo bằng cách gọi MediaRouteSelector.Builder từ phương thức onCreate() như trong mã mẫu sau. Xin lưu ý rằng bộ chọn được lưu trong một biến lớp và các loại tuyến được phép được chỉ định bằng cách thêm các đối tượng MediaControlIntent:
class MediaRouterPlaybackActivity : AppCompatActivity() { private var mSelector: MediaRouteSelector? = null override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Create a route selector for the type of routes your app supports. mSelector = MediaRouteSelector.Builder() // These are the framework-supported intents. .addControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK) .build() } }
Đối với hầu hết các ứng dụng, loại tuyến duy nhất cần thiết là CATEGORY_REMOTE_PLAYBACK. Loại tuyến này coi thiết bị chạy ứng dụng của bạn là một điều khiển từ xa.
Thiết bị nhận được kết nối sẽ xử lý tất cả việc truy xuất, giải mã và phát dữ liệu nội dung.
Đây là cách hoạt động của các ứng dụng hỗ trợ Google Cast, chẳng hạn như Chromecast.
Một số nhà sản xuất hỗ trợ một tuỳ chọn định tuyến đặc biệt có tên là "đầu ra phụ". Với định tuyến này, ứng dụng đa phương tiện của bạn sẽ truy xuất, kết xuất và truyền trực tuyến video hoặc nhạc trực tiếp đến màn hình và/hoặc loa trên thiết bị nhận từ xa đã chọn.
Sử dụng đầu ra phụ để gửi nội dung đến hệ thống âm nhạc hoặc màn hình video có hỗ trợ kết nối không dây. Để bật tính năng khám phá và lựa chọn các thiết bị này, bạn cần thêm danh mục điều khiển CATEGORY_LIVE_AUDIO hoặc CATEGORY_LIVE_VIDEO vào MediaRouteSelector. Bạn cũng cần tạo và xử lý hộp thoại Presentation của riêng mình.
Thêm nút tuyến nội dung nghe nhìn vào thanh thao tác
Sau khi xác định trình đơn tuyến nội dung nghe nhìn và MediaRouteSelector, giờ đây, bạn có thể thêm nút tuyến nội dung nghe nhìn vào một hoạt động.
Ghi đè phương thức onCreateOptionsMenu() cho mỗi hoạt động để thêm trình đơn tuỳ chọn.
override fun onCreateOptionsMenu(menu: Menu): Boolean { super.onCreateOptionsMenu(menu) // Inflate the menu and configure the media router action provider. menuInflater.inflate(R.menu.sample_media_router_menu, menu) // Attach the MediaRouteSelector to the menu item. val mediaRouteMenuItem = menu.findItem(R.id.media_route_menu_item) val mediaRouteActionProvider = MenuItemCompat.getActionProvider(mediaRouteMenuItem) as MediaRouteActionProvider // Attach the MediaRouteSelector that you built in onCreate(). selector?.also(mediaRouteActionProvider::setRouteSelector) // Return true to show the menu. return true }
Để biết thêm thông tin về cách triển khai thanh thao tác trong ứng dụng, hãy xem hướng dẫn Thanh thao tác dành cho nhà phát triển.
Bạn cũng có thể thêm nút tuyến nội dung nghe nhìn dưới dạng MediaRouteButton trong bất kỳ chế độ xem nào. Bạn phải đính kèm MediaRouteSelector vào nút bằng phương thức setRouteSelector(). Hãy xem Danh sách kiểm tra thiết kế Google Cast để biết các nguyên tắc về cách kết hợp nút tuyến nội dung nghe nhìn vào ứng dụng của bạn.
Lệnh gọi lại MediaRouter
Tất cả ứng dụng chạy trên cùng một thiết bị đều dùng chung một thực thể MediaRouter và các tuyến của thực thể đó (được lọc theo từng ứng dụng bằng MediaRouteSelector của ứng dụng). Mỗi hoạt động giao tiếp với MediaRouter bằng cách sử dụng phương thức triển khai riêng của các phương thức MediaRouter.Callback. MediaRouter gọi các phương thức gọi lại bất cứ khi nào người dùng chọn, thay đổi hoặc ngắt kết nối một tuyến.
Có một số phương thức trong lệnh gọi lại mà bạn có thể ghi đè để nhận thông tin về các sự kiện định tuyến. Ở mức tối thiểu, việc triển khai lớp MediaRouter.Callback của bạn phải ghi đè onRouteSelected() và onRouteUnselected().
Vì MediaRouter là tài nguyên dùng chung, nên ứng dụng của bạn cần quản lý các lệnh gọi lại MediaRouter để phản hồi các lệnh gọi lại thông thường trong vòng đời hoạt động:
- Khi hoạt động được tạo (
onCreate(Bundle)), hãy lấy con trỏ đếnMediaRoutervà giữ con trỏ đó trong suốt thời gian hoạt động của ứng dụng. - Đính kèm lệnh gọi lại vào MediaRouter khi hoạt động hiển thị (
onStart()) và tách chúng khi hoạt động bị ẩn (onStop()).
Mã mẫu sau đây minh hoạ cách tạo và lưu đối tượng gọi lại, cách lấy một thực thể của MediaRouter và cách quản lý lệnh gọi lại.
Lưu ý việc sử dụng cờ CALLBACK_FLAG_REQUEST_DISCOVERY khi đính kèm lệnh gọi lại trong onStart().
Thao tác này cho phép MediaRouteSelector làm mới danh sách các tuyến có sẵn của nút tuyến nội dung nghe nhìn.
class MediaRouterPlaybackActivity : AppCompatActivity() { private var mediaRouter: MediaRouter? = null private var mSelector: MediaRouteSelector? = null // Variables to hold the currently selected route and its playback client. private var mRoute: MediaRouter.RouteInfo? = null private var remotePlaybackClient: RemotePlaybackClient? = null // Define the Callback object and its methods, save the object in a class variable. private val mediaRouterCallback = object : MediaRouter.Callback() { override fun onRouteSelected( router: MediaRouter, route: MediaRouter.RouteInfo, reason: Int ) { Log.d(TAG, "onRouteSelected: route=$route") if (route.supportsControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) { // Stop local playback (if necessary). // ... // Save the new route. mRoute = route // Attach a new playback client. remotePlaybackClient = RemotePlaybackClient(this@MediaRouterPlaybackActivity, route) // Start remote playback (if necessary). // ... } } override fun onRouteUnselected( router: MediaRouter, route: MediaRouter.RouteInfo, reason: Int ) { Log.d(TAG, "onRouteUnselected: route=$route") if (route.supportsControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) { // Changed route: tear down previous client. mRoute?.also { remotePlaybackClient?.release() remotePlaybackClient = null } // Save the new route. mRoute = route when { reason != MediaRouter.UNSELECT_REASON_ROUTE_CHANGED -> { // Resume local playback (if necessary). // ... } } } } } // Retain a pointer to the MediaRouter. override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Get the media router service. mediaRouter = MediaRouter.getInstance(this) // ... } // Use this callback to run your MediaRouteSelector to generate the // list of available media routes. override fun onStart() { mSelector?.also { selector -> mediaRouter?.addCallback( selector, mediaRouterCallback, MediaRouter.CALLBACK_FLAG_REQUEST_DISCOVERY ) } super.onStart() } // Remove the selector on stop to tell the media router that it no longer // needs to discover routes for your app. override fun onStop() { mediaRouter?.removeCallback(mediaRouterCallback) super.onStop() } // ... }
Khung trình định tuyến nội dung nghe nhìn cũng cung cấp một lớp MediaRouteDiscoveryFragment, đảm nhận việc thêm và xoá lệnh gọi lại cho một hoạt động.
Lưu ý: Nếu đang viết một ứng dụng phát nhạc và muốn ứng dụng phát nhạc trong khi chạy ở chế độ nền, bạn phải tạo một Service để phát và gọi khung trình định tuyến nội dung nghe nhìn từ phương thức gọi lại trong vòng đời của Dịch vụ.
Kiểm soát tuyến phát từ xa
Khi bạn chọn một tuyến phát từ xa, ứng dụng của bạn sẽ hoạt động như một điều khiển từ xa. Thiết bị ở đầu kia của tuyến xử lý tất cả các chức năng truy xuất, giải mã và phát lại dữ liệu nội dung. Các chế độ điều khiển trong giao diện người dùng của ứng dụng sẽ giao tiếp với thiết bị nhận bằng đối tượng RemotePlaybackClient.
Lớp RemotePlaybackClient cung cấp các phương thức bổ sung để quản lý việc phát nội dung. Sau đây là một số phương thức phát chính trong lớp RemotePlaybackClient:
play()— Phát một tệp nội dung nghe nhìn cụ thể, được chỉ định bằngUri.pause()— Tạm dừng bản nhạc đang phát.resume()— Tiếp tục phát bản nhạc hiện tại sau lệnh tạm dừng.seek()— Di chuyển đến một vị trí cụ thể trong bản nhạc hiện tại.release()— Huỷ kết nối giữa ứng dụng của bạn và thiết bị phát từ xa.
Bạn có thể sử dụng các phương thức này để đính kèm hành động vào bộ điều khiển chế độ phát mà bạn cung cấp trong ứng dụng. Hầu hết các phương thức này cũng cho phép bạn thêm một đối tượng gọi lại để có thể theo dõi tiến trình của tác vụ phát hoặc yêu cầu điều khiển.
Lớp RemotePlaybackClient cũng hỗ trợ việc đưa nhiều mục nội dung nghe nhìn vào hàng đợi để phát và quản lý hàng đợi nội dung nghe nhìn.
Mã mẫu
Các mẫu Android BasicMediaRouter và MediaRouter minh hoạ thêm về cách sử dụng API MediaRouter.