Tổng quan về MediaRouteProvider

Khung trình định tuyến nội dung nghe nhìn của Android cho phép nhà sản xuất bật tính năng phát trên thiết bị của họ thông qua một giao diện chuẩn hoá có tên là MediaRouteProvider. Nhà cung cấp tuyến xác định một giao diện chung để phát nội dung nghe nhìn trên thiết bị nhận, giúp bạn có thể phát nội dung nghe nhìn trên thiết bị của mình từ bất kỳ ứng dụng Android nào hỗ trợ tuyến nội dung nghe nhìn.

Hướng dẫn này trình bày cách tạo một trình cung cấp tuyến nội dung nghe nhìn cho thiết bị nhận và cung cấp trình cung cấp đó cho các ứng dụng phát nội dung nghe nhìn khác chạy trên Android. Để sử dụng API này, bạn nên làm quen với các lớp chính MediaRouteProvider, MediaRouteProviderDescriptor và RouteController.

Tổng quan

Khung bộ định tuyến nội dung nghe nhìn của Android cho phép nhà phát triển ứng dụng đa phương tiện và nhà sản xuất thiết bị phát nội dung nghe nhìn kết nối thông qua một API chung và giao diện người dùng chung. Sau đó, nhà phát triển ứng dụng triển khai giao diện MediaRouter có thể kết nối với khung và phát nội dung đến các thiết bị tham gia vào khung bộ định tuyến nội dung nghe nhìn. Nhà sản xuất thiết bị phát nội dung nghe nhìn có thể tham gia vào khung này bằng cách phát hành một MediaRouteProvider cho phép các ứng dụng khác kết nối và phát nội dung nghe nhìn trên thiết bị nhận. Hình 1 minh hoạ cách một ứng dụng kết nối với thiết bị nhận thông qua khung trình định tuyến nội dung nghe nhìn.

Hình 1. Thông tin tổng quan về cách các lớp của trình cung cấp tuyến nội dung nghe nhìn cung cấp hoạt động giao tiếp từ một ứng dụng đa phương tiện đến một thiết bị nhận.

Khi bạn xây dựng một trình cung cấp tuyến nội dung nghe nhìn cho thiết bị nhận, trình cung cấp này sẽ phục vụ các mục đích sau:

  • Mô tả và phát hành các chức năng của thiết bị nhận để các ứng dụng khác có thể khám phá và sử dụng các tính năng phát của thiết bị đó.
  • Gói giao diện lập trình của thiết bị nhận và cơ chế truyền tải giao tiếp của thiết bị đó để giúp thiết bị tương thích với khung bộ định tuyến nội dung nghe nhìn.

Phân phối nhà cung cấp tuyến đường

Nhà cung cấp tuyến nội dung nghe nhìn được phân phối dưới dạng một phần của ứng dụng Android. Bạn có thể cung cấp nhà cung cấp tuyến cho các ứng dụng khác bằng cách mở rộng MediaRouteProviderService hoặc gói việc triển khai MediaRouteProvider bằng dịch vụ của riêng bạn và khai báo bộ lọc ý định cho nhà cung cấp tuyến nội dung nghe nhìn. Các bước này cho phép các ứng dụng khác khám phá và sử dụng tuyến nội dung nghe nhìn của bạn.

Lưu ý: Ứng dụng chứa trình cung cấp tuyến nội dung nghe nhìn cũng có thể bao gồm giao diện MediaRouter cho trình cung cấp tuyến, nhưng không bắt buộc.

Thư viện hỗ trợ MediaRouter

Các API bộ định tuyến nội dung nghe nhìn được xác định trong thư viện AndroidX MediaRouter. Bạn phải thêm thư viện này 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 Thiết lập thư viện hỗ trợ.

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ũ.

Tạo dịch vụ của nhà cung cấp

Khung trình định tuyến nội dung nghe nhìn phải có thể khám phá và kết nối với trình cung cấp tuyến nội dung nghe nhìn của bạn để cho phép các ứng dụng khác sử dụng tuyến của bạn. Để làm việc này, khung trình định tuyến nội dung nghe nhìn sẽ tìm các ứng dụng khai báo một hành động theo ý định của nhà cung cấp tuyến nội dung nghe nhìn. Khi một ứng dụng khác muốn kết nối với nhà cung cấp của bạn, khung phải có thể gọi và kết nối với nhà cung cấp đó, vì vậy, nhà cung cấp của bạn phải được đóng gói trong một Service.

