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

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

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

لإتاحة واجهات برمجة تطبيقات 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.1 من google-cast-sdk أو إصدار أحدث.
  2. استهداف الإصدار 14 من نظام التشغيل iOS أو الإصدارات الأحدث يُرجى الاطّلاع على ملاحظات الإصدار لمعرفة مزيد من التفاصيل. 
      platform: ios, '14'

  def target_pods
     pod 'google-cast-sdk', '~>4.8.1'
  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() لضبط حالة التشغيل.
كوتلين
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() إيقاف الوسائط الحالية
كوتلين
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:

كوتلين
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 عند إنشاء تطبيقك:

كوتلين
override fun onCreate() {
  CastReceiverContext.initInstance(this)

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

  ...
}

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

كوتلين
CastReceiverContext.getInstance().start()
Java
CastReceiverContext.getInstance().start();

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

كوتلين
// Player has stopped.
CastReceiverContext.getInstance().stop()
Java
// Player has stopped.
CastReceiverContext.getInstance().stop();

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

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

كوتلين
// 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 حتى يعرف مكان إرسال الأوامر واسترداد حالة تشغيل الوسائط:

كوتلين
val mediaManager: MediaManager = receiverContext.getMediaManager()
mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken())
Java
MediaManager mediaManager = receiverContext.getMediaManager();
mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());

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

كوتلين
myPlayer.stop()
mediaSession.release()
mediaManager.setSessionCompatToken(null)
Java
myPlayer.stop();
mediaSession.release();
mediaManager.setSessionCompatToken(null);

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

كوتلين
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 في تطبيقك، أضِف ما يلي إلى صف نشاط اللاعبين أو إلى أي مكان تدير فيه جلسة الوسائط:

كوتلين
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 على "صحيح".

Android

يتطلب هذا الخيار استخدام الإصدار 19.0.0 من play-services-cast-framework أو إصدار أحدث.

يتم ضبط العلامة androidReceiverCompatible في LaunchOptions (وهي جزء من CastOptions):

كوتلين
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

يتطلب التطبيق google-cast-sdk الإصدار v4.4.8 أو الإصدارات الأحدث.

يتم ضبط العلامة 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 Developer Console لربطه برقم تعريف تطبيق Cast.

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

سجِّل الرقم التسلسلي لجهاز Android TV الذي تريد استخدامه في عملية التطوير في Cast Developer Console.

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

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

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

إذا سبق لك إتاحة الروابط لصفحات معيّنة في تطبيق 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 في معلومات الوسائط لطلب التحميل:

كوتلين
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
كوتلين
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);

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

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

إذا لم تكن تستخدم entity أو atvEntity وكنت تستخدم Content ID أو Content 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
كوتلين
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);

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

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

كوتلين
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() "نشاط" أو "تطبيق").

كوتلين
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 لطلبات التحميل).

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

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

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

كوتلين
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.

كوتلين
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.

كوتلين
// 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 لا يتيح تغيير معدّل التشغيل أثناء استخدام تطبيق "جهاز استقبال الويب"، عليك ضبط الإجراءات المتوافقة بشكل صحيح على كل نظام أساسي والتأكّد من أنّ تطبيق المُرسِل يعرض واجهة المستخدم بشكل صحيح.

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

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

نقدّم لك الفئة MediaStatusModifier لتحقيق ذلك. سيعمل "MediaStatusModifier" دائمًا على "MediaSession" الذي حدّدته في CastReceiverContext.

لإنشاء البث وبثّه MediaStatus:

كوتلين
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.

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

يمكنك استخدام حزمة تطوير البرامج (SDK) الخاصة بـ WebRecipient، إذا كنت تريد إجراء بعض اللمسات النهائية قبل الإرسال، يمكنك تحديد MediaStatusInterceptor لمعالجة MediaStatus الذي سيتم إرساله نمرر MediaStatusWriter لمعالجة MediaStatus قبل إرساله.

كوتلين
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 وينضم إليه، يمكنك تحديد أداة فحص الإطلاق لمعرفة ما إذا كانت بيانات اعتماد المُرسِل مسموحًا بها. في حال عدم حدوث ذلك، تعود حزمة تطوير البرامج "Cast Connect" إلى تشغيل جهاز استقبال الويب.

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

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

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

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

يمكن استرداد CredentialsData لكل مُرسِل باستخدام getSenders في CastReceiverContext للحصول على SenderInfo، getCastLaunchRequest() للحصول على CastLaunchRequest، ثم getCredentialsData().

Android

يتطلب هذا الخيار استخدام الإصدار 19.0.0 من play-services-cast-framework أو إصدار أحدث.

كوتلين
CastContext.getSharedInstance().setLaunchCredentialsData(
    CredentialsData.Builder()
        .setCredentials("{\"userId\": \"abc\"}")
        .build()
)
Java
CastContext.getSharedInstance().setLaunchCredentialsData(
    new CredentialsData.Builder()
        .setCredentials("{\"userId\": \"abc\"}")
        .build());
iOS

يتطلب التطبيق google-cast-sdk الإصدار v4.8.1 أو الإصدارات الأحدث.

ويمكن الاتصال في أي وقت بعد ضبط الخيارات: 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 أو في حال عدم تطابق المستخدم. ويمكن تخصيص هذا السلوك بالكامل في LaunchRequestChecker.

أنشئ صفًا لتنفيذ واجهة CastReceiverOptions.LaunchRequestChecker:

كوتلين
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:

كوتلين
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.

إرسال رسائل مخصّصة واستلامها

يسمح لك بروتوكول Cast بإرسال رسائل سلسلة مخصصة بين المرسلين وتطبيق المُستلِم. يجب تسجيل مساحة اسم (قناة) لإرسال الرسائل قبل إعداد CastReceiverContext.

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

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

كوتلين
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: إرسال الرسائل

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

كوتلين
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());
السابق
نظرة عامة
التالي
الأغاني