Trang này được dịch bởi Cloud Translation API.

Switch to English

Thêm các tính năng chính vào Bộ thu Android TV

Trang này chứa các đoạn mã và nội dung mô tả về các tính năng có sẵn để tuỳ chỉnh ứng dụng Bộ thu Android TV.

Định cấu hình thư viện

Cách cung cấp API Cast Connect cho ứng dụng Android TV:

Android

Mở tệp build.gradle bên trong thư mục mô-đun ứng dụng của bạn.
Lưu ý: Dự án Android Studio chứa tệp build.gradle cấp cao nhất và tệp build.gradle cho từng mô-đun. Hãy nhớ chỉnh sửa tệp cho mô-đun ứng dụng của bạn. Xem phần Xây dựng dự án của bạn với Gradle để biết thêm thông tin về Gradle.
Xác minh rằng google() được đưa vào repositories trong danh sách.
```
  repositories {
    google()
  }
```
Tuỳ thuộc vào loại thiết bị mục tiêu cho ứng dụng, hãy thêm phiên bản mới nhất của các thư viện vào phần phụ thuộc:
- Đối với ứng dụng Bộ thu Android:
```
  dependencies {
    implementation 'com.google.android.gms:play-services-cast-tv:20.0.0'
    implementation 'com.google.android.gms:play-services-cast:21.2.0'
  }
```
- Đối với ứng dụng Người gửi Android:
```
  dependencies {
    implementation 'com.google.android.gms:play-services-cast:20.0.0'
    implementation 'com.google.android.gms:play-services-cast-framework:21.2.0'
  }
```
Hãy nhớ cập nhật số phiên bản này mỗi khi dịch vụ được cập nhật.
Lưu các thay đổi rồi nhấp vào Sync Project with Gradle Files trên thanh công cụ.

iOS

Đảm bảo rằng bạn Podfile đang nhắm đến google-cast-sdk 4.7.0 trở lên
Nhắm đến iOS 12 trở lên. Hãy xem phần Ghi chú phát hành để biết thêm thông tin.
```
  platform: ios, '12'

  def target_pods
     pod 'google-cast-sdk', '~>4.7.0'
  end
```

Web

Yêu cầu trình duyệt Chromium phiên bản M87 trở lên.

Thêm thư viện API Web Sender vào dự án

  <script src="//www.gstatic.com/cv/js/sender/v1/cast_sender.js?loadCastFramework=1"></script>

Yêu cầu về AndroidX

Phiên bản mới của Dịch vụ Google Play yêu cầu cập nhật một ứng dụng để sử dụng vùng chứa tên androidx. Làm theo hướng dẫn để di chuyển sang AndroidX.

Ứng dụng Android TV – điều kiện tiên quyết

Để 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ừ một phiên phát nội dung đa phương tiện. Dữ liệu do phiên phát nội dung đa phương tiện cung cấp sẽ cung cấp thông tin cơ bản, chẳng hạn như vị trí, trạng thái phát, v.v. cho trạng thái nội dung nghe nhìn của bạn. Thư viện Cast Connect cũng sử dụng phiên phát nội dung đa phương tiện của bạn để báo hiệu khi nhận được một số tin nhắn nhất định của người gửi, chẳng hạn như tạm dừng.

Để biết thêm thông tin về phiên phát nội dung đa phương tiện và cách khởi chạy phiên phát nội dung đa phương tiện, hãy xem hướng dẫn cách xử lý phiên phát nội dung đa phương tiện.

Vòng đời của phiên phát nội dung đa phương tiện

Ứng dụng của bạn phải tạo một phiên phát nội dung đa phương tiện khi quá trình phát bắt đầu và phát hành khi phương thức đó không thể điều khiển được nữa. Ví dụ: nếu ứng dụng của bạn là một ứng dụng video, bạn nên phát hành phiên hoạt động khi người dùng thoát khỏi hoạt động phát, bằng cách chọn 'quay lại' để duyệt qua nội dung khác hoặc chạy nền.

Đang cập nhật trạng thái phiên

Dữ liệu trong phiên phát nội dung đa phương tiện của bạn phải được cập nhật liên tục theo trạng thái của trình phát. Ví dụ: khi tạm dừng phát, bạn nên cập nhật trạng thái phát cũng như các thao tác được hỗ trợ. Các bảng sau liệt kê những trạng thái bạn chịu trách nhiệm cập nhật.

MediaMetadataCompat

Trường siêu dữ liệu	Mô tả
METADATA_KEY_TITLE (bắt buộc)	Tiêu đề nội dung nghe nhìn.
METADATA_KEY_DISPLAY_SUBTITLE	Phụ đề.
METADATA_KEY_DISPLAY_ICON_URI	URL biểu tượng.
METADATA_KEY_DURATION (bắt buộc)	Thời lượng nội dung nghe nhìn.
METADATA_KEY_MEDIA_URI	Content ID.
METADATA_KEY_ARTIST	Nghệ sĩ.
METADATA_KEY_JavaScript	Đĩa nhạc.

PlaybackStateCompat

Phương thức bắt buộc	Mô tả
setActions()	Đặt các lệnh đa phương tiện được hỗ trợ.
setState()	Đặt trạng thái phát và vị trí hiện tại.

MediaSessionCompat

Phương thức bắt buộc	Mô tả
setRepeatMode()	Đặt chế độ lặp lại.
setTrộnMode()	Đặt chế độ trộn bài.
setMetadata()	Thiết lập siêu dữ liệu cho nội dung nghe nhìn.
setPlaybackState()	Đặt trạng thái phát.

Kotlin

private fun updateMediaSession() {
    val metadata = MediaMetadataCompat.Builder()
         .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title")
         .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle")
         .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI, mMovie.getCardImageUrl())
         .build()

    val playbackState = PlaybackStateCompat.Builder()
         .setState(
             PlaybackStateCompat.STATE_PLAYING,
             player.getPosition(),
             player.getPlaybackSpeed(),
             System.currentTimeMillis()
        )
         .build()

    mediaSession.setMetadata(metadata)
    mediaSession.setPlaybackState(playbackState)
}

Java