Mã ví dụ sau đây cho thấy nội dung khai báo dịch vụ của nhà cung cấp tuyến nội dung nghe nhìn và bộ lọc ý định trong tệp kê khai, cho phép khung trình định tuyến nội dung nghe nhìn khám phá và sử dụng:

<service android:name=".provider.SampleMediaRouteProviderService"
    android:label="@string/sample_media_route_provider_service"
    android:process=":mrp">
    <intent-filter>
        <action android:name="android.media.MediaRouteProviderService" />
    </intent-filter>
</service>

Ví dụ về tệp kê khai này khai báo một dịch vụ bao bọc các lớp trình cung cấp tuyến nội dung nghe nhìn thực tế. Khung trình định tuyến nội dung nghe nhìn của Android cung cấp lớp MediaRouteProviderService để dùng làm trình bao bọc dịch vụ cho các nhà cung cấp tuyến nội dung nghe nhìn. Mã ví dụ sau đây minh hoạ cách sử dụng lớp trình bao bọc này:

class SampleMediaRouteProviderService : MediaRouteProviderService() {

    override fun onCreateMediaRouteProvider(): MediaRouteProvider {
        return SampleMediaRouteProvider(this)
    }
}

Chỉ định chức năng của tuyến đường

Các ứng dụng kết nối với khung trình định tuyến nội dung nghe nhìn có thể khám phá tuyến nội dung nghe nhìn của bạn thông qua nội dung khai báo trong tệp kê khai của ứng dụng, nhưng các ứng dụng đó cũng cần biết các chức năng của tuyến nội dung nghe nhìn mà bạn đang cung cấp. Tuyến nội dung nghe nhìn có thể thuộc nhiều loại và có nhiều tính năng, đồng thời các ứng dụng khác cần có khả năng khám phá những thông tin chi tiết này để xác định xem chúng có tương thích với tuyến của bạn hay không.

Khung trình định tuyến nội dung nghe nhìn cho phép bạn xác định và xuất bản các chức năng của tuyến nội dung nghe nhìn thông qua các đối tượng IntentFilter, đối tượng MediaRouteDescriptor và MediaRouteProviderDescriptor. Phần này giải thích cách sử dụng các lớp này để xuất bản thông tin chi tiết về tuyến nội dung nghe nhìn cho các ứng dụng khác.

Danh mục tuyến đường

Trong phần mô tả có lập trình của nhà cung cấp tuyến nội dung nghe nhìn, bạn phải chỉ định xem nhà cung cấp có hỗ trợ tính năng phát từ xa, đầu ra phụ hay cả hai hay không. Sau đây là các danh mục tuyến do khung trình định tuyến nội dung nghe nhìn cung cấp:

  • CATEGORY_LIVE_AUDIO — Đầu ra âm thanh cho thiết bị đầu ra phụ, chẳng hạn như hệ thống âm nhạc hỗ trợ không dây.
  • CATEGORY_LIVE_VIDEO — Đầu ra của video cho thiết bị đầu ra phụ, chẳng hạn như thiết bị hiển thị không dây.
  • CATEGORY_REMOTE_PLAYBACK — Phát video hoặc âm thanh trên một thiết bị riêng biệt xử lý việc truy xuất, giải mã và phát nội dung nghe nhìn, chẳng hạn như thiết bị Chromecast.

Để đưa các chế độ cài đặt này vào nội dung mô tả tuyến nội dung nghe nhìn, bạn hãy chèn các chế độ cài đặt đó vào một đối tượng IntentFilter, sau đó thêm đối tượng này vào một đối tượng MediaRouteDescriptor:

class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) {

    companion object {
        private val CONTROL_FILTERS_BASIC: ArrayList<IntentFilter> = IntentFilter().run {
            addCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)
            arrayListOf(this)
        }
    }
}

Nếu chỉ định ý định CATEGORY_REMOTE_PLAYBACK, bạn cũng phải xác định loại nội dung nghe nhìn và bộ điều khiển chế độ phát mà nhà cung cấp tuyến nội dung nghe nhìn hỗ trợ. Phần tiếp theo mô tả cách chỉ định các chế độ cài đặt này cho thiết bị của bạn.

Loại và giao thức nội dung nghe nhìn

Nhà cung cấp tuyến nội dung nghe nhìn cho thiết bị phát từ xa phải chỉ định các loại nội dung nghe nhìn và giao thức truyền mà nhà cung cấp đó hỗ trợ. Bạn chỉ định các chế độ cài đặt này bằng cách sử dụng lớp IntentFilter cũng như các phương thức addDataScheme() và addDataType() của đối tượng đó. Đoạn mã sau đây minh hoạ cách xác định bộ lọc ý định để hỗ trợ phát video từ xa bằng http, https và Giao thức truyền trực tuyến theo thời gian thực (RTSP):

