Bật tính năng Truyền cho ứng dụng Android TV

1. Tổng quan

Biểu trưng Google Cast

Lớp học lập trình này sẽ hướng dẫn bạn cách chỉnh sửa một ứng dụng Android TV hiện có để hỗ trợ tính năng truyền và giao tiếp từ các ứng dụng trên thiết bị phát Cast hiện có.

Google Cast và Cast Connect là gì?

Google Cast cho phép người dùng truyền nội dung từ thiết bị di động sang TV. Một phiên Google Cast thông thường bao gồm hai thành phần — một người gửi và một ứng dụng trình nhận. Ứng dụng của người gửi, chẳng hạn như ứng dụng hoặc trang web dành cho thiết bị di động như YouTube.com, khởi chạy và kiểm soát quá trình phát ứng dụng nhận nội dung truyền. Ứng dụng Cast receiver là ứng dụng HTML 5 chạy trên các thiết bị Chromecast và Android TV.

Hầu hết trạng thái trong một phiên truyền đều được lưu trữ trên ứng dụng nhận. Khi trạng thái cập nhật, chẳng hạn như khi một mục nội dung đa phương tiện mới được tải thì trạng thái nội dung đa phương tiện sẽ được thông báo cho tất cả người gửi. Những thông báo này chứa trạng thái hiện tại của phiên Truyền. Ứng dụng gửi sử dụng trạng thái nội dung đa phương tiện này để hiển thị thông tin phát trong giao diện người dùng.

Cast Connect được xây dựng trên cơ sở hạ tầng này, trong đó ứng dụng Android TV hoạt động như một bộ thu. Thư viện Cast Connect cho phép ứng dụng Android TV của bạn nhận thông báo và phát sóng trạng thái nội dung nghe nhìn như thể đó là một ứng dụng nhận nội dung truyền.

Chúng tôi sẽ xây dựng những gì?

Khi đã hoàn thành lớp học lập trình này, bạn sẽ có thể sử dụng ứng dụng người gửi Truyền để truyền video đến ứng dụng Android TV. Ứng dụng Android TV cũng có thể giao tiếp với các ứng dụng của người gửi thông qua giao thức Truyền.

Kiến thức bạn sẽ học được

  • Cách thêm thư viện Cast Connect vào ứng dụng ATV mẫu.
  • Cách kết nối thiết bị phát Cast và chạy ứng dụng ATV.
  • Cách bắt đầu phát nội dung nghe nhìn trên ứng dụng ATV từ ứng dụng thiết bị truyền Cast.
  • Cách gửi trạng thái nội dung nghe nhìn từ ứng dụng ATV đến ứng dụng của người gửi Truyền.

Bạn cần có

2. Nhận mã mẫu

Bạn có thể tải tất cả mã mẫu xuống máy tính của mình...

rồi giải nén tệp zip đã tải xuống.

3. Chạy ứng dụng mẫu

Trước tiên, hãy xem ứng dụng mẫu hoàn chỉnh trông như thế nào. Ứng dụng Android TV sử dụng giao diện người dùng Leanback và trình phát video cơ bản. Người dùng có thể chọn một video trong danh sách rồi phát trên TV khi được chọn. Với ứng dụng gửi đi trên thiết bị di động, người dùng cũng có thể truyền video đến ứng dụng Android TV.

Hình ảnh về một loạt hình thu nhỏ video (một trong số đó được làm nổi bật) phủ lên bản xem trước toàn màn hình của một video; dòng chữ "Cast Connect" xuất hiện ở phía trên bên phải

Đăng ký thiết bị của nhà phát triển

Để bật các tính năng của Cast Connect cho việc phát triển ứng dụng, bạn phải đăng ký số sê-ri của Chromecast tích hợp sẵn của thiết bị Android TV mà bạn sẽ sử dụng trong Cast Developer Console. Bạn có thể tìm số sê-ri bằng cách chuyển đến phần Cài đặt > Lựa chọn ưu tiên về thiết bị > Tích hợp Chromecast > Số sê-ri trên Android TV. Xin lưu ý rằng số này khác với số sê-ri của thiết bị thực của bạn và phải được lấy bằng phương pháp mô tả ở trên.

Hình ảnh màn hình Android TV cho thấy màn hình "Chromecast Tích hợp", số phiên bản và số sê-ri