private void updateMediaSession() {
  MediaMetadataCompat metadata =
      new MediaMetadataCompat.Builder()
          .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title")
          .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle")
          .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI,mMovie.getCardImageUrl())
          .build();

  PlaybackStateCompat playbackState =
      new PlaybackStateCompat.Builder()
          .setState(
               PlaybackStateCompat.STATE_PLAYING,
               player.getPosition(),
               player.getPlaybackSpeed(),
               System.currentTimeMillis())
          .build();

  mediaSession.setMetadata(metadata);
  mediaSession.setPlaybackState(playbackState);
}

Xử lý giao thông điều khiển

Ứng dụng của bạn phải triển khai lệnh gọi lại phương thức điều khiển truyền tải phiên đa phương tiện. Bảng sau đây cho thấy những hành động điều khiển phương tiện giao thông mà họ cần xử lý:

MediaSessionCompat.Callback

Thao tác	Mô tả
onPlay()	Kích hoạt lại
onPause()	Tạm dừng
onSeekTo()	Tua đến một vị trí
onStop()	Dừng phát nội dung nghe nhìn hiện tại

Kotlin

class MyMediaSessionCallback : MediaSessionCompat.Callback() {
  override fun onPause() {
    // Pause the player and update the play state.
    ...
  }

  override fun onPlay() {
    // Resume the player and update the play state.
    ...
  }

  override fun onSeekTo (long pos) {
    // Seek and update the play state.
    ...
  }
  ...
}

mediaSession.setCallback( MyMediaSessionCallback() );

Java

public MyMediaSessionCallback extends MediaSessionCompat.Callback {
  public void onPause() {
    // Pause the player and update the play state.
    ...
  }

  public void onPlay() {
    // Resume the player and update the play state.
    ...
  }

  public void onSeekTo (long pos) {
    // Seek and update the play state.
    ...
  }
  ...
}

mediaSession.setCallback(new MyMediaSessionCallback());

Định cấu hình hỗ trợ Truyền

Khi ứng dụng người gửi gửi yêu cầu khởi chạy, một ý định sẽ được tạo bằng không gian tên của ứng dụng. Ứng dụng của bạn chịu trách nhiệm xử lý việc này và tạo một bản sao của đối tượng CastReceiverContext khi chạy ứng dụng TV. Cần có đối tượng CastReceiverContext để tương tác với tính năng Truyền khi ứng dụng TV đang chạy. Đối tượng này cho phép ứng dụng TV của bạn chấp nhận tin nhắn nội dung nghe nhìn được truyền từ bất kỳ người gửi đã kết nối nào.

Thiết lập Android TV

Thêm bộ lọc ý định khởi chạy

Thêm bộ lọc ý định mới vào hoạt động mà bạn muốn xử lý ý định khởi chạy từ ứng dụng người gửi:

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

Chỉ định nhà cung cấp tùy chọn người nhận

Bạn cần triển khai ReceiverOptionsProvider để cung cấp CastReceiverOptions:

Kotlin

class MyReceiverOptionsProvider : ReceiverOptionsProvider {
  override fun getOptions(context: Context?): CastReceiverOptions {
    return CastReceiverOptions.Builder(context)
          .setStatusText("My App")
          .build()
    }
}

Java

public class MyReceiverOptionsProvider implements ReceiverOptionsProvider {
  @Override
  public CastReceiverOptions getOptions(Context context) {
    return new CastReceiverOptions.Builder(context)
        .setStatusText("My App")
        .build();
  }
}

Sau đó, hãy chỉ định nhà cung cấp tuỳ chọn trong AndroidManifest của bạn:

 <meta-data
    android:name="com.google.android.gms.cast.tv.RECEIVER_OPTIONS_PROVIDER_CLASS_NAME"
    android:value="com.example.mysimpleatvapplication.MyReceiverOptionsProvider" />

ReceiverOptionsProvider dùng để cung cấp CastReceiverOptions khi CastReceiverContext được khởi chạy.

Bối cảnh của broadcast receiver

Khởi động CastReceiverContext khi ứng dụng được tạo:

Kotlin

override fun onCreate() {
  CastReceiverContext.initInstance(this)

  ...
}

Java

@Override
public void onCreate() {
  CastReceiverContext.initInstance(this);

  ...
}

Khởi động CastReceiverContext khi ứng dụng của bạn chuyển sang nền trước:

Kotlin

CastReceiverContext.getInstance().start()

Java

CastReceiverContext.getInstance().start();

Gọi stop() trên CastReceiverContext sau khi ứng dụng chuyển sang chạy ở chế độ nền cho ứng dụng video hoặc ứng dụng không hỗ trợ tính năng phát trong nền:

Kotlin

// Player has stopped.
CastReceiverContext.getInstance().stop()

Java

// Player has stopped.
CastReceiverContext.getInstance().stop();

Ngoài ra, nếu ứng dụng của bạn hỗ trợ phát trong nền, hãy gọi stop() trên CastReceiverContext khi ứng dụng đó ngừng phát trong nền.

Bạn nên sử dụng LifecycleObserver từ thư viện androidx.lifecycle để quản lý việc gọi CastReceiverContext.start() và CastReceiverContext.stop(), đặc biệt là khi ứng dụng gốc của bạn có nhiều hoạt động. Điều này giúp tránh các tình huống tương tranh khi gọi start() và stop() từ các hoạt động khác nhau.

Kotlin

// Create a LifecycleObserver class.
class MyLifecycleObserver : DefaultLifecycleObserver {
  override fun onStart(owner: LifecycleOwner) {
    // App prepares to enter foreground.
    CastReceiverContext.getInstance().start()
  }

  override fun onStop(owner: LifecycleOwner) {
    // App has moved to the background or has terminated.
    CastReceiverContext.getInstance().stop()
  }
}

// Add the observer when your application is being created.
class MyApplication : Application() {
  fun onCreate() {
    super.onCreate()

    // Initialize CastReceiverContext.
    CastReceiverContext.initInstance(this /* android.content.Context */)

    // Register LifecycleObserver
    ProcessLifecycleOwner.get().lifecycle.addObserver(
        MyLifecycleObserver())
  }
}

Java

// Create a LifecycleObserver class.
public class MyLifecycleObserver implements DefaultLifecycleObserver {
  @Override
  public void onStart(LifecycleOwner owner) {
    // App prepares to enter foreground.
    CastReceiverContext.getInstance().start();
  }

  @Override
  public void onStop(LifecycleOwner owner) {
    // App has moved to the background or has terminated.
    CastReceiverContext.getInstance().stop();
  }
}