class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) {

    companion object {

        private fun IntentFilter.addDataTypeUnchecked(type: String) {
            try {
                addDataType(type)
            } catch (ex: IntentFilter.MalformedMimeTypeException) {
                throw RuntimeException(ex)
            }
        }

        private val CONTROL_FILTERS_BASIC: ArrayList<IntentFilter> = IntentFilter().run {
            addCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)
            addAction(MediaControlIntent.ACTION_PLAY)
            addDataScheme("http")
            addDataScheme("https")
            addDataScheme("rtsp")
            addDataTypeUnchecked("video/*")
            arrayListOf(this)
        }
    }
    // ...
}

Bộ điều khiển chế độ phát

Nhà cung cấp tuyến nội dung nghe nhìn cung cấp tính năng phát từ xa phải chỉ định các loại nút điều khiển nội dung nghe nhìn mà nhà cung cấp đó hỗ trợ. Sau đây là các loại điều khiển chung mà tuyến nội dung nghe nhìn có thể cung cấp:

  • Bộ điều khiển chế độ phát, chẳng hạn như phát, tạm dừng, tua lại và tua đi.
  • Tính năng thêm vào hàng đợi, cho phép ứng dụng gửi thêm và xoá các mục khỏi danh sách phát do thiết bị nhận duy trì.
  • Tính năng phiên, giúp ngăn các ứng dụng gửi can thiệp lẫn nhau bằng cách yêu cầu thiết bị nhận cung cấp mã phiên cho ứng dụng yêu cầu, sau đó kiểm tra mã đó với mỗi yêu cầu điều khiển chế độ phát tiếp theo.

Ví dụ về mã sau đây minh hoạ cách tạo bộ lọc ý định để hỗ trợ bộ điều khiển chế độ phát tuyến đường nội dung nghe nhìn cơ bản:

class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) {

    companion object {
        // ...
        private val CONTROL_FILTERS_BASIC: ArrayList<IntentFilter> = run {
            val videoPlayback: IntentFilter = ...
            // ...
            val playControls = IntentFilter().apply {
                addCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)
                addAction(MediaControlIntent.ACTION_SEEK)
                addAction(MediaControlIntent.ACTION_GET_STATUS)
                addAction(MediaControlIntent.ACTION_PAUSE)
                addAction(MediaControlIntent.ACTION_RESUME)
                addAction(MediaControlIntent.ACTION_STOP)
            }
            arrayListOf(videoPlayback, playControls)
        }
    }
    // ...
}

Để biết thêm thông tin về các ý định điều khiển chế độ phát hiện có, hãy xem lớp MediaControlIntent.

MediaRouteProviderDescriptor

Sau khi xác định các chức năng của tuyến nội dung nghe nhìn bằng đối tượng IntentFilter, bạn có thể tạo một đối tượng mô tả để phát hành lên khung trình định tuyến nội dung nghe nhìn của Android. Đối tượng mô tả này chứa thông tin cụ thể về các chức năng của tuyến nội dung nghe nhìn để các ứng dụng khác có thể xác định cách tương tác với tuyến nội dung nghe nhìn của bạn.

Mã ví dụ sau đây minh hoạ cách thêm các bộ lọc ý định đã tạo trước đó vào MediaRouteProviderDescriptor và đặt chỉ số mô tả để khung trình định tuyến nội dung nghe nhìn sử dụng:

class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) {

    init {
        publishRoutes()
    }

    private fun publishRoutes() {
        val resources = context.resources
        val routeName: String = resources.getString(R.string.variable_volume_basic_route_name)
        val routeDescription: String = resources.getString(R.string.sample_route_description)
        // Create a route descriptor using previously created IntentFilters.
        val routeDescriptor: MediaRouteDescriptor =
            MediaRouteDescriptor.Builder(VARIABLE_VOLUME_BASIC_ROUTE_ID, routeName)
                .setDescription(routeDescription)
                .addControlFilters(CONTROL_FILTERS_BASIC)
                .setPlaybackStream(AudioManager.STREAM_MUSIC)
                .setPlaybackType(MediaRouter.RouteInfo.PLAYBACK_TYPE_REMOTE)
                .setVolumeHandling(MediaRouter.RouteInfo.PLAYBACK_VOLUME_VARIABLE)
                .setVolumeMax(VOLUME_MAX)
                .setVolume(mVolume)
                .build()
        // Add the route descriptor to the provider descriptor.
        val providerDescriptor: MediaRouteProviderDescriptor =
            MediaRouteProviderDescriptor.Builder()
                .addRoute(routeDescriptor)
                .build()

        // Publish the descriptor to the framework.
        descriptor = providerDescriptor
    }
    // ...
}