Nếu không đăng ký, Cast Connect sẽ chỉ hoạt động với các ứng dụng được cài đặt từ Cửa hàng Google Play vì lý do bảo mật. Sau 15 phút kể từ khi bắt đầu quá trình đăng ký, hãy khởi động lại thiết bị của bạn.

Cài đặt ứng dụng người gửi trên Android

Để kiểm thử việc gửi yêu cầu từ một thiết bị di động, chúng tôi đã cung cấp một ứng dụng gửi đơn giản có tên là Truyền video dưới dạng tệp mobile-sender-0629.apk trong tệp zip chứa mã nguồn xuống. Chúng tôi sẽ tận dụng ADB để cài đặt APK. Nếu bạn đã cài đặt một phiên bản Truyền video khác, vui lòng gỡ cài đặt phiên bản đó khỏi tất cả hồ sơ trên thiết bị trước khi tiếp tục.

  1. Bật tuỳ chọn cho nhà phát triển và gỡ lỗi qua USB trên điện thoại Android.
  2. Cắm cáp dữ liệu USB để kết nối điện thoại Android với máy tính dùng để phát triển.
  3. Cài đặt mobile-sender-0629.apk vào điện thoại Android.

Hình ảnh cửa sổ dòng lệnh chạy lệnh cài đặt adb để cài đặt mobile-sender.apk

  1. Bạn có thể tìm thấy ứng dụng của người gửi Truyền video trên điện thoại Android. Biểu tượng ứng dụng truyền video của người gửi

Hình ảnh về ứng dụng truyền video dành cho người gửi đang chạy trên màn hình điện thoại Android

Cài đặt ứng dụng Android TV

Hướng dẫn sau đây mô tả cách mở và chạy ứng dụng mẫu đã hoàn chỉnh trong Android Studio:

  1. Chọn Import Project (Nhập dự án) trên màn hình chào mừng hoặc lựa chọn trình đơn File > New > Import Project... (Tệp > Mới > Nhập dự án...).
  2. Chọn thư mục biểu tượng thư mụcapp-done trong thư mục mã mẫu rồi nhấp vào OK.
  3. Nhấp vào File > Nút Đồng bộ hoá dự án với Gradle của Android App Studio Sync Project with Gradle Files (Tệp > Đồng bộ hoá dự án với các tệp Gradle).
  4. Bật tuỳ chọn cho nhà phát triển và gỡ lỗi qua USB trên thiết bị Android TV.
  5. ADB kết nối với thiết bị Android TV của bạn thì thiết bị sẽ hiển thị trong Android Studio. Hình ảnh cho thấy thiết bị Android TV xuất hiện trên thanh công cụ của Android Studio
  6. Nhấp vào nút Nút Chạy trong Android Studio, một hình tam giác màu xanh lục chỉ sang bên phảiRun (Chạy), bạn sẽ thấy ứng dụng ATV có tên là Cast Connect Codelab (Lớp học lập trình về Cast Connect) xuất hiện sau vài giây.

Hãy chơi Cast Connect bằng ứng dụng ATV

  1. Chuyển đến màn hình chính của Android TV.
  2. Mở ứng dụng người gửi Truyền video trên điện thoại Android. Nhấp vào nút Truyền Biểu tượng nút truyền và chọn thiết bị ATV của bạn.
  3. Ứng dụng Cast Connect Codelab ATV sẽ chạy trên ATV của bạn và nút Truyền trong máy gửi sẽ cho biết ứng dụng đã kết nối Biểu tượng nút truyền có các màu đảo ngược.
  4. Chọn một video từ ứng dụng ATV và video sẽ bắt đầu phát trên ATV của bạn.
  5. Trên điện thoại di động, bạn sẽ thấy một bộ điều khiển mini ở cuối ứng dụng dành cho người gửi. Bạn có thể dùng nút phát/tạm dừng để điều khiển quá trình phát.
  6. Chọn một video từ điện thoại di động và phát. Video sẽ bắt đầu phát trên ATV và bộ điều khiển mở rộng sẽ hiển thị trên thiết bị gửi trên thiết bị di động của bạn.
  7. Khoá điện thoại và khi mở khoá, bạn sẽ thấy thông báo trên màn hình khoá để điều khiển chế độ phát nội dung nghe nhìn hoặc dừng truyền.

Hình ảnh một phần trên màn hình điện thoại Android, trong đó có một trình phát thu nhỏ đang phát video