// Add the observer when your application is being created.
public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();

    // Initialize CastReceiverContext.
    CastReceiverContext.initInstance(this /* android.content.Context */);

    // Register LifecycleObserver
    ProcessLifecycleOwner.get().getLifecycle().addObserver(
        new MyLifecycleObserver());
  }
}

// In AndroidManifest.xml set MyApplication as the application class
<application
    ...
    android:name=".MyApplication">

Kết nối MediaSession với MediaManager

Khi tạo MediaSession, bạn cũng cần cung cấp mã thông báo MediaSession hiện tại cho CastReceiverContext để biết nơi gửi các lệnh và truy xuất trạng thái phát nội dung đa phương tiện:

Kotlin

val mediaManager: MediaManager = receiverContext.getMediaManager()
mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken())

Java

MediaManager mediaManager = receiverContext.getMediaManager();
mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());

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

Kotlin

myPlayer.stop()
mediaSession.release()
mediaManager.setSessionCompatToken(null)

Java

myPlayer.stop();
mediaSession.release();
mediaManager.setSessionCompatToken(null);

Nếu ứng dụng của bạn hỗ trợ phát nội dung nghe nhìn trong khi ứng dụng đang chạy ở chế độ nền, thì thay vì gọi CastReceiverContext.stop() khi ứng dụng được gửi ở chế độ nền, bạn chỉ nên gọi khi ứng dụng đang chạy trong nền và không còn phát nội dung nghe nhìn nữa. Ví dụ:

Kotlin

class MyLifecycleObserver : DefaultLifecycleObserver {
  ...
  // App has moved to the background.
  override fun onPause(owner: LifecycleOwner) {
    mIsBackground = true
    myStopCastReceiverContextIfNeeded()
  }
}

// Stop playback on the player.
private fun myStopPlayback() {
  myPlayer.stop()

  myStopCastReceiverContextIfNeeded()
}

// Stop the CastReceiverContext when both the player has
// stopped and the app has moved to the background.
private fun myStopCastReceiverContextIfNeeded() {
  if (mIsBackground && myPlayer.isStopped()) {
    CastReceiverContext.getInstance().stop()
  }
}

Java

public class MyLifecycleObserver implements DefaultLifecycleObserver {
  ...
  // App has moved to the background.
  @Override
  public void onPause(LifecycleOwner owner) {
    mIsBackground = true;

    myStopCastReceiverContextIfNeeded();
  }
}

// Stop playback on the player.
private void myStopPlayback() {
  myPlayer.stop();

  myStopCastReceiverContextIfNeeded();
}

// Stop the CastReceiverContext when both the player has
// stopped and the app has moved to the background.
private void myStopCastReceiverContextIfNeeded() {
  if (mIsBackground && myPlayer.isStopped()) {
    CastReceiverContext.getInstance().stop();
  }
}

Sử dụng Exoplayer với Cast Connect

Nếu đang sử dụng Exoplayer, bạn có thể sử dụng MediaSessionConnector để tự động duy trì phiên hoạt động và tất cả thông tin liên quan, bao gồm cả trạng thái phát thay vì theo dõi các thay đổi theo cách thủ công.

Bạn có thể dùng MediaSessionConnector.MediaButtonEventHandler để xử lý các sự kiện MediaButton bằng cách gọi setMediaButtonEventHandler(MediaButtonEventHandler) theo cách khác được MediaSessionCompat.Callback xử lý theo mặc định.

Để tích hợp MediaSessionConnector trong ứng dụng, hãy thêm nội dung sau vào lớp hoạt động của người chơi hoặc bất kỳ nơi nào bạn quản lý phiên phát nội dung đa phương tiện:

Kotlin

class PlayerActivity : Activity() {
  private var mMediaSession: MediaSessionCompat? = null
  private var mMediaSessionConnector: MediaSessionConnector? = null
  private var mMediaManager: MediaManager? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    ...
    mMediaSession = MediaSessionCompat(this, LOG_TAG)
    mMediaSessionConnector = MediaSessionConnector(mMediaSession!!)
    ...
  }

  override fun onStart() {
    ...
    mMediaManager = receiverContext.getMediaManager()
    mMediaManager!!.setSessionCompatToken(currentMediaSession.getSessionToken())
    mMediaSessionConnector!!.setPlayer(mExoPlayer)
    mMediaSessionConnector!!.setMediaMetadataProvider(mMediaMetadataProvider)
    mMediaSession!!.isActive = true
    ...
  }

  override fun onStop() {
    ...
    mMediaSessionConnector!!.setPlayer(null)
    mMediaSession!!.release()
    mMediaManager!!.setSessionCompatToken(null)
    ...
  }
}

Java

public class PlayerActivity extends Activity {
  private MediaSessionCompat mMediaSession;
  private MediaSessionConnector mMediaSessionConnector;
  private MediaManager mMediaManager;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ...
    mMediaSession = new MediaSessionCompat(this, LOG_TAG);
    mMediaSessionConnector = new MediaSessionConnector(mMediaSession);
    ...
  }

  @Override
  protected void onStart() {
    ...
    mMediaManager = receiverContext.getMediaManager();
    mMediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());

    mMediaSessionConnector.setPlayer(mExoPlayer);
    mMediaSessionConnector.setMediaMetadataProvider(mMediaMetadataProvider);
    mMediaSession.setActive(true);
    ...
  }

  @Override
  protected void onStop() {
    ...
    mMediaSessionConnector.setPlayer(null);
    mMediaSession.release();
    mMediaManager.setSessionCompatToken(null);
    ...
  }
}

Thiết lập ứng dụng dành cho người gửi

Bật hỗ trợ Cast Connect

Sau khi cập nhật ứng dụng gửi với tính năng hỗ trợ Cast Connect, bạn có thể khai báo trạng thái sẵn sàng bằng cách đặt cờ androidReceiverCompatible trên LaunchOptions thành true (đúng).

Android

Yêu cầu play-services-cast-framework phiên bản 19.0.0 trở lên.

Cờ androidReceiverCompatible được đặt trong LaunchOptions (một phần của CastOptions):

Kotlin

class CastOptionsProvider : OptionsProvider {
  override fun getCastOptions(context: Context?): CastOptions {
    val launchOptions: LaunchOptions = Builder()
          .setAndroidReceiverCompatible(true)
          .build()
    return CastOptions.Builder()
          .setLaunchOptions(launchOptions)
          ...
          .build()
    }
}

