إضافة الميزات الأساسية إلى جهاز استقبال Android TV

تحتوي هذه الصفحة على مقتطفات رمز ووصف للميزات المتاحة تخصيص تطبيق جهاز استقبال Android TV.

إعداد المكتبات

لإتاحة واجهات برمجة تطبيقات Cast Connect لتطبيق Android TV:

أجهزة Android
  1. افتح ملف build.gradle داخل دليل وحدة التطبيق.
  2. تأكَّد من أنّ google() مدرَج في repositories المدرَج.
      repositories {
        google()
      }
  3. بناءً على نوع الجهاز الذي يستهدفه تطبيقك، أضِف أحدث الإصدارات. المكتبات ضمن التبعيات لديك:
    • بالنسبة إلى تطبيق "جهاز استقبال Android":
        dependencies {
          implementation 'com.google.android.gms:play-services-cast-tv:21.1.0'
          implementation 'com.google.android.gms:play-services-cast:21.5.0'
        }
    • بالنسبة إلى تطبيق Android Sender:
        dependencies {
          implementation 'com.google.android.gms:play-services-cast:21.1.0'
          implementation 'com.google.android.gms:play-services-cast-framework:21.5.0'
        }
    تأكد من تحديث رقم الإصدار هذا في كل مرة يتم فيها تحديث الخدمات.
  4. احفظ التغييرات وانقر على Sync Project with Gradle Files في شريط الأدوات.
iOS
  1. تأكَّد من أنّ "Podfile" يستهدف الإصدار 4.8.3 من "google-cast-sdk" أو أعلى
  2. استهداف الإصدار 14 من نظام التشغيل iOS أو الإصدارات الأحدث يُرجى الاطّلاع على ملاحظات الإصدار. لمزيد من التفاصيل.
      platform: ios, '14'
    
      def target_pods
         pod 'google-cast-sdk', '~>4.8.3'
      end
الويب
  1. يجب استخدام الإصدار M87 من متصفّح Chromium أو إصدار أحدث.
  2. إضافة مكتبة Web Sender API إلى مشروعك
      <script src="//www.gstatic.com/cv/js/sender/v1/cast_sender.js?loadCastFramework=1"></script>

متطلبات AndroidX

تتطلب الإصدارات الجديدة من "خدمات Google Play" تحديث التطبيق لتتمكّن من استخدامه مساحة الاسم androidx. اتّبِع التعليمات الانتقال إلى AndroidX

المتطلبات الأساسية لتطبيق Android TV

لإتاحة استخدام Cast Connect في تطبيق Android TV، يجب إنشاء دعم الأحداث من جلسة وسائط. البيانات المقدَّمة من جلسة الوسائط لتقديم المعلومات الأساسية - على سبيل المثال، الموضع وحالة التشغيل وما إلى ذلك - حالة الوسائط. تستخدم مكتبة Cast Connect جلسة الوسائط أيضًا. للإشارة إلى وقت استلامه لرسائل معيّنة من مُرسِل معيّن، مثل الإيقاف المؤقّت.

لمزيد من المعلومات حول جلسة الوسائط وكيفية إعداد جلسة وسائط، اطّلِع على العمل باستخدام دليل جلسات الوسائط.

دورة حياة جلسة الوسائط

من المفترض أن ينشئ تطبيقك جلسة وسائط عند بدء التشغيل ثم يصدره عند بدء التشغيل. لم يعد من الممكن التحكم فيه. على سبيل المثال، إذا كان تطبيقك عبارة عن تطبيق فيديو، تحرير الجلسة عند خروج المستخدم من نشاط التشغيل - إما من خلال النقر على "رجوع" لتصفّح محتوى آخر أو تنزيل التطبيق في الخلفية إذا كان عبارة عن تطبيق موسيقى، يجب إصداره عندما يتوقّف تطبيقك عن تشغيل أي الوسائط.

جارٍ تعديل حالة الجلسة

ينبغي الحفاظ على تحديث بيانات جلسة الوسائط الخاصة بك باستمرار مع حالة لاعب. على سبيل المثال، عند إيقاف التشغيل مؤقتًا، يجب تحديث التشغيل بالإضافة إلى الإجراءات المتوافقة. تسرد الجداول التالية حالات فأنت مسئول عن التحديثات.