Để biết thêm thông tin về các chế độ cài đặt mô tả có sẵn, hãy xem tài liệu tham khảo về MediaRouteDescriptor và MediaRouteProviderDescriptor.

Kiểm soát tuyến đường

Khi một ứng dụng kết nối với trình cung cấp tuyến nội dung nghe nhìn, trình cung cấp đó sẽ nhận được các lệnh phát thông qua khung trình định tuyến nội dung nghe nhìn được các ứng dụng khác gửi đến tuyến của bạn. Để xử lý các yêu cầu này, bạn phải cung cấp một phương thức triển khai lớp MediaRouteProvider.RouteController. Lớp này sẽ xử lý các lệnh và xử lý hoạt động giao tiếp thực tế với thiết bị nhận.

Khung trình định tuyến nội dung nghe nhìn gọi phương thức onCreateRouteController() của trình cung cấp tuyến để lấy một thực thể của lớp này, sau đó định tuyến các yêu cầu đến thực thể đó. Sau đây là các phương thức chính của lớp MediaRouteProvider.RouteController mà bạn phải triển khai cho nhà cung cấp tuyến nội dung nghe nhìn:

  • onSelect() – Được gọi khi một ứng dụng chọn tuyến của bạn để phát. Bạn sử dụng phương thức này để thực hiện bất kỳ công việc chuẩn bị nào có thể cần thiết trước khi bắt đầu phát nội dung nghe nhìn.
  • onControlRequest() — Gửi các lệnh phát cụ thể đến thiết bị nhận.
  • onSetVolume() — Gửi yêu cầu đến thiết bị nhận để đặt âm lượng phát thành một giá trị cụ thể.
  • onUpdateVolume() — Gửi yêu cầu đến thiết bị nhận để sửa đổi âm lượng phát theo một mức cụ thể.
  • onUnselect() — Được gọi khi một ứng dụng bỏ chọn một tuyến.
  • onRelease() — Được gọi khi khung không còn cần đến tuyến đường, cho phép khung giải phóng tài nguyên.

Tất cả yêu cầu điều khiển chế độ phát, ngoại trừ thay đổi âm lượng, đều được chuyển đến phương thức onControlRequest(). Cách triển khai phương thức này phải phân tích cú pháp các yêu cầu điều khiển và phản hồi chúng một cách thích hợp. Dưới đây là ví dụ về cách triển khai phương thức này để xử lý các lệnh cho một tuyến nội dung nghe nhìn phát từ xa:

private class SampleRouteController : MediaRouteProvider.RouteController() {
    // ...

    override fun onControlRequest(
        intent: Intent,
        callback: MediaRouter.ControlRequestCallback?
    ): Boolean {
        return if (intent.hasCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) {
            val action = intent.action
            when (action) {
                MediaControlIntent.ACTION_PLAY -> handlePlay(intent, callback)
                MediaControlIntent.ACTION_ENQUEUE -> handleEnqueue(intent, callback)
                MediaControlIntent.ACTION_REMOVE -> handleRemove(intent, callback)
                MediaControlIntent.ACTION_SEEK -> handleSeek(intent, callback)
                MediaControlIntent.ACTION_GET_STATUS -> handleGetStatus(intent, callback)
                MediaControlIntent.ACTION_PAUSE -> handlePause(intent, callback)
                MediaControlIntent.ACTION_RESUME -> handleResume(intent, callback)
                MediaControlIntent.ACTION_STOP -> handleStop(intent, callback)
                MediaControlIntent.ACTION_START_SESSION -> handleStartSession(intent, callback)
                MediaControlIntent.ACTION_GET_SESSION_STATUS ->
                    handleGetSessionStatus(intent, callback)
                MediaControlIntent.ACTION_END_SESSION -> handleEndSession(intent, callback)
                else -> false
            }.also {
                Log.d(TAG, sessionManager.toString())
            }
        } else {
            false
        }
    }
    // ...
}

Bạn cần hiểu rằng lớp MediaRouteProvider.RouteController được dùng làm trình bao bọc cho API cho thiết bị phát nội dung nghe nhìn của bạn. Việc triển khai các phương thức trong lớp này hoàn toàn phụ thuộc vào giao diện lập trình do thiết bị nhận cung cấp.

Mã mẫu

Mẫu MediaRouter cho biết cách tạo một trình cung cấp tuyến nội dung nghe nhìn tuỳ chỉnh.