Java

public class CastOptionsProvider implements OptionsProvider {
  @Override
  public CastOptions getCastOptions(Context context) {
    LaunchOptions launchOptions = new LaunchOptions.Builder()
              .setAndroidReceiverCompatible(true)
              .build();
    return new CastOptions.Builder()
        .setLaunchOptions(launchOptions)
        ...
        .build();
  }
}

iOS

Yêu cầu google-cast-sdk phiên bản v4.4.8 trở lên.

Cờ androidReceiverCompatible được đặt trong GCKLaunchOptions (một phần của GCKCastOptions):

let options = GCKCastOptions(discoveryCriteria: GCKDiscoveryCriteria(applicationID: kReceiverAppID))
...
let launchOptions = GCKLaunchOptions()
launchOptions.androidReceiverCompatible = true
options.launchOptions = launchOptions
GCKCastContext.setSharedInstanceWith(options)

Web

Yêu cầu phiên bản trình duyệt Chromium M87 trở lên.

const context = cast.framework.CastContext.getInstance();
const castOptions = new cast.framework.CastOptions();
castOptions.receiverApplicationId = kReceiverAppID;
castOptions.androidReceiverCompatible = true;
context.setOptions(castOptions);

Thiết lập Cast Developer Console

Định cấu hình ứng dụng Android TV

Thêm tên gói ứng dụng Android TV trong Cast Developer Console để liên kết ứng dụng đó với ID ứng dụng Cast.

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

Đăng ký số sê-ri của thiết bị Android TV mà bạn sẽ dùng để phát triển trong Bảng điều khiển dành cho nhà phát triển tính năng truyền.

Khi không đăng ký, Cast Connect sẽ chỉ hoạt động đối với các ứng dụng được cài đặt qua Cửa hàng Google Play vì lý do bảo mật.

Để biết thêm thông tin về cách đăng ký thiết bị Truyền hoặc Android TV cho việc phát triển tính năng Truyền, hãy xem trang đăng ký.

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

Nếu đã triển khai tính năng hỗ trợ liên kết sâu trong ứng dụng Android TV, thì bạn nên có một định nghĩa tương tự được định cấu hình trong Tệp kê khai Android TV:

<activity android:name="com.example.activity">
  <intent-filter>
     <action android:name="android.intent.action.VIEW" />
     <category android:name="android.intent.category.DEFAULT" />
     <data android:scheme="https"/>
     <data android:host="www.example.com"/>
     <data android:pathPattern=".*"/>
  </intent-filter>
</activity>

Tải theo thực thể trên người gửi

Trên người gửi, bạn có thể chuyển liên kết sâu bằng cách đặt entity trong thông tin nội dung phương tiện cho yêu cầu tải:

Kotlin

val mediaToLoad = MediaInfo.Builder("some-id")
    .setEntity("https://example.com/watch/some-id")
    ...
    .build()
val loadRequest = MediaLoadRequestData.Builder()
    .setMediaInfo(mediaToLoad)
    .setCredentials("user-credentials")
    ...
    .build()
remoteMediaClient.load(loadRequest)

Android

Java

MediaInfo mediaToLoad =
    new MediaInfo.Builder("some-id")
        .setEntity("https://example.com/watch/some-id")
        ...
        .build();
MediaLoadRequestData loadRequest =
    new MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        ...
        .build();
remoteMediaClient.load(loadRequest);

iOS

let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id")
...
mediaInformation = mediaInfoBuilder.build()

let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder()
mediaLoadRequestDataBuilder.mediaInformation = mediaInformation
mediaLoadRequestDataBuilder.credentials = "user-credentials"
...
let mediaLoadRequestData = mediaLoadRequestDataBuilder.build()

remoteMediaClient?.loadMedia(with: mediaLoadRequestData)

Web

Yêu cầu phiên bản trình duyệt Chromium M87 trở lên.

let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4');
mediaInfo.entity = 'https://example.com/watch/some-id';
...

let request = new chrome.cast.media.LoadRequest(mediaInfo);
request.credentials = 'user-credentials';
...

cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);

Lệnh tải được gửi qua một ý định có liên kết sâu và 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.

Đặt thông tin xác thực ATV trên người gửi

Có thể ứng dụng Bộ thu web và ứng dụng Android TV của bạn hỗ trợ các đường liên kết sâu và credentials khác nhau (ví dụ: nếu bạn đang xử lý phương thức xác thực khác nhau trên hai nền tảng). Để giải quyết vấn đề này, bạn có thể cung cấp entity và credentials thay thế cho Android TV:

Android

Kotlin

val mediaToLoad = MediaInfo.Builder("some-id")
        .setEntity("https://example.com/watch/some-id")
        .setAtvEntity("myscheme://example.com/atv/some-id")
        ...
        .build()
val loadRequest = MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        .setAtvCredentials("atv-user-credentials")
        ...
        .build()
remoteMediaClient.load(loadRequest)

Java

MediaInfo mediaToLoad =
    new MediaInfo.Builder("some-id")
        .setEntity("https://example.com/watch/some-id")
        .setAtvEntity("myscheme://example.com/atv/some-id")
        ...
        .build();
MediaLoadRequestData loadRequest =
    new MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        .setAtvCredentials("atv-user-credentials")
        ...
        .build();
remoteMediaClient.load(loadRequest);

iOS

let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id")
mediaInfoBuilder.atvEntity = "myscheme://example.com/atv/some-id"
...
mediaInformation = mediaInfoBuilder.build()

let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder()
mediaLoadRequestDataBuilder.mediaInformation = mediaInformation
mediaLoadRequestDataBuilder.credentials = "user-credentials"
mediaLoadRequestDataBuilder.atvCredentials = "atv-user-credentials"
...
let mediaLoadRequestData = mediaLoadRequestDataBuilder.build()

remoteMediaClient?.loadMedia(with: mediaLoadRequestData)

Web

Yêu cầu phiên bản trình duyệt Chromium M87 trở lên.

let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4');
mediaInfo.entity = 'https://example.com/watch/some-id';
mediaInfo.atvEntity = 'myscheme://example.com/atv/some-id';
...

let request = new chrome.cast.media.LoadRequest(mediaInfo);
request.credentials = 'user-credentials';
request.atvCredentials = 'atv-user-credentials';
...

cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);

Nếu ứng dụng Bộ thu web được chạy, ứng dụng sẽ sử dụng entity và credentials trong yêu cầu tải. Tuy nhiên, nếu ứng dụng Android TV được chạy, SDK sẽ ghi đè entity và credentials bằng atvEntity và atvCredentials (nếu được chỉ định).

Tải theo Content ID hoặc MediaQueueData

Nếu không sử dụng entity hoặc atvEntity và đang sử dụng Content ID hoặc URL nội dung trong Thông tin nội dung đa phương tiện hoặc sử dụng Dữ liệu yêu cầu tải nội dung đa phương tiện chi tiết hơn, bạn cần thêm bộ lọc ý định được xác định trước sau đây trong ứng dụng Android TV:

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

Ở phía người gửi, tương tự như tải theo thực thể, bạn có thể tạo một yêu cầu tải với thông tin nội dung của mình và gọi load().

Android

Kotlin

val mediaToLoad = MediaInfo.Builder("some-id").build()
val loadRequest = MediaLoadRequestData.Builder()
    .setMediaInfo(mediaToLoad)
    .setCredentials("user-credentials")
    ...
    .build()
remoteMediaClient.load(loadRequest)

Java

MediaInfo mediaToLoad =
    new MediaInfo.Builder("some-id").build();
MediaLoadRequestData loadRequest =
    new MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        ...
        .build();
remoteMediaClient.load(loadRequest);

iOS

let mediaInfoBuilder = GCKMediaInformationBuilder(contentId: "some-id")
...
mediaInformation = mediaInfoBuilder.build()

let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder()
mediaLoadRequestDataBuilder.mediaInformation = mediaInformation
mediaLoadRequestDataBuilder.credentials = "user-credentials"
...
let mediaLoadRequestData = mediaLoadRequestDataBuilder.build()

remoteMediaClient?.loadMedia(with: mediaLoadRequestData)

Web

Yêu cầu phiên bản trình duyệt Chromium M87 trở lên.

let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4');
...

let request = new chrome.cast.media.LoadRequest(mediaInfo);
...

cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);

Xử lý yêu cầu tải

Trong hoạt động của bạn, để xử lý các yêu cầu tải này, bạn cần xử lý ý định trong phương thức gọi lại trong vòng đời hoạt động:

Kotlin

class MyActivity : Activity() {
  override fun onStart() {
    super.onStart()
    val mediaManager = CastReceiverContext.getInstance().getMediaManager()
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(intent)) {
        // If the SDK recognizes the intent, you should early return.
        return
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }

  // For some cases, a new load intent triggers onNewIntent() instead of
  // onStart().
  override fun onNewIntent(intent: Intent) {
    val mediaManager = CastReceiverContext.getInstance().getMediaManager()
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(intent)) {
        // If the SDK recognizes the intent, you should early return.
        return
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }
}

Java

public class MyActivity extends Activity {
  @Override
  protected void onStart() {
    super.onStart();
    MediaManager mediaManager =
        CastReceiverContext.getInstance().getMediaManager();
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(getIntent())) {
      // If the SDK recognizes the intent, you should early return.
      return;
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }

  // For some cases, a new load intent triggers onNewIntent() instead of
  // onStart().
  @Override
  protected void onNewIntent(Intent intent) {
    MediaManager mediaManager =
        CastReceiverContext.getInstance().getMediaManager();
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(intent)) {
      // If the SDK recognizes the intent, you should early return.
      return;
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }
}

Nếu phát hiện ý định tải MediaManager, ý định này sẽ trích xuất đối tượng MediaLoadRequestData từ ý định tải và gọi MediaLoadCommandCallback.onLoad(). Bạn cần ghi đè phương thức này để xử lý yêu cầu tải. Lệnh gọi lại phải được đăng ký trước khi gọi MediaManager.onNewIntent() (bạn nên sử dụng phương thức onCreate() của hoạt động hoặc ứng dụng).

Kotlin

class MyActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val mediaManager = CastReceiverContext.getInstance().getMediaManager()
        mediaManager.setMediaLoadCommandCallback(MyMediaLoadCommandCallback())
    }
}

class MyMediaLoadCommandCallback : MediaLoadCommandCallback() {
  override fun onLoad(
        senderId: String?,
        loadRequestData: MediaLoadRequestData
  ): Task {
      return Tasks.call {
        // Resolve the entity into your data structure and load media.
        val mediaInfo = loadRequestData.getMediaInfo()
        if (!checkMediaInfoSupported(mediaInfo)) {
            // Throw MediaException to indicate load failure.
            throw MediaException(
                MediaError.Builder()
                    .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED)
                    .setReason(MediaError.ERROR_REASON_INVALID_REQUEST)
                    .build()
            )
        }
        myFillMediaInfo(MediaInfoWriter(mediaInfo))
        myPlayerLoad(mediaInfo.getContentUrl())

        // Update media metadata and state (this clears all previous status
        // overrides).
        castReceiverContext.getMediaManager()
            .setDataFromLoad(loadRequestData)
        ...
        castReceiverContext.getMediaManager().broadcastMediaStatus()

        // Return the resolved MediaLoadRequestData to indicate load success.
        return loadRequestData
     }
  }

  private fun myPlayerLoad(contentURL: String) {
    myPlayer.load(contentURL)

    // Update the MediaSession state.
    val playbackState: PlaybackStateCompat = Builder()
        .setState(
            player.getState(), player.getPosition(), System.currentTimeMillis()
        )
        ...
        .build()
    mediaSession.setPlaybackState(playbackState)
  }

Java

public class MyActivity extends Activity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    MediaManager mediaManager =
        CastReceiverContext.getInstance().getMediaManager();
    mediaManager.setMediaLoadCommandCallback(new MyMediaLoadCommandCallback());
  }
}

public class MyMediaLoadCommandCallback extends MediaLoadCommandCallback {
  @Override
  public Task onLoad(String senderId, MediaLoadRequestData loadRequestData) {
    return Tasks.call(() -> {
        // Resolve the entity into your data structure and load media.
        MediaInfo mediaInfo = loadRequestData.getMediaInfo();
        if (!checkMediaInfoSupported(mediaInfo)) {
          // Throw MediaException to indicate load failure.
          throw new MediaException(
              new MediaError.Builder()
                  .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED)
                  .setReason(MediaError.ERROR_REASON_INVALID_REQUEST)
                  .build());
        }
        myFillMediaInfo(new MediaInfoWriter(mediaInfo));
        myPlayerLoad(mediaInfo.getContentUrl());

        // Update media metadata and state (this clears all previous status
        // overrides).
        castReceiverContext.getMediaManager()
            .setDataFromLoad(loadRequestData);
        ...
        castReceiverContext.getMediaManager().broadcastMediaStatus();

        // Return the resolved MediaLoadRequestData to indicate load success.
        return loadRequestData;
    });
}

private void myPlayerLoad(String contentURL) {
  myPlayer.load(contentURL);

  // Update the MediaSession state.
  PlaybackStateCompat playbackState =
      new PlaybackStateCompat.Builder()
          .setState(
              player.getState(), player.getPosition(), System.currentTimeMillis())
          ...
          .build();
  mediaSession.setPlaybackState(playbackState);
}

Để xử lý ý định tải, bạn có thể phân tích cú pháp ý định đó thành cấu trúc dữ liệu mà chúng tôi đã xác định (MediaLoadRequestData cho các yêu cầu tải).

Hỗ trợ các lệnh phương tiện

Hỗ trợ bộ điều khiển chế độ phát cơ bản

Các lệnh tích hợp cơ bản bao gồm các lệnh tương thích với phiên phát nội dung đa phương tiện. Những lệnh này được thông báo qua các lệnh gọi lại phiên đa phương tiện. Bạn cần đăng ký lệnh gọi lại đến phiên phát nội dung đa phương tiện để hỗ trợ việc này (có thể bạn đã thực hiện việc này rồi).

Kotlin

private class MyMediaSessionCallback : MediaSessionCompat.Callback() {
  override fun onPause() {
    // Pause the player and update the play state.
    myPlayer.pause()
  }

  override fun onPlay() {
    // Resume the player and update the play state.
    myPlayer.play()
  }

  override fun onSeekTo(pos: Long) {
    // Seek and update the play state.
    myPlayer.seekTo(pos)
  }
    ...
 }

mediaSession.setCallback(MyMediaSessionCallback())

Java

private class MyMediaSessionCallback extends MediaSessionCompat.Callback {
  @Override
  public void onPause() {
    // Pause the player and update the play state.
    myPlayer.pause();
  }
  @Override
  public void onPlay() {
    // Resume the player and update the play state.
    myPlayer.play();
  }
  @Override
  public void onSeekTo(long pos) {
    // Seek and update the play state.
    myPlayer.seekTo(pos);
  }

  ...
}

mediaSession.setCallback(new MyMediaSessionCallback());

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

Có một số lệnh Truyền không có trong MediaSession, chẳng hạn như skipAd() hoặc setActiveMediaTracks(). Ngoài ra, một số lệnh trong hàng đợi cần được triển khai tại đây vì hàng đợi Truyền không tương thích hoàn toàn với hàng đợi MediaSession.

Kotlin

class MyMediaCommandCallback : MediaCommandCallback() {
    override fun onSkipAd(requestData: RequestData?): Task {
        // Skip your ad
        ...
        return Tasks.forResult(null)
    }
}

val mediaManager = CastReceiverContext.getInstance().getMediaManager()
mediaManager.setMediaCommandCallback(MyMediaCommandCallback())

Java

public class MyMediaCommandCallback extends MediaCommandCallback {
  @Override
  public Task onSkipAd(RequestData requestData) {
    // Skip your ad
    ...
    return Tasks.forResult(null);
  }
}

MediaManager mediaManager =
    CastReceiverContext.getInstance().getMediaManager();
mediaManager.setMediaCommandCallback(new MyMediaCommandCallback());

Chỉ định các lệnh nội dung nghe nhìn được hỗ trợ

Cũng giống như với bộ thu Cast, ứng dụng Android TV phải chỉ định những lệnh được hỗ trợ để người gửi có thể bật hoặc tắt một số chế độ điều khiển trên giao diện người dùng. Đối với các lệnh thuộc MediaSession, hãy chỉ định các lệnh trong PlaybackStateCompat. Bạn nên chỉ định thêm các lệnh khác trong MediaStatusModifier.

Kotlin

// Set media session supported commands
val playbackState: PlaybackStateCompat = PlaybackStateCompat.Builder()
    .setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PAUSE)
    .setState(PlaybackStateCompat.STATE_PLAYING)
    .build()

mediaSession.setPlaybackState(playbackState)

// Set additional commands in MediaStatusModifier
val mediaManager = CastReceiverContext.getInstance().getMediaManager()
mediaManager.getMediaStatusModifier()
    .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT)

Java

// Set media session supported commands
PlaybackStateCompat playbackState =
    new PlaybackStateCompat.Builder()
        .setActions(PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PAUSE)
        .setState(PlaybackStateCompat.STATE_PLAYING)
        .build();

mediaSession.setPlaybackState(playbackState);

// Set additional commands in MediaStatusModifier
MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager();
mediaManager.getMediaStatusModifier()
            .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT);

Ẩn các nút không được hỗ trợ

Nếu ứng dụng Android TV chỉ hỗ trợ chế độ điều khiển nội dung nghe nhìn cơ bản nhưng ứng dụng Web receiver sẽ hỗ trợ chế độ kiểm soát nâng cao hơn, thì bạn nên đảm bảo ứng dụng của người gửi hoạt động chính xác khi truyền đến ứng dụng Android TV. Ví dụ: Nếu ứng dụng Android TV không hỗ trợ thay đổi tốc độ phát trong khi ứng dụng Web receiver được đặt, bạn nên đặt chính xác các thao tác được hỗ trợ trên từng nền tảng và đảm bảo ứng dụng người gửi hiển thị đúng giao diện người dùng.

Sửa đổi MediaStatus

Để hỗ trợ các tính năng nâng cao như kênh, quảng cáo, trực tiếp và hàng đợi, ứng dụng Android TV cần cung cấp thêm thông tin không thể xác định được qua MediaSession.

Chúng tôi cung cấp lớp MediaStatusModifier để bạn đạt được điều này. MediaStatusModifier sẽ luôn hoạt động trên MediaSession mà bạn đã đặt trong CastReceiverContext.

Để tạo và phát MediaStatus:

Kotlin

val mediaManager: MediaManager = castReceiverContext.getMediaManager()
val statusModifier: MediaStatusModifier = mediaManager.getMediaStatusModifier()

statusModifier
    .setLiveSeekableRange(seekableRange)
    .setAdBreakStatus(adBreakStatus)
    .setCustomData(customData)

mediaManager.broadcastMediaStatus()

Java

MediaManager mediaManager = castReceiverContext.getMediaManager();
MediaStatusModifier statusModifier = mediaManager.getMediaStatusModifier();

statusModifier
    .setLiveSeekableRange(seekableRange)
    .setAdBreakStatus(adBreakStatus)
    .setCustomData(customData);

mediaManager.broadcastMediaStatus();

Thư viện ứng dụng của chúng tôi sẽ lấy cơ sở MediaStatus từ MediaSession, ứng dụng Android TV của bạn có thể chỉ định trạng thái bổ sung và ghi đè trạng thái thông qua phương thức sửa đổi MediaStatus.

Một số trạng thái và siêu dữ liệu có thể thiết lập cả trong MediaSession và MediaStatusModifier. Bạn đặc biệt nên chỉ đặt các giá trị này trong MediaSession. Bạn vẫn có thể sử dụng công cụ sửa đổi để ghi đè trạng thái trong MediaSession. Điều này không được khuyến khích vì trạng thái trong công cụ sửa đổi luôn có mức độ ưu tiên cao hơn các giá trị do MediaSession cung cấp.

Chặn InterStatus trước khi gửi

Giống như SDK Web receiver, nếu muốn thực hiện một số bước hoàn tất trước khi gửi đi, bạn có thể chỉ định MediaStatusInterceptor để xử lý MediaStatus sẽ được gửi. Chúng ta truyền vào một MediaStatusWriter để thao tác với MediaStatus trước khi gửi đi.

Kotlin

mediaManager.setMediaStatusInterceptor(object : MediaStatusInterceptor {
    override fun intercept(mediaStatusWriter: MediaStatusWriter) {
      // Perform customization.
        mediaStatusWriter.setCustomData(JSONObject("{data: \"my Hello\"}"))
    }
})

Java

mediaManager.setMediaStatusInterceptor(new MediaStatusInterceptor() {
    @Override
    public void intercept(MediaStatusWriter mediaStatusWriter) {
        // Perform customization.
        mediaStatusWriter.setCustomData(new JSONObject("{data: \"my Hello\"}"));
    }
});

Xử lý thông tin xác thực của người dùng

Ứng dụng Android TV của bạn có thể chỉ cho phép một số người dùng khởi chạy hoặc tham gia phiên hoạt động của ứng dụng. Ví dụ: chỉ cho phép người gửi chạy hoặc tham gia nếu:

Ứng dụng của người gửi được đăng nhập vào cùng một tài khoản và hồ sơ như ứng dụng ATV.
Ứng dụng của người gửi được đăng nhập vào cùng một tài khoản, nhưng khác hồ sơ với ứng dụng ATV.

Nếu ứng dụng của bạn có thể xử lý nhiều người dùng hoặc ẩn danh, bạn có thể cho phép thêm bất kỳ người dùng nào tham gia phiên ATV. Nếu người dùng cung cấp thông tin đăng nhập, ứng dụng ATV của bạn cần xử lý thông tin đăng nhập của họ để có thể theo dõi đúng tiến trình và dữ liệu người dùng khác.

Khi ứng dụng người gửi của bạn chạy hoặc tham gia ứng dụng Android TV, ứng dụng người gửi phải cung cấp thông tin đăng nhập đại diện cho những người đang tham gia phiên này.

Trước khi người gửi chạy và tham gia ứng dụng Android TV, bạn có thể chỉ định trình kiểm tra khởi chạy để xem thông tin xác thực người gửi có được cho phép hay không. Nếu không, SDK Truyền kết nối sẽ quay lại chạy Bộ thu web.

Dữ liệu thông tin đăng nhập khởi chạy ứng dụng của người gửi

Ở phía người gửi, bạn có thể chỉ định CredentialsData để thể hiện người tham gia phiên.

credentials là một chuỗi có thể do người dùng xác định, miễn là ứng dụng ATV của bạn có thể hiểu được chuỗi đó. credentialsType xác định nền tảng mà CredentialsData xuất phát từ đó hoặc có thể là giá trị tuỳ chỉnh. Theo mặc định, giá trị này được đặt thành nền tảng đang gửi đi.

CredentialsData chỉ được chuyển đến ứng dụng Android TV của bạn trong thời gian chạy hoặc tham gia. Nếu bạn đặt lại hồ sơ một lần nữa trong khi kết nối, thì hồ sơ đó sẽ không được chuyển đến ứng dụng Android TV của bạn. Nếu người gửi chuyển đổi hồ sơ khi đã kết nối, bạn có thể ở trong phiên này hoặc gọi SessionManager.endCurrentCastSession(boolean stopCasting) nếu cho rằng hồ sơ mới không tương thích với phiên hoạt động.

CredentialsData cho mỗi người gửi có thể được truy xuất bằng getSenders trên CastReceiverContext để lấy SenderInfo, getCastLaunchRequest() để lấy CastLaunchRequest và sau đó là getCredentialsData().

Android

Yêu cầu play-services-cast-framework phiên bản 19.0.0 trở lên.

Kotlin

CastContext.getSharedInstance().setLaunchCredentialsData(
    CredentialsData.Builder()
        .setCredentials("{\"userId\": \"abc\"}")
        .build()
)

Java

CastContext.getSharedInstance().setLaunchCredentialsData(
    new CredentialsData.Builder()
        .setCredentials("{\"userId\": \"abc\"}")
        .build());

iOS

Yêu cầu google-cast-sdk phiên bản v4.7.0 trở lên.

Bạn có thể gọi bất cứ lúc nào sau khi đặt các tuỳ chọn: GCKCastContext.setSharedInstanceWith(options).

GCKCastContext.sharedInstance().setLaunch(
    GCKCredentialsData(credentials: "{\"userId\": \"abc\"}")

Web

Yêu cầu phiên bản trình duyệt Chromium M87 trở lên.

Bạn có thể gọi bất cứ lúc nào sau khi đặt các tuỳ chọn: cast.framework.CastContext.getInstance().setOptions(options);.

let credentialsData =
    new chrome.cast.CredentialsData("{\"userId\": \"abc\"}");
cast.framework.CastContext.getInstance().setLaunchCredentialsData(credentialsData);

Triển khai trình kiểm tra yêu cầu khởi chạy ATV

CredentialsData được chuyển đến ứng dụng Android TV khi người gửi cố gắng chạy hoặc tham gia. Bạn có thể triển khai LaunchRequestChecker. để cho phép hoặc từ chối yêu cầu này.

Nếu một yêu cầu bị từ chối, thì Trình thu thập dữ liệu web sẽ được tải thay vì chạy gốc vào ứng dụng ATV. Bạn nên từ chối yêu cầu nếu ATV của bạn không thể xử lý người dùng yêu cầu khởi chạy hoặc tham gia. Ví dụ: Người dùng đăng nhập vào ứng dụng ATV khác với yêu cầu và ứng dụng không thể xử lý thông tin chuyển đổi hoặc hiện không có người dùng nào đăng nhập vào ứng dụng ATV.

Nếu một yêu cầu được cho phép, ứng dụng ATV sẽ khởi chạy. Bạn có thể tuỳ chỉnh hành vi này tuỳ thuộc vào việc ứng dụng của bạn có hỗ trợ việc gửi yêu cầu tải khi người dùng không đăng nhập vào ứng dụng ATV hay không, nếu có người dùng không khớp. Hành vi này hoàn toàn có thể xảy ra trong LaunchRequestChecker.

Tạo một lớp triển khai giao diện CastReceiverOptions.LaunchRequestChecker:

Kotlin

class MyLaunchRequestChecker : LaunchRequestChecker {
  override fun checkLaunchRequestSupported(launchRequest: CastLaunchRequest): Task {
    return Tasks.call {
      myCheckLaunchRequest(
           launchRequest
      )
    }
  }
}

private fun myCheckLaunchRequest(launchRequest: CastLaunchRequest): Boolean {
  val credentialsData = launchRequest.getCredentialsData()
     ?: return false // or true if you allow anonymous users to join.

  // The request comes from a mobile device, e.g. checking user match.
  return if (credentialsData.credentialsType == CredentialsData.CREDENTIALS_TYPE_ANDROID) {
     myCheckMobileCredentialsAllowed(credentialsData.getCredentials())
  } else false // Unrecognized credentials type.
}

Java

public class MyLaunchRequestChecker
    implements CastReceiverOptions.LaunchRequestChecker {
  @Override
  public Task checkLaunchRequestSupported(CastLaunchRequest launchRequest) {
    return Tasks.call(() -> myCheckLaunchRequest(launchRequest));
  }
}

private boolean myCheckLaunchRequest(CastLaunchRequest launchRequest) {
  CredentialsData credentialsData = launchRequest.getCredentialsData();
  if (credentialsData == null) {
    return false;  // or true if you allow anonymous users to join.
  }

  // The request comes from a mobile device, e.g. checking user match.
  if (credentialsData.getCredentialsType().equals(CredentialsData.CREDENTIALS_TYPE_ANDROID)) {
    return myCheckMobileCredentialsAllowed(credentialsData.getCredentials());
  }

  // Unrecognized credentials type.
  return false;
}

Sau đó, đặt giá trị này trong ReceiverOptionsProvider của bạn:

Kotlin

class MyReceiverOptionsProvider : ReceiverOptionsProvider {
  override fun getOptions(context: Context?): CastReceiverOptions {
    return CastReceiverOptions.Builder(context)
        ...
        .setLaunchRequestChecker(MyLaunchRequestChecker())
        .build()
  }
}

Java

public class MyReceiverOptionsProvider implements ReceiverOptionsProvider {
  @Override
  public CastReceiverOptions getOptions(Context context) {
    return new CastReceiverOptions.Builder(context)
        ...
        .setLaunchRequestChecker(new MyLaunchRequestChecker())
        .build();
  }
}

Việc phân giải true trong LaunchRequestChecker sẽ khởi chạy ứng dụng ATV và false chạy ứng dụng Bộ thu web.

Gửi và nhận tin nhắn tùy chỉnh

Giao thức Truyền cho phép bạn gửi tin nhắn chuỗi tuỳ chỉnh giữa người gửi và ứng dụng người nhận. Bạn phải đăng ký một vùng chứa tên (kênh) để gửi thông báo trước khi khởi chạy CastReceiverContext.

Android TV – Chỉ định vùng chứa tên tuỳ chỉnh

Bạn cần chỉ định vùng chứa tên được hỗ trợ trong CastReceiverOptions trong quá trình thiết lập:

Kotlin

class MyReceiverOptionsProvider : ReceiverOptionsProvider {
  override fun getOptions(context: Context?): CastReceiverOptions {
    return CastReceiverOptions.Builder(context)
        .setCustomNamespaces(
            Arrays.asList("urn:x-cast:com.example.cast.mynamespace")
        )
        .build()
  }
}

Java

public class MyReceiverOptionsProvider implements ReceiverOptionsProvider {
  @Override
  public CastReceiverOptions getOptions(Context context) {
    return new CastReceiverOptions.Builder(context)
        .setCustomNamespaces(
              Arrays.asList("urn:x-cast:com.example.cast.mynamespace"))
        .build();
  }
}

Android TV – Gửi tin nhắn

Kotlin

// If senderId is null, then the message is broadcasted to all senders.
CastReceiverContext.getInstance().sendMessage(
    "urn:x-cast:com.example.cast.mynamespace", senderId, customString)

Java

// If senderId is null, then the message is broadcasted to all senders.
CastReceiverContext.getInstance().sendMessage(
    "urn:x-cast:com.example.cast.mynamespace", senderId, customString);

Android TV — Nhận thông báo Không gian tên tùy chỉnh

Kotlin

class MyCustomMessageListener : MessageReceivedListener {
    override fun onMessageReceived(
        namespace: String, senderId: String?, message: String ) {
        ...
    }
}

CastReceiverContext.getInstance().setMessageReceivedListener(
    "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());

Java

class MyCustomMessageListener implements CastReceiverContext.MessageReceivedListener {
  @Override
  public void onMessageReceived(
      String namespace, String senderId, String message) {
    ...
  }
}

CastReceiverContext.getInstance().setMessageReceivedListener(
    "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());

Tổng quan

Tiếp

Bản nhạc