4. Chuẩn bị dự án khởi động

Giờ đây, chúng ta đã xác minh khả năng tích hợp Cast Connect của ứng dụng hoàn chỉnh, chúng ta cần thêm tính năng hỗ trợ cho Cast Connect cho ứng dụng ban đầu mà bạn tải xuống. Giờ đây, bạn đã sẵn sàng xây dựng dựa trên dự án khởi đầu bằng Android Studio:

  1. Chọn Import Project (Nhập dự án) trên màn hình chào mừng hoặc lựa chọn trình đơn File > New > Import Project... (Tệp > Mới > Nhập dự án...).
  2. Chọn thư mục biểu tượng thư mụcapp-start trong thư mục mã mẫu rồi nhấp vào OK.
  3. Nhấp vào File > Nút Đồng bộ hoá dự án với Gradle của Android Studio Sync Project with Gradle Files (Tệp > Đồng bộ hoá dự án với các tệp Gradle).
  4. Chọn thiết bị ATV rồi nhấp vào nút Nút Chạy trong Android Studio, một hình tam giác màu xanh lục chỉ sang phảiRun (Chạy) để chạy ứng dụng và khám phá giao diện người dùng. Thanh công cụ của Android Studio cho thấy thiết bị Android TV đã chọn

Hình ảnh về một loạt hình thu nhỏ video (một trong số đó được làm nổi bật) phủ lên bản xem trước toàn màn hình của một video; dòng chữ "Cast Connect" xuất hiện ở phía trên bên phải

Thiết kế ứng dụng

Ứng dụng cung cấp danh sách video để người dùng duyệt xem. Người dùng có thể chọn một video để phát trên Android TV. Ứng dụng này bao gồm hai hoạt động chính: MainActivityPlaybackActivity.

MainActivity

Hoạt động này chứa một Mảnh (MainFragment). Danh sách video và siêu dữ liệu liên kết với video đó được định cấu hình trong lớp MovieList và phương thức setupMovies() được gọi để tạo danh sách đối tượng Movie.

Đối tượng Movie đại diện cho một thực thể video có tiêu đề, nội dung mô tả, hình thu nhỏ của hình ảnh và URL của video. Mỗi đối tượng Movie được liên kết với một CardPresenter để hiển thị hình thu nhỏ video cùng với tiêu đề và studio và được truyền đến ArrayObjectAdapter.

Khi bạn chọn một mục, đối tượng Movie tương ứng sẽ được truyền đến PlaybackActivity.

PlaybackActivity

Hoạt động này chứa một Mảnh (PlaybackVideoFragment) lưu trữ VideoViewExoPlayer, một số chế độ điều khiển nội dung nghe nhìn và một vùng văn bản để cho thấy nội dung mô tả của video đã chọn, đồng thời cho phép người dùng phát video đó trên Android TV. Người dùng có thể sử dụng điều khiển từ xa để phát/tạm dừng hoặc tua video.

Điều kiện tiên quyết để sử dụng tính năng Cast Connect

Cast Connect sử dụng các phiên bản mới của Dịch vụ Google Play yêu cầu bạn phải cập nhật ứng dụng ATV để dùng không gian tên AndroidX.

Để hỗ trợ Cast Connect trong ứng dụng Android TV, bạn phải tạo và hỗ trợ các sự kiện từ phiên phát nội dung đa phương tiện. Thư viện Cast Connect tạo trạng thái nội dung nghe nhìn dựa trên trạng thái của phiên phát nội dung đa phương tiện. Phiên phát nội dung đa phương tiện của bạn cũng được thư viện Cast Connect sử dụng để báo hiệu khi nhận được một số tin nhắn nhất định từ người gửi, chẳng hạn như tạm dừng.

5. Định cấu hình hỗ trợ truyền

Phần phụ thuộc

Cập nhật tệp build.gradle của ứng dụng để thêm các phần phụ thuộc cần thiết của thư viện:

dependencies {
    ....

    // Cast Connect libraries
    implementation 'com.google.android.gms:play-services-cast-tv:20.0.0'
    implementation 'com.google.android.gms:play-services-cast:21.1.0'
}

Đồng bộ hoá dự án để xác nhận các bản dựng dự án không gặp lỗi.

Khởi chạy

CastReceiverContext là một đối tượng singleton để điều phối tất cả các lượt tương tác Truyền. Bạn phải triển khai giao diện ReceiverOptionsProvider để cung cấp CastReceiverOptions khi khởi chạy CastReceiverContext.