MediaMetadataCompat

حقل البيانات الوصفية الوصف
METADATA_KEY_TITLE (مطلوبة) عنوان الوسائط
METADATA_KEY_DISPLAY_SUBTITLE العنوان الفرعي.
METADATA_KEY_DISPLAY_ICON_URI تمثّل هذه السمة عنوان URL للرمز.
METADATA_KEY_DURATION (مطلوبة) مدة الوسائط.
METADATA_KEY_MEDIA_URI Content ID
METADATA_KEY_ARTIST الفنّان
METADATA_KEY_ALBUM الألبوم

PlaybackStateCompat

الطريقة المطلوبة الوصف
setActions() لضبط أوامر الوسائط المتوافقة.
setState() ضبط حالة التشغيل والموضع الحالي

MediaSessionCompat

الطريقة المطلوبة الوصف
setRepeatMode() لضبط وضع التكرار.
setShuffleMode() لضبط وضع الترتيب العشوائي.
setMetadata() لضبط البيانات الوصفية للوسائط.
setPlaybackState() لضبط حالة التشغيل.
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);
}

مناولة التحكم في النقل

يجب أن ينفّذ تطبيقك استدعاء التحكّم في نقل جلسة الوسائط. تشير رسالة الأشكال البيانية يوضح الجدول التالي إجراءات التحكم في النقل التي يتعين عليهم معالجتها:

MediaSessionCompat.Callback

المهام الوصف
onPlay() استئناف
onPause() إيقاف مؤقت
onSeekTo() الترجيع إلى موضع
onStop() إيقاف الوسائط الحالية
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());

ضبط دعم Cast

عندما يرسل أحد تطبيقات المرسل طلب تشغيل، يتم إنشاء هدف مع مساحة اسم التطبيق. تطبيقك مسؤول عن معالجته. وإنشاء مثيل CastReceiverContext كائن عند تشغيل تطبيق البث التلفزيوني. يجب إدخال كائن CastReceiverContext. للتفاعل مع البثّ أثناء تشغيل تطبيق التلفزيون. يتيح هذا العنصر للتلفزيون لقبول رسائل وسائط البث الواردة من أي مرسلين متصلين.

إعداد Android TV

إضافة فلتر أهداف الإطلاق

إضافة فلتر أهداف جديد إلى النشاط الذي تريد التعامل معه لإطلاق التطبيق النية من تطبيق المُرسِل:

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

تحديد موفّر خيارات المستلِم

أنت بحاجة إلى تنفيذ ReceiverOptionsProvider لتوفير 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();
  }
}

بعد ذلك، حدِّد موفّر الخيارات في AndroidManifest:

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

تُستخدَم السمة ReceiverOptionsProvider لتوفير CastReceiverOptions في حال تم إعداد CastReceiverContext.

سياق مستقبِل البث

تهيئة CastReceiverContext عند إنشاء تطبيقك:

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

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

  ...
}

بدء "CastReceiverContext" عند انتقال تطبيقك إلى المقدّمة:

Kotlin
CastReceiverContext.getInstance().start()
Java
CastReceiverContext.getInstance().start();

اتصل stop() في صفحة CastReceiverContext بعد انتقال التطبيق إلى الخلفية عند تشغيل تطبيقات الفيديو أو التطبيقات التي لا تعمل التشغيل في الخلفية:

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

بالإضافة إلى ذلك، إذا كان تطبيقك يتيح التشغيل في الخلفية، اتّصِل بالرقم stop(). في CastReceiverContext عندما يتوقف تشغيله في الخلفية.

ننصحك بشدة باستخدام LifecycleObserver من androidx.lifecycle مكتبة لإدارة المكالمات CastReceiverContext.start() أو CastReceiverContext.stop()، خاصةً إذا كان التطبيق المحلي يتضمّن أنشطة متعددة هذا يتجنب العرق حالات عند الاتصال بـ start() وstop() من أنشطة مختلفة.

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">

ربط MediaSession بـ MediaManager

عند إنشاء MediaSession, يجب أيضًا تقديم الرمز المميّز الحالي من MediaSession إلى CastReceiverContext كي يعرف مكان إرسال الأوامر واسترداد حالة تشغيل الوسائط:

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

عند إصدار "MediaSession" بسبب تشغيل غير نشط، يجب ضبط هناك رمز مميّز فارغ مفعَّل MediaManager:

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

إذا كان تطبيقك يتيح تشغيل الوسائط أثناء تشغيله في الخلفية، يمكنك بدلاً من ذلك من إجراء المكالمات CastReceiverContext.stop() عند إرسال تطبيقك إلى الخلفية، يجب عدم الاتصال به إلا إذا كان تطبيقك يتم تشغيلها في الخلفية ولم يعد يتم تشغيل الوسائط. على سبيل المثال:

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();
  }
}

استخدام Exoplayer مع Cast Connect

في حال استخدام Exoplayer، يمكنك استخدام MediaSessionConnector للحفاظ على الجلسة تلقائيًا وجميع المعلومات ذات الصلة، بما في ذلك بدلاً من تتبع التغييرات يدويًا.

MediaSessionConnector.MediaButtonEventHandler للتعامل مع أحداث MediaButton من خلال استدعاء setMediaButtonEventHandler(MediaButtonEventHandler) والتي يتم التعامل معها بطريقة أخرى بواسطة MediaSessionCompat.Callback تلقائيًا.

للدمج MediaSessionConnector في تطبيقك، أضِف ما يلي إلى صف نشاط اللاعبين أو إلى أي مكان إدارة جلسة الوسائط:

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);
    ...
  }
}

إعداد تطبيق المرسِل

تفعيل دعم Cast Connect

بعد تحديث تطبيق المرسِل لاستخدام دعم Cast Connect، يمكنك الإفصاح عن جاهزيتها من خلال وضع androidReceiverCompatible تنبيه في LaunchOptions إلى true.

أجهزة Android

يجب توفُّر إصدار play-services-cast-framework 19.0.0 أو أعلى.

تم ضبط العلامة androidReceiverCompatible في LaunchOptions (التي هي جزء من 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

يجب توفّر الإصدار v4.4.8 من google-cast-sdk أو أعلى.

تم ضبط العلامة androidReceiverCompatible في GCKLaunchOptions (والذي يعد جزءًا من GCKCastOptions):

let options = GCKCastOptions(discoveryCriteria: GCKDiscoveryCriteria(applicationID: kReceiverAppID))
...
let launchOptions = GCKLaunchOptions()
launchOptions.androidReceiverCompatible = true
options.launchOptions = launchOptions
GCKCastContext.setSharedInstanceWith(options)
الويب

يتطلب متصفّح Chromium M87 أو أعلى.

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

إعداد وحدة تحكم مطوّري البرامج للبث

إعداد تطبيق Android TV

أضِف اسم حزمة تطبيق Android TV في وحدة تحكم مطوّري برامج Cast لربطه برقم تعريف تطبيق Cast

تسجيل أجهزة المطوِّرين

تسجيل الرقم التسلسلي لجهاز Android TV الذي تريد استخدامه للتطوير في وحدة تحكم مطوّري برامج Cast

بدون التسجيل، لن تعمل ميزة Cast Connect إلا مع التطبيقات المثبَّتة من خلال لأسباب تتعلق بالأمان، "متجر Google Play".

لمزيد من المعلومات عن تسجيل جهاز يعمل بتكنولوجيا Google Cast أو Android TV للبث التطوير، راجع صفحة التسجيل.

جارٍ تحميل الوسائط

إذا سبق لك إتاحة الروابط لصفحات معيّنة في تطبيق Android TV، يجب أن يكون لديك تعريف مشابه تم ضبطه في بيان 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>

التحميل حسب الكيان على المُرسِل

في المرسِلين، يمكنك نقل الرابط لصفحة في التطبيق من خلال ضبط entity في الوسائط. معلومات حول طلب التحميل:

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)
الويب

يتطلب متصفّح Chromium M87 أو أعلى.

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);

يتم إرسال أمر التحميل من خلال عنصر intent مع رابط الصفحة في التطبيق واسم الحزمة التي حددتها في وحدة تحكم المطوّرين.

جارٍ ضبط بيانات اعتماد ATV على المُرسِل

من المحتمل أن يختلف تطبيق WebRecipient عن تطبيق Android TV. روابط لصفحات في التطبيق وcredentials (على سبيل المثال، إذا كنت بصدد معالجة المصادقة) بشكل مختلف على النظامين الأساسيين). لمعالجة هذه المشكلة، يمكنك تقديم خيارات بديلة entity وcredentials لـ 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)
الويب

يتطلب متصفّح Chromium M87 أو أعلى.

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);

إذا تم تشغيل تطبيق WebRecipient، سيستخدم entity وcredentials في طلب التحميل. مع ذلك، إذا تم تشغيل تطبيق Android TV، سيلغي حزمة تطوير البرامج (SDK) entity وcredentials مع atvEntity وatvCredentials (إذا كان محدَّدًا).

التحميل بواسطة Content ID أو Media playlistData

إذا لم تكن تستخدم entity أو atvEntity وكنت تستخدم Content ID أو عنوان URL للمحتوى في "معلومات الوسائط" أو استخدِم تحميل الوسائط الأكثر تفصيلاً طلب البيانات، عليك إضافة فلتر الأهداف المحدَّد مسبقًا التالي إلى تطبيق 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>

من جانب المُرسِل، على غرار التحميل حسب الكيان، يمكنك إنشاء طلب تحميل بمعلومات المحتوى الخاص بك والاتصال بـ 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)
الويب

يتطلب متصفّح Chromium M87 أو أعلى.

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);

معالجة طلبات التحميل

في نشاطك، لمعالجة طلبات التحميل هذه، عليك التعامل مع الأهداف في عمليات الاستدعاء في مراحل نشاط نشاطك:

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

في حال MediaManager أن المقصد هو المقصود بالتحميل، فإنه يستخلص MediaLoadRequestData كائنًا من الغرض، واستدعاء MediaLoadCommandCallback.onLoad() وعليك إلغاء هذه الطريقة لمعالجة طلب التحميل. يجب أن يكون رد الاتصال أن تكون مسجَّلاً قبل MediaManager.onNewIntent() (يوصى بأن تكون في نشاط أو تطبيق onCreate() ).

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);
}

لمعالجة الغرض من التحميل، يمكنك تحليل الهدف إلى بُنى البيانات. حددنا (MediaLoadRequestData) لطلبات التحميل).

إتاحة طلبات الوسائط

الدعم الأساسي للتحكّم في التشغيل

تشمل أوامر الدمج الأساسية الأوامر المتوافقة مع الوسائط جلسة المراجعة. يتم إرسال إشعارات إلى هذه الأوامر من خلال عمليات معاودة الاتصال لجلسات الوسائط. عليك إجراء ما يلي: قم بتسجيل معاودة الاتصال بجلسة الوسائط لدعم ذلك (ربما تقوم بذلك بالفعل).

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());

إتاحة أوامر التحكم في البث

هناك بعض أوامر البث غير متوفرة في MediaSession, مثل skipAd() أو setActiveMediaTracks() يجب أيضًا تنفيذ بعض أوامر قائمة الانتظار هنا لأن قائمة انتظار الإرسال غير متوافق بالكامل مع قائمة الانتظار 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());

تحديد أوامر الوسائط المتوافقة

كما هو الحال في جهاز استقبال البث، من المفترض أن يحدد تطبيق Android TV الأوامر متاحة، لذلك يمكن للمُرسِلين تفعيل عناصر تحكّم معيّنة في واجهة المستخدم أو إيقافها. بالنسبة والأوامر التي تشكل جزءًا من MediaSession, تحديد الأوامر في PlaybackStateCompat يجب تحديد الأوامر الإضافية في 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);

إخفاء الأزرار غير المتوافقة

إذا كان تطبيق Android TV لا يتيح سوى التحكّم الأساسي في الوسائط، ولكن مع جهاز استقبال الويب يدعم التطبيق تحكمًا أكثر تقدمًا، فيجب عليك التأكد من أن تطبيق المرسل يعمل بشكل صحيح عند البث إلى تطبيق Android TV على سبيل المثال، إذا كان Android TV لا يتيح التطبيق تغيير معدّل التشغيل بينما لا يتيح تطبيق WebRecipient. يجب ضبط الإجراءات المتوافقة بشكل صحيح على كل منصة والتأكّد من يعرض تطبيق المرسِل واجهة المستخدم بشكل صحيح.

تعديل حالة الوسائط

للاستفادة من الميزات المتقدّمة، مثل المقاطع الصوتية والإعلانات والبث المباشر والإضافة إلى قائمة المحتوى التالي، يمكنك يحتاج تطبيق البث التلفزيوني إلى تقديم معلومات إضافية لا يمكن التحقق منها عبر MediaSession

نحن نقدم MediaStatusModifier الصف لك لتحقيق ذلك. سيعمل MediaStatusModifier دائمًا على MediaSession الذي ضبطته في CastReceiverContext

لإنشاء البث وبثّه 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();

ستحصل مكتبة العملاء على MediaStatus الأساسي من MediaSession، وهو يمكن لتطبيق Android TV تحديد حالة إضافية وإلغاء الحالة من خلال مفتاح التعديل MediaStatus

يمكن ضبط بعض الحالات والبيانات الوصفية في MediaSession و MediaStatusModifier ننصحك بشدة بتحديدها في MediaSession لا يزال بإمكانك استخدام المعدِّل لإلغاء الحالات في MediaSession—لا يُنصح بهذا الإجراء لأنّ الحالة في المُعدِّل تكون دائمًا تحظى بأولوية أعلى من القيم المقدَّمة من MediaSession.

الاعتراض على حالة الوسائط قبل إرسالها

تمامًا مثل حزمة WebRecipient، إذا كنت تريد إجراء بعض اللمسات النهائية قبل إرسال، يمكنك تحديد MediaStatusInterceptor لمعالجة MediaStatus إلى إرسال الملخصات. نمرر في MediaStatusWriter لمعالجة MediaStatus قبل إرسالها.

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\"}"));
    }
});

التعامل مع بيانات اعتماد المستخدم

قد يسمح تطبيق Android TV لبعض المستخدمين فقط بتشغيل التطبيق أو الانضمام إليه. جلسة المراجعة. على سبيل المثال، يمكنك السماح للمُرسِل بالإطلاق أو الانضمام فقط في الحالات التالية:

  • تم تسجيل دخول تطبيق المرسِل إلى الحساب والملف الشخصي نفسه الذي يستخدمه تطبيق ATV.
  • تم تسجيل دخول تطبيق المرسِل إلى الحساب نفسه، ولكن في ملف شخصي مختلف لتطبيق ATV.

إذا كان تطبيقك يمكن التعامل مع مستخدمين مجهولين أو متعددين، يمكنك السماح لأي مستخدم الانضمام إلى جلسة ATV. إذا قدّم المستخدم بيانات الاعتماد، سيتم تشغيل تطبيق ATV. إلى معالجة بيانات الاعتماد الخاصة بهم حتى يمكن إنجاز تقدمهم وبيانات المستخدم الأخرى يتم تتبعها بشكل صحيح.

عند تشغيل تطبيق Android TV أو انضمامه إلى تطبيق المُرسِل، سيستخدم هذا التطبيق يجب توفير بيانات الاعتماد التي تمثل الشخص الذي سينضم إلى الجلسة.

قبل تشغيل تطبيق Android TV وانضمامه إلى المُرسِل، يمكنك تحديد مدقق التشغيل لمعرفة ما إذا كانت بيانات اعتماد المرسل مسموحًا بها. وإلا، سيتم إرسال المحتوى تعود حزمة Connect SDK إلى إطلاق جهاز استقبال الويب.

بيانات اعتماد تشغيل تطبيق المُرسِل

من جانب المُرسِل، يمكنك تحديد CredentialsData لتمثيل للانضمام إلى الجلسة.

credentials عبارة عن سلسلة يمكن تحديدها من خلال المستخدم، ما دامت دراجة ATV تطبيقك فهمها. ويحدد credentialsType النظام الأساسي الذي تأتي CredentialsData من أو يمكن أن تكون قيمة مخصّصة. يتم ضبطها تلقائيًا إلى المنصة التي يتم إرسالها منه.

لا يتم نقل CredentialsData إلى تطبيق Android TV إلا أثناء تشغيله أو وقت الانضمام. وفي حال إعادة ضبطه أثناء الاتصال، لن يتم تمريره إلى تطبيق Android TV إذا بدّل المُرسِل الملف الشخصي أثناء الاتصال، إما البقاء في الجلسة أو إجراء مكالمة SessionManager.endCurrentCastSession(boolean stopCasting) إذا كنت تعتقد أن الملف الشخصي الجديد غير متوافق مع الجلسة.

تشير رسالة الأشكال البيانية CredentialsData لكل مرسل باستخدام getSenders في صفحة CastReceiverContext للحصول على SenderInfo، getCastLaunchRequest() للحصول على CastLaunchRequest, بعد ذلك getCredentialsData().

أجهزة Android

يجب توفُّر إصدار play-services-cast-framework 19.0.0 أو أعلى.

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

يجب توفّر الإصدار v4.8.3 من google-cast-sdk أو أعلى.

ويمكن الاتصال في أي وقت بعد تحديد الخيارات التالية: GCKCastContext.setSharedInstanceWith(options)

GCKCastContext.sharedInstance().setLaunch(
    GCKCredentialsData(credentials: "{\"userId\": \"abc\"}")
الويب

يتطلب متصفّح Chromium M87 أو أعلى.

ويمكن الاتصال في أي وقت بعد تحديد الخيارات التالية: cast.framework.CastContext.getInstance().setOptions(options);

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

تنفيذ أداة التحقّق من طلب إطلاق ATV

تشير رسالة الأشكال البيانية CredentialsData يتم إرسالها إلى تطبيق Android TV عندما يحاول أحد المُرسِلين فتح التطبيق أو الانضمام إليه. يمكنك تنفيذ LaunchRequestChecker للسماح بهذا الطلب أو رفضه.

في حال رفض أحد الطلبات، يتم تحميل جهاز استقبال الويب بدلاً من تشغيله في تطبيق ATV. يجب رفض الطلب في حال تعذّر على ATV تنفيذ ما يلي: التعامل مع المستخدم الذي يطلب الإطلاق أو الانضمام. من الأمثلة على ذلك أن سجّل المستخدم الدخول إلى تطبيق ATV أكثر من الطلب، ويتعذّر على تطبيقك التعامل مع بيانات اعتماد التبديل، أو تعذُّر تسجيل دخول مستخدم حاليًا إلى تطبيق ATV.

وفي حال السماح بالطلب، يتم تشغيل تطبيق ATV. يمكنك تخصيص هذه الصورة اعتمادًا على ما إذا كان تطبيقك يتيح إرسال طلبات التحميل عندما يرسل المستخدم لم يتم تسجيل الدخول إلى تطبيق ATV أو إذا كان هناك مستخدم غير مطابق. هذا السلوك هو يمكن تخصيصها بالكامل في LaunchRequestChecker.

أنشئ فئة تنفذ 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;
}

بعد ذلك، قم بتعيينه في ReceiverOptionsProvider:

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();
  }
}

جارٍ حلّ true في LaunchRequestChecker يؤدي هذا الإجراء إلى تشغيل تطبيق ATV وسيعمل false على تشغيل تطبيق WebRecipient.

الإرسال تلقّي رسائل مخصّصة

يسمح لك بروتوكول البث بإرسال رسائل سلسلة مخصصة بين المرسلين طلب الاستقبال. يجب تسجيل مساحة اسم (قناة) لإرسالها الرسائل قبل تهيئة CastReceiverContext

Android TV: تحديد "مساحة الاسم المخصَّصة"

يلزمك تحديد مساحات الاسم المتوافقة في CastReceiverOptions أثناء عملية الإعداد:

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: إرسال الرسائل

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: تلقّي رسائل مخصّصة في مساحة الاسم

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());