إضافة الميزات الأساسية إلى جهاز استقبال 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.0.1'
    implementation 'com.google.android.gms:play-services-cast:21.4.0'
  }
    • بالنسبة إلى تطبيق Android Sender: 
        dependencies {
    implementation 'com.google.android.gms:play-services-cast:21.0.1'
    implementation 'com.google.android.gms:play-services-cast-framework:21.4.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());

إعداد دعم Google Cast

عندما يرسل تطبيق المرسِل طلب بدء، يتم إنشاء intent مع مساحة اسم التطبيق. ويكون تطبيقك مسؤولاً عن التعامل معه وإنشاء مثيل لكائن 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 عند توقف التشغيل أثناء تشغيله في الخلفية.

ننصحك بشدة باستخدام LifecycleMonitorer من مكتبة 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();
  }
}

استخدام Exo Player مع 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 على true.

نظام التشغيل 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

يجب استخدام الإصدار 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);

إعداد Google Cast Developer Console

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

أضِف اسم حزمة تطبيق Android TV في Google Cast Developer Console لربطه بمعرّف تطبيق Cast.

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

سجِّل الرقم التسلسلي لجهاز Android TV الذي تريد استخدامه للتطوير في Google 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);

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

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

من المحتمل أن يتوافق تطبيق "جهاز استقبال الويب" وتطبيق 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);

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

جارٍ التحميل بواسطة Content ID أو MediaQueueData

إذا كنت لا تستخدم 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);

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

لمعالجة طلبات التحميل هذه، تحتاج في نشاطك إلى معالجة الأغراض في عمليات معاودة الاتصال خلال دورة حياة نشاطك:

كولين
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) لاستقبال الويب، إذا أردت إجراء بعض اللمسات النهائية قبل إرسال الطلب، يمكنك تحديد 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 وينضم إليه، يمكنك تحديد أداة التحقّق من الإطلاق لمعرفة ما إذا كانت بيانات اعتماد المُرسِل مسموح بها أم لا. أما إذا لم يتم تنشيطها، فستعود حزمة SDK لـ 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

يجب استخدام الإصدار v4.8.1 من 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);

تنفيذ أداة التحقّق من طلبات تشغيل الدراجات الرباعية

يتم تمرير 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 الخاص بجهاز استقبال الويب.

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

يسمح لك "بروتوكول البثّ" بإرسال رسائل سلسلة مخصّصة بين المُرسِلين وتطبيق المُستلِم. يجب تسجيل مساحة اسم (قناة) لإرسال الرسائل قبل إعداد 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());
السابق
نظرة عامة
التالي
الأغاني