Tạo tệp CastReceiverOptionsProvider.kt và thêm lớp sau vào dự án:

package com.google.sample.cast.castconnect

import android.content.Context
import com.google.android.gms.cast.tv.ReceiverOptionsProvider
import com.google.android.gms.cast.tv.CastReceiverOptions

class CastReceiverOptionsProvider : ReceiverOptionsProvider {
    override fun getOptions(context: Context): CastReceiverOptions {
        return CastReceiverOptions.Builder(context)
                .setStatusText("Cast Connect Codelab")
                .build()
    }
}

Sau đó, chỉ định trình cung cấp tuỳ chọn trình nhận trong thẻ <application> của tệp AndroidManifest.xml trong ứng dụng:

<application>
  ...
  <meta-data
    android:name="com.google.android.gms.cast.tv.RECEIVER_OPTIONS_PROVIDER_CLASS_NAME"
    android:value="com.google.sample.cast.castconnect.CastReceiverOptionsProvider" />
</application>

Để kết nối với ứng dụng ATV từ thiết bị phát Cast, hãy chọn một hoạt động bạn muốn khởi chạy. Trong lớp học lập trình này, chúng ta sẽ chạy MainActivity của ứng dụng khi một phiên Truyền bắt đầu. Trong tệp AndroidManifest.xml, hãy thêm bộ lọc ý định khởi chạy vào MainActivity.

<activity android:name=".MainActivity">
  ...
  <intent-filter>
    <action android:name="com.google.android.gms.cast.tv.action.LAUNCH" />
    <category android:name="android.intent.category.DEFAULT" />
  </intent-filter>
</activity>

Vòng đời theo bối cảnh của bộ thu truyền

Bạn nên khởi động CastReceiverContext khi ứng dụng đã chạy và dừng CastReceiverContext khi ứng dụng chuyển sang chạy ở chế độ nền. Bạn nên sử dụng LifecycleObserver trong thư viện androidx.lifecycle để quản lý việc gọi CastReceiverContext.start()CastReceiverContext.stop()

Mở tệp MyApplication.kt, khởi chạy ngữ cảnh truyền bằng cách gọi initInstance() trong phương thức onCreate của ứng dụng. Trong lớp AppLifeCycleObserver start(), CastReceiverContext khi ứng dụng được tiếp tục và stop() khi ứng dụng bị tạm dừng:

package com.google.sample.cast.castconnect

import com.google.android.gms.cast.tv.CastReceiverContext
...

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        CastReceiverContext.initInstance(this)
        ProcessLifecycleOwner.get().lifecycle.addObserver(AppLifecycleObserver())
    }

    class AppLifecycleObserver : DefaultLifecycleObserver {
        override fun onResume(owner: LifecycleOwner) {
            Log.d(LOG_TAG, "onResume")
            CastReceiverContext.getInstance().start()
        }

        override fun onPause(owner: LifecycleOwner) {
            Log.d(LOG_TAG, "onPause")
            CastReceiverContext.getInstance().stop()
        }
    }
}

Kết nối MediaSession với MediaManager

MediaManager là một thuộc tính của singleton CastReceiverContext. Thuộc tính này quản lý trạng thái nội dung đa phương tiện, xử lý ý định tải, chuyển thông báo trong không gian tên nội dung nghe nhìn của người gửi thành lệnh về nội dung đa phương tiện và gửi lại trạng thái nội dung nghe nhìn cho người gửi.

Khi tạo một MediaSession, bạn cũng cần cung cấp mã thông báo MediaSession hiện tại cho MediaManager để ứng dụng biết nơi gửi lệnh và truy xuất trạng thái phát nội dung đa phương tiện. Trong tệp PlaybackVideoFragment.kt, hãy đảm bảo MediaSession đã được khởi động trước khi đặt mã thông báo thành MediaManager.

import com.google.android.gms.cast.tv.CastReceiverContext
import com.google.android.gms.cast.tv.media.MediaManager
...

class PlaybackVideoFragment : VideoSupportFragment() {
    private var castReceiverContext: CastReceiverContext? = null
    ...

    private fun initializePlayer() {
        if (mPlayer == null) {
            ...
            mMediaSession = MediaSessionCompat(getContext(), LOG_TAG)
            ...
            castReceiverContext = CastReceiverContext.getInstance()
            if (castReceiverContext != null) {
                val mediaManager: MediaManager = castReceiverContext!!.getMediaManager()
                mediaManager.setSessionCompatToken(mMediaSession!!.getSessionToken())
            }

        }
    }
}

Khi bạn phát hành MediaSession do tính năng phát không hoạt động, bạn nên đặt mã thông báo rỗng trên MediaManager:

private fun releasePlayer() {
    mMediaSession?.release()
    castReceiverContext?.mediaManager?.setSessionCompatToken(null)
    ...
}

Hãy chạy ứng dụng mẫu

Nhấp vào nút Nút Chạy trong Android Studio, một hình tam giác màu xanh lục chỉ sang phảiRun (Chạy) để triển khai ứng dụng trên thiết bị ATV, đóng ứng dụng rồi quay lại Màn hình chính của ATV. Từ người gửi của bạn, nhấp vào nút Truyền Biểu tượng nút truyền và chọn thiết bị ATV của bạn. Bạn sẽ thấy ứng dụng ATV được khởi chạy trên thiết bị ATV và trạng thái nút Truyền được kết nối.

6. Đang tải nội dung nghe nhìn

Lệnh tải được gửi thông qua một ý định có tên gói mà bạn đã xác định trong bảng điều khiển dành cho nhà phát triển. Bạn cần thêm bộ lọc ý định được xác định trước sau đây vào ứng dụng Android TV để chỉ định hoạt động mục tiêu sẽ nhận ý định này. Trong tệp AndroidManifest.xml, hãy thêm bộ lọc tải ý định vào PlayerActivity:

<activity android:name="com.google.sample.cast.castconnect.PlaybackActivity"
          android:launchMode="singleTask"
          android:exported="true">
  <intent-filter>
     <action android:name="com.google.android.gms.cast.tv.action.LOAD"/>
     <category android:name="android.intent.category.DEFAULT" />
  </intent-filter>
</activity>

Xử lý yêu cầu tải trên Android TV

Bây giờ, hoạt động được định cấu hình để nhận ý định này có chứa một yêu cầu tải, chúng ta sẽ cần xử lý ý định đó.

Ứng dụng gọi một phương thức riêng tư có tên là processIntent khi hoạt động bắt đầu. Phương thức này chứa logic để xử lý các ý định đến. Để xử lý một yêu cầu tải, chúng ta sẽ sửa đổi phương thức này và gửi ý định để tiếp tục được xử lý bằng cách gọi phương thức onNewIntent của thực thể MediaManager. Nếu MediaManager phát hiện ý định là một yêu cầu tải, thì ứng dụng sẽ trích xuất đối tượng MediaLoadRequestData từ ý định và gọi MediaLoadCommandCallback.onLoad(). Sửa đổi phương thức processIntent trong tệp PlaybackVideoFragment.kt để xử lý ý định chứa yêu cầu tải:

fun processIntent(intent: Intent?) {
    val mediaManager: MediaManager = CastReceiverContext.getInstance().getMediaManager()
    // Pass intent to Cast SDK
    if (mediaManager.onNewIntent(intent)) {
        return
    }

    // Clears all overrides in the modifier.
    mediaManager.getMediaStatusModifier().clear()

    // If the SDK doesn't recognize the intent, handle the intent with your own logic.
    ...
}

Tiếp theo, chúng ta sẽ mở rộng lớp trừu tượng MediaLoadCommandCallback. Lớp này sẽ ghi đè phương thức onLoad() do MediaManager gọi. Phương thức này nhận dữ liệu của yêu cầu tải và chuyển đổi dữ liệu đó thành đối tượng Movie. Sau khi chuyển đổi, trình phát cục bộ sẽ phát phim. Sau đó, MediaManager được cập nhật bằng MediaLoadRequest và truyền MediaStatus đến những người gửi đã kết nối. Tạo một lớp riêng tư được lồng có tên là MyMediaLoadCommandCallback trong tệp PlaybackVideoFragment.kt:

import com.google.android.gms.cast.MediaLoadRequestData
import com.google.android.gms.cast.MediaInfo
import com.google.android.gms.cast.MediaMetadata
import com.google.android.gms.cast.MediaError
import com.google.android.gms.cast.tv.media.MediaException
import com.google.android.gms.cast.tv.media.MediaCommandCallback
import com.google.android.gms.cast.tv.media.QueueUpdateRequestData
import com.google.android.gms.cast.tv.media.MediaLoadCommandCallback
import com.google.android.gms.tasks.Task
import com.google.android.gms.tasks.Tasks
import android.widget.Toast
...

private inner class MyMediaLoadCommandCallback :  MediaLoadCommandCallback() {
    override fun onLoad(
        senderId: String?, mediaLoadRequestData: MediaLoadRequestData): Task<MediaLoadRequestData> {
        Toast.makeText(activity, "onLoad()", Toast.LENGTH_SHORT).show()
        return if (mediaLoadRequestData == null) {
            // Throw MediaException to indicate load failure.
            Tasks.forException(MediaException(
                MediaError.Builder()
                    .setDetailedErrorCode(MediaError.DetailedErrorCode.LOAD_FAILED)
                    .setReason(MediaError.ERROR_REASON_INVALID_REQUEST)
                    .build()))
        } else Tasks.call {
            play(convertLoadRequestToMovie(mediaLoadRequestData)!!)
            // Update media metadata and state
            val mediaManager = castReceiverContext!!.mediaManager
            mediaManager.setDataFromLoad(mediaLoadRequestData)
            mediaLoadRequestData
        }
    }
}

private fun convertLoadRequestToMovie(mediaLoadRequestData: MediaLoadRequestData?): Movie? {
    if (mediaLoadRequestData == null) {
        return null
    }
    val mediaInfo: MediaInfo = mediaLoadRequestData.getMediaInfo() ?: return null
    var videoUrl: String = mediaInfo.getContentId()
    if (mediaInfo.getContentUrl() != null) {
        videoUrl = mediaInfo.getContentUrl()
    }
    val metadata: MediaMetadata = mediaInfo.getMetadata()
    val movie = Movie()
    movie.videoUrl = videoUrl
    movie.title = metadata?.getString(MediaMetadata.KEY_TITLE)
    movie.description = metadata?.getString(MediaMetadata.KEY_SUBTITLE)
    if(metadata?.hasImages() == true) {
        movie.cardImageUrl = metadata.images[0].url.toString()
    }
    return movie
}

Giờ đây, lệnh gọi lại đã được xác định, chúng ta cần đăng ký lệnh gọi lại đó vào MediaManager. Bạn phải đăng ký lệnh gọi lại thì mới có thể gọi MediaManager.onNewIntent(). Thêm setMediaLoadCommandCallback khi trình phát được khởi động:

private fun initializePlayer() {
    if (mPlayer == null) {
        ...
        mMediaSession = MediaSessionCompat(getContext(), LOG_TAG)
        ...
        castReceiverContext = CastReceiverContext.getInstance()
        if (castReceiverContext != null) {
            val mediaManager: MediaManager = castReceiverContext.getMediaManager()
            mediaManager.setSessionCompatToken(mMediaSession.getSessionToken())
            mediaManager.setMediaLoadCommandCallback(MyMediaLoadCommandCallback())
        }
    }
}

Hãy chạy ứng dụng mẫu

Nhấp vào nút Nút Chạy trong Android Studio, một hình tam giác màu xanh lục chỉ sang phảiRun (Chạy) để triển khai ứng dụng trên thiết bị ATV của bạn. Từ người gửi của bạn, nhấp vào nút Truyền Biểu tượng nút truyền và chọn thiết bị ATV của bạn. Ứng dụng ATV sẽ được khởi chạy trên thiết bị ATV. Chọn một video trên thiết bị di động, video sẽ bắt đầu phát trên ATV. Kiểm tra xem bạn có nhận được thông báo trên điện thoại khi có bộ điều khiển chế độ phát hay không. Hãy thử dùng các nút điều khiển như tạm dừng, để tạm dừng video trên thiết bị ATV.

7. Hỗ trợ các lệnh điều khiển truyền

Ứng dụng hiện tại hỗ trợ các lệnh cơ bản tương thích với một phiên phát nội dung đa phương tiện, chẳng hạn như phát, tạm dừng và tua. Tuy nhiên, có một số lệnh Điều khiển truyền không dùng được trong phiên phát nội dung đa phương tiện. Bạn cần đăng ký MediaCommandCallback để hỗ trợ các lệnh điều khiển Truyền đó.

Thêm MyMediaCommandCallback vào thực thể MediaManager bằng setMediaCommandCallback khi khởi chạy trình phát:

private fun initializePlayer() {
    ...
    castReceiverContext = CastReceiverContext.getInstance()
    if (castReceiverContext != null) {
        val mediaManager = castReceiverContext!!.mediaManager
        ...
        mediaManager.setMediaCommandCallback(MyMediaCommandCallback())
    }
}

Tạo lớp MyMediaCommandCallback để ghi đè các phương thức, chẳng hạn như onQueueUpdate() để hỗ trợ các lệnh điều khiển Truyền:

private inner class MyMediaCommandCallback : MediaCommandCallback() {
    override fun onQueueUpdate(
        senderId: String?,
        queueUpdateRequestData: QueueUpdateRequestData
    ): Task<Void> {
        Toast.makeText(getActivity(), "onQueueUpdate()", Toast.LENGTH_SHORT).show()
        // Queue Prev / Next
        if (queueUpdateRequestData.getJump() != null) {
            Toast.makeText(
                getActivity(),
                "onQueueUpdate(): Jump = " + queueUpdateRequestData.getJump(),
                Toast.LENGTH_SHORT
            ).show()
        }
        return super.onQueueUpdate(senderId, queueUpdateRequestData)
    }
}

8. Làm việc với trạng thái nội dung nghe nhìn

Sửa đổi trạng thái nội dung đa phương tiện

Cast Connect nhận trạng thái nội dung nghe nhìn cơ sở từ phiên phát nội dung đa phương tiện. Để hỗ trợ các tính năng nâng cao, ứng dụng Android TV có thể chỉ định và ghi đè các thuộc tính trạng thái bổ sung thông qua MediaStatusModifier. MediaStatusModifier sẽ luôn hoạt động trên MediaSession mà bạn đã thiết lập trong CastReceiverContext.

Ví dụ: để chỉ định setMediaCommandSupported khi lệnh gọi lại onLoad được kích hoạt, hãy làm như sau:

import com.google.android.gms.cast.MediaStatus
...
private class MyMediaLoadCommandCallback : MediaLoadCommandCallback() {
    fun onLoad(
        senderId: String?,
        mediaLoadRequestData: MediaLoadRequestData
    ): Task<MediaLoadRequestData> {
        Toast.makeText(getActivity(), "onLoad()", Toast.LENGTH_SHORT).show()
        ...
        return Tasks.call({
            play(convertLoadRequestToMovie(mediaLoadRequestData)!!)
            ...
            // Use MediaStatusModifier to provide additional information for Cast senders.
            mediaManager.getMediaStatusModifier()
                .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT, true)
                .setIsPlayingAd(false)
            mediaManager.broadcastMediaStatus()
            // Return the resolved MediaLoadRequestData to indicate load success.
            mediaLoadRequestData
        })
    }
}

Chặn MediaStatus trước khi gửi đi

Tương tự như MessageInterceptor của SDK Web receiver, bạn có thể chỉ định MediaStatusWriter trong MediaManager để thực hiện các thao tác sửa đổi bổ sung đối với MediaStatus trước khi thông báo được truyền đến những người gửi đã kết nối.

Ví dụ: bạn có thể thiết lập dữ liệu tuỳ chỉnh trong MediaStatus trước khi gửi cho người gửi trên thiết bị di động:

import com.google.android.gms.cast.tv.media.MediaManager.MediaStatusInterceptor
import com.google.android.gms.cast.tv.media.MediaStatusWriter
import org.json.JSONObject
import org.json.JSONException
...

private fun initializePlayer() {
    if (mPlayer == null) {
        ...
        if (castReceiverContext != null) {
            ...
            val mediaManager: MediaManager = castReceiverContext.getMediaManager()
            ...
            // Use MediaStatusInterceptor to process the MediaStatus before sending out.
            mediaManager.setMediaStatusInterceptor(
                MediaStatusInterceptor { mediaStatusWriter: MediaStatusWriter ->
                    try {
                        mediaStatusWriter.setCustomData(JSONObject("{myData: 'CustomData'}"))
                    } catch (e: JSONException) {
                        Log.e(LOG_TAG,e.message,e);
                    }
            })
        }
    }
}        

9. Xin chúc mừng

Giờ đây, bạn đã biết cách dùng tính năng Truyền ứng dụng cho Android TV bằng Thư viện Cast Connect.

Hãy xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin chi tiết: /cast/docs/android_tv_receiver.