أداة التبديل بين أجهزة التشغيل

"أداة تبديل الإخراج" هي إحدى ميزات Cast SDK التي تتيح نقل المحتوى بسلاسة بين التشغيل المحلي والتشغيل عن بُعد، وذلك بدءًا من Android 13. والهدف من ذلك هو مساعدة تطبيقات المرسِل في التحكّم بسهولة وسرعة في مكان تشغيل المحتوى. تستخدم "أداة التبديل بين أجهزة التشغيل" مكتبة MediaRouter للتبديل بين تشغيل المحتوى على مكبّر صوت الهاتف وأجهزة البلوتوث المقترنة وأجهزة البث البعيدة المتوافقة مع Google Cast. يمكن تقسيم حالات الاستخدام إلى السيناريوهات التالية:

نزِّل تطبيق CastVideos-android التجريبي واستخدِمه كمرجع حول كيفية تنفيذ "أداة تبديل الإخراج" في تطبيقك.

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

واجهة مستخدم أداة التبديل بين أجهزة التشغيل

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

المشاكل المعروفة

  • سيتم إغلاق "جلسات الوسائط" التي تم إنشاؤها لتشغيل المحتوى على الجهاز المحلي وإعادة إنشائها عند التبديل إلى إشعار Cast SDK.

نقاط الإدخال

إشعار الوسائط

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

إعدادات مستوى الصوت

يمكن أيضًا تشغيل واجهة مستخدم نظام مربع حوار "مبدّل الإخراج" من خلال النقر على أزرار مستوى الصوت الفعلية على الجهاز، والنقر على رمز الإعدادات في أسفل الشاشة، ثم النقر على النص "تشغيل <اسم التطبيق> على <جهاز البث>".

ملخّص الخطوات

المتطلبات الأساسية

  1. نقل تطبيق Android الحالي إلى AndroidX
  2. يجب تعديل build.gradle في تطبيقك لاستخدام الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) المطلوبة في "أداة تبديل الإخراج" على Android:
    dependencies {
      ...
      implementation 'com.google.android.gms:play-services-cast-framework:21.2.0'
      ...
    }
  3. يتيح التطبيق تلقّي إشعارات الوسائط.
  4. جهاز يعمل بالإصدار 13 من نظام التشغيل Android

إعداد "إشعارات الوسائط"

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

إذا كنت لا تستخدم حاليًا MediaStyle وMediaSession، يوضّح المقتطف أدناه كيفية إعدادهما، وتتوفّر أدلة لإعداد عمليات معاودة الاتصال الخاصة بجلسة الوسائط لتطبيقات الصوت والفيديو:

Kotlin
// Create a media session. NotificationCompat.MediaStyle
// PlayerService is your own Service or Activity responsible for media playback.
val mediaSession = MediaSessionCompat(this, "PlayerService")

// Create a MediaStyle object and supply your media session token to it.
val mediaStyle = Notification.MediaStyle().setMediaSession(mediaSession.sessionToken)

// Create a Notification which is styled by your MediaStyle object.
// This connects your media session to the media controls.
// Don't forget to include a small icon.
val notification = Notification.Builder(this@PlayerService, CHANNEL_ID)
    .setStyle(mediaStyle)
    .setSmallIcon(R.drawable.ic_app_logo)
    .build()

// Specify any actions which your users can perform, such as pausing and skipping to the next track.
val pauseAction: Notification.Action = Notification.Action.Builder(
        pauseIcon, "Pause", pauseIntent
    ).build()
notification.addAction(pauseAction)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    // Create a media session. NotificationCompat.MediaStyle
    // PlayerService is your own Service or Activity responsible for media playback.
    MediaSession mediaSession = new MediaSession(this, "PlayerService");

    // Create a MediaStyle object and supply your media session token to it.
    Notification.MediaStyle mediaStyle = new Notification.MediaStyle().setMediaSession(mediaSession.getSessionToken());

    // Specify any actions which your users can perform, such as pausing and skipping to the next track.
    Notification.Action pauseAction = Notification.Action.Builder(pauseIcon, "Pause", pauseIntent).build();

    // Create a Notification which is styled by your MediaStyle object.
    // This connects your media session to the media controls.
    // Don't forget to include a small icon.
    String CHANNEL_ID = "CHANNEL_ID";
    Notification notification = new Notification.Builder(this, CHANNEL_ID)
        .setStyle(mediaStyle)
        .setSmallIcon(R.drawable.ic_app_logo)
        .addAction(pauseAction)
        .build();
}

بالإضافة إلى ذلك، لملء الإشعار بمعلومات الوسائط، عليك إضافة البيانات الوصفية وحالة التشغيل الخاصة بالوسائط إلى MediaSession.

لإضافة بيانات وصفية إلى MediaSession، استخدِم setMetaData() وقدِّم جميع الثوابت ذات الصلة MediaMetadata الخاصة بالوسائط في MediaMetadataCompat.Builder().

Kotlin
mediaSession.setMetadata(MediaMetadataCompat.Builder()
    // Title
    .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title)

    // Artist
    // Could also be the channel name or TV series.
    .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist)

    // Album art
    // Could also be a screenshot or hero image for video content
    // The URI scheme needs to be "content", "file", or "android.resource".
    .putString(
        MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri)
    )

    // Duration
    // If duration isn't set, such as for live broadcasts, then the progress
    // indicator won't be shown on the seekbar.
    .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration)

    .build()
)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    mediaSession.setMetadata(
        new MediaMetadataCompat.Builder()
        // Title
        .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title)

        // Artist
        // Could also be the channel name or TV series.
        .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist)

        // Album art
        // Could also be a screenshot or hero image for video content
        // The URI scheme needs to be "content", "file", or "android.resource".
        .putString(MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri)

        // Duration
        // If duration isn't set, such as for live broadcasts, then the progress
        // indicator won't be shown on the seekbar.
        .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration)

        .build()
    );
}

لإضافة حالة التشغيل إلى MediaSession، استخدِم setPlaybackState() وقدِّم جميع الثوابت ذات الصلة PlaybackStateCompat لوسائطك في PlaybackStateCompat.Builder().

Kotlin
mediaSession.setPlaybackState(
    PlaybackStateCompat.Builder()
        .setState(
            PlaybackStateCompat.STATE_PLAYING,

            // Playback position
            // Used to update the elapsed time and the progress bar.
            mediaPlayer.currentPosition.toLong(),

            // Playback speed
            // Determines the rate at which the elapsed time changes.
            playbackSpeed
        )

        // isSeekable
        // Adding the SEEK_TO action indicates that seeking is supported
        // and makes the seekbar position marker draggable. If this is not
        // supplied seek will be disabled but progress will still be shown.
        .setActions(PlaybackStateCompat.ACTION_SEEK_TO)
        .build()
)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    mediaSession.setPlaybackState(
        new PlaybackStateCompat.Builder()
            .setState(
                 PlaybackStateCompat.STATE_PLAYING,

                // Playback position
                // Used to update the elapsed time and the progress bar.
                mediaPlayer.currentPosition.toLong(),

                // Playback speed
                // Determines the rate at which the elapsed time changes.
                playbackSpeed
            )

        // isSeekable
        // Adding the SEEK_TO action indicates that seeking is supported
        // and makes the seekbar position marker draggable. If this is not
        // supplied seek will be disabled but progress will still be shown.
        .setActions(PlaybackStateCompat.ACTION_SEEK_TO)
        .build()
    );
}

طريقة عمل الإشعارات في تطبيقات الفيديو

يجب أن تتضمّن تطبيقات الفيديو أو الصوت التي لا تتيح التشغيل المحلي في الخلفية سلوكًا محدّدًا لإشعارات الوسائط لتجنُّب المشاكل المتعلّقة بإرسال أوامر الوسائط في الحالات التي لا يتوفّر فيها التشغيل:

  • يتم نشر إشعار الوسائط عند تشغيل الوسائط محليًا ويكون التطبيق في المقدّمة.
  • إيقاف التشغيل المحلي مؤقتًا وإغلاق الإشعار عندما يكون التطبيق في الخلفية
  • عندما يعود التطبيق إلى المقدّمة، يجب استئناف التشغيل المحلي وإعادة نشر الإشعار.

تفعيل أداة التبديل بين أجهزة التشغيل في ملف AndroidManifest.xml

لتفعيل "أداة التبديل بين أجهزة التشغيل"، يجب إضافة MediaTransferReceiver إلى AndroidManifest.xml في التطبيق. إذا لم يكن كذلك، لن يتم تفعيل الميزة، وستكون علامة ميزة النقل من جهاز بعيد إلى جهاز محلي غير صالحة أيضًا.

<application>
    ...
    <receiver
         android:name="androidx.mediarouter.media.MediaTransferReceiver"
         android:exported="true">
    </receiver>
    ...
</application>

MediaTransferReceiver هو برنامج استقبال بث يتيح نقل الوسائط بين الأجهزة باستخدام واجهة مستخدم النظام. يمكنك الاطّلاع على مرجع MediaTransferReceiver للحصول على مزيد من المعلومات.

من الجهاز المحلي إلى الجهاز البعيد

عندما يبدّل المستخدم التشغيل من الجهاز المحلي إلى جهاز بعيد، سيبدأ Cast SDK جلسة Cast تلقائيًا. ومع ذلك، يجب أن تتعامل التطبيقات مع التبديل من التشغيل المحلي إلى التشغيل عن بُعد، مثلاً إيقاف التشغيل المحلي وتحميل الوسائط على جهاز البث. يجب أن تستمع التطبيقات إلى عمليات معاودة الاتصال الخاصة بـ Cast SessionManagerListener باستخدام عمليات معاودة الاتصال onSessionStarted() وonSessionEnded()، وتتعامل مع الإجراء عند تلقّي عمليات معاودة الاتصال الخاصة بـ Cast SessionManager. يجب أن تضمن التطبيقات أنّ عمليات معاودة الاتصال هذه لا تزال نشطة عند فتح مربّع حوار "أداة تبديل الإخراج" وعدم ظهور التطبيق في المقدّمة.

تعديل SessionManagerListener للبث في الخلفية

تتيح تجربة Cast القديمة مشاركة المحتوى من الجهاز المحلي إلى جهاز بعيد عندما يكون التطبيق يعمل في المقدّمة. تبدأ تجربة البث النموذجية عندما ينقر المستخدمون على رمز البث في التطبيق ويختارون جهازًا لبث الوسائط. في هذه الحالة، يجب أن يسجّل التطبيق SessionManagerListener في onCreate() أو onStart()، وأن يلغي تسجيل أداة معالجة الحدث في onStop() أو onDestroy() لنشاط التطبيق.

من خلال التجربة الجديدة للبث باستخدام &quot;أداة تبديل الإخراج&quot;، يمكن للتطبيقات بدء البث عندما تكون في الخلفية. ويفيد ذلك بشكل خاص تطبيقات الصوت التي تنشر إشعارات عند التشغيل في الخلفية. يمكن للتطبيقات تسجيل برامج معالجة SessionManager في onCreate() من الخدمة وإلغاء التسجيل في onDestroy() من الخدمة. يجب أن تتلقّى التطبيقات دائمًا عمليات معاودة الاتصال من الجهاز المحلي إلى الجهاز البعيد (مثل onSessionStarted) عندما يكون التطبيق في الخلفية.

إذا كان التطبيق يستخدم MediaBrowserService، ننصحك بتسجيل SessionManagerListener هناك.

Kotlin
class MyService : Service() {
    private var castContext: CastContext? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext
            .getSessionManager()
            .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext
                .getSessionManager()
                .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
        }
    }
}
Java
public class MyService extends Service {
  private CastContext castContext;

  @Override
  protected void onCreate() {
     castContext = CastContext.getSharedInstance(this);
     castContext
        .getSessionManager()
        .addSessionManagerListener(sessionManagerListener, CastSession.class);
  }

  @Override
  protected void onDestroy() {
    if (castContext != null) {
       castContext
          .getSessionManager()
          .removeSessionManagerListener(sessionManagerListener, CastSession.class);
    }
  }
}

من خلال هذا التحديث، ستعمل ميزة &quot;البث من الجهاز المحلي إلى الجهاز البعيد&quot; بالطريقة نفسها التي يعمل بها البث التقليدي عندما يكون التطبيق في الخلفية، ولن يكون عليك اتّخاذ خطوات إضافية للتبديل من أجهزة البلوتوث إلى أجهزة البث.

التحويل من بعيد إلى محلي

تتيح لك "أداة التبديل بين أجهزة التشغيل" الانتقال من التشغيل عن بُعد إلى مكبّر صوت الهاتف أو جهاز بلوتوث محلي. يمكن تفعيل هذه الميزة من خلال ضبط العلامة setRemoteToLocalEnabled على true في CastOptions.

في الحالات التي ينضم فيها جهاز المُرسِل الحالي إلى جلسة حالية تضم عدة مُرسِلين ويحتاج التطبيق إلى التحقّق مما إذا كان مسموحًا بنقل الوسائط الحالية محليًا، يجب أن تستخدم التطبيقات معاودة الاتصال onTransferred الخاصة بالدالة SessionTransferCallback للتحقّق من SessionState.

ضبط العلامة setRemoteToLocalEnabled

يوفّر CastOptions.Builder setRemoteToLocalEnabled لعرض أو إخفاء مكبّر صوت الهاتف وأجهزة البلوتوث المحلية كأجهزة مستهدَفة لنقل الصوت في مربّع حوار "مبدّل الإخراج" عندما تكون هناك جلسة بث محتوى نشطة.

Kotlin
class CastOptionsProvider : OptionsProvider {
    fun getCastOptions(context: Context?): CastOptions {
        ...
        return Builder()
            ...
            .setRemoteToLocalEnabled(true)
            .build()
    }
}
Java
public class CastOptionsProvider implements OptionsProvider {
    @Override
    public CastOptions getCastOptions(Context context) {
        ...
        return new CastOptions.Builder()
            ...
            .setRemoteToLocalEnabled(true)
            .build()
  }
}

مواصلة التشغيل على الجهاز

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

يسمح CastContext#addSessionTransferCallback(SessionTransferCallback) للتطبيق بتسجيل SessionTransferCallback والاستماع إلى عمليات معاودة الاتصال onTransferred وonTransferFailed عند نقل المرسِل إلى التشغيل المحلي.

بعد أن يلغي التطبيق تسجيل SessionTransferCallback، لن يتلقّى التطبيق بعد ذلك SessionTransferCallback s.

SessionTransferCallback هي إضافة إلى عمليات الاسترجاع الحالية SessionManagerListener ويتم تشغيلها بعد تشغيل onSessionEnded. يكون ترتيب عمليات الرجوع من بعيد إلى محلي كما يلي:

  1. onTransferring
  2. onSessionEnding
  3. onSessionEnded
  4. onTransferred

بما أنّه يمكن فتح &quot;أداة اختيار جهاز الإخراج&quot; من خلال شريحة إشعار الوسائط عندما يكون التطبيق يعمل في الخلفية ويُجري عملية البث، يجب أن تتعامل التطبيقات مع عملية النقل إلى الجهاز المحلي بشكل مختلف حسب ما إذا كانت تتيح تشغيل المحتوى في الخلفية أم لا. في حال تعذّر إتمام عملية النقل، سيتم تفعيل onTransferFailed في أي وقت يحدث فيه الخطأ.

التطبيقات التي تتيح تشغيل المحتوى في الخلفية

بالنسبة إلى التطبيقات التي تتيح التشغيل في الخلفية (عادةً تطبيقات الصوت)، يُنصح باستخدام Service (مثل MediaBrowserService). يجب أن تستمع الخدمات إلى معاودة الاتصال onTransferred وأن تستأنف التشغيل محليًا سواء كان التطبيق في المقدّمة أو في الخلفية.

Kotlin
class MyService : Service() {
    private var castContext: CastContext? = null
    private var sessionTransferCallback: SessionTransferCallback? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
        sessionTransferCallback = MySessionTransferCallback()
        castContext.addSessionTransferCallback(sessionTransferCallback)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback)
            }
        }
    }

    class MySessionTransferCallback : SessionTransferCallback() {
        fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) {
            // Perform necessary steps prior to onTransferred
        }

        fun onTransferred(@SessionTransferCallback.TransferType transferType: Int,
                          sessionState: SessionState?) {
            if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.
                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int,
                             @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) {
            // Handle transfer failure.
        }
    }
}
Java
public class MyService extends Service {
    private CastContext castContext;
    private SessionTransferCallback sessionTransferCallback;

    @Override
    protected void onCreate() {
        castContext = CastContext.getSharedInstance(this);
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession.class);
        sessionTransferCallback = new MySessionTransferCallback();
        castContext.addSessionTransferCallback(sessionTransferCallback);
    }

    @Override
    protected void onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession.class);
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback);
            }
        }
    }

    public static class MySessionTransferCallback extends SessionTransferCallback {
        public MySessionTransferCallback() {}

        @Override
        public void onTransferring(@SessionTransferCallback.TransferType int transferType) {
            // Perform necessary steps prior to onTransferred
        }

        @Override
        public void onTransferred(@SessionTransferCallback.TransferType int transferType,
                                  SessionState sessionState) {
            if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.
                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        @Override
        public void onTransferFailed(@SessionTransferCallback.TransferType int transferType,
                                     @SessionTransferCallback.TransferFailedReason int transferFailedReason) {
            // Handle transfer failure.
        }
    }
}

التطبيقات التي لا تتيح تشغيل المحتوى في الخلفية

بالنسبة إلى التطبيقات التي لا تتيح تشغيل المحتوى في الخلفية (عادةً تطبيقات الفيديو)، يُنصح بالاستماع إلى onTransferred callback واستئناف التشغيل محليًا إذا كان التطبيق في المقدّمة.

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

Kotlin
class MyActivity : AppCompatActivity() {
    private var castContext: CastContext? = null
    private var sessionTransferCallback: SessionTransferCallback? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
        sessionTransferCallback = MySessionTransferCallback()
        castContext.addSessionTransferCallback(sessionTransferCallback)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback)
            }
        }
    }

    class MySessionTransferCallback : SessionTransferCallback() {
        fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) {
            // Perform necessary steps prior to onTransferred
        }

        fun onTransferred(@SessionTransferCallback.TransferType transferType: Int,
                          sessionState: SessionState?) {
            if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.

                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int,
                             @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) {
            // Handle transfer failure.
        }
    }
}
Java
public class MyActivity extends AppCompatActivity {
  private CastContext castContext;
  private SessionTransferCallback sessionTransferCallback;

  @Override
  protected void onCreate() {
     castContext = CastContext.getSharedInstance(this);
     castContext
        .getSessionManager()
        .addSessionManagerListener(sessionManagerListener, CastSession.class);
     sessionTransferCallback = new MySessionTransferCallback();
     castContext.addSessionTransferCallback(sessionTransferCallback);
  }

  @Override
  protected void onDestroy() {
    if (castContext != null) {
       castContext
          .getSessionManager()
          .removeSessionManagerListener(sessionManagerListener, CastSession.class);
      if (sessionTransferCallback != null) {
         castContext.removeSessionTransferCallback(sessionTransferCallback);
      }
    }
  }

  public static class MySessionTransferCallback extends SessionTransferCallback {
    public MySessionTransferCallback() {}

    @Override
    public void onTransferring(@SessionTransferCallback.TransferType int transferType) {
        // Perform necessary steps prior to onTransferred
    }

    @Override
    public void onTransferred(@SessionTransferCallback.TransferType int transferType,
                               SessionState sessionState) {
      if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
        // Remote stream is transferred to the local device.

        // Retrieve information from the SessionState to continue playback on the local player.
      }
    }

    @Override
    public void onTransferFailed(@SessionTransferCallback.TransferType int transferType,
                                 @SessionTransferCallback.TransferFailedReason int transferFailedReason) {
      // Handle transfer failure.
    }
  }
}

التحويل من جهاز إلى آخر

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

تطبيقات الصوت هي التطبيقات التي تتوافق مع ميزة "Google Cast للصوت" في إعدادات تطبيق الاستقبال في Play Console لـ Google Cast SDK

توسيع نطاق البث باستخدام مكبّرات الصوت

تستطيع تطبيقات الصوت التي تستخدم &quot;أداة تبديل الإخراج&quot; توسيع نطاق الصوت ليشمل أجهزة مكبّرات صوت متعددة متوافقة مع البث أثناء جلسة بث باستخدام ميزة &quot;توسيع نطاق البث&quot;.

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

للحصول على اسم المجموعة الموسّع الجديد أثناء توسيع البث، سجِّل Cast.Listener باستخدام CastSession#addCastListener. بعد ذلك، استدعِ CastSession#getCastDevice() أثناء عملية معاودة الاتصال onDeviceNameChanged.

Kotlin
class MyActivity : Activity() {
    private var mCastSession: CastSession? = null
    private lateinit var mCastContext: CastContext
    private lateinit var mSessionManager: SessionManager
    private val mSessionManagerListener: SessionManagerListener<CastSession> =
        SessionManagerListenerImpl()
    private val mCastListener = CastListener()

    private inner class SessionManagerListenerImpl : SessionManagerListener<CastSession?> {
        override fun onSessionStarting(session: CastSession?) {}

        override fun onSessionStarted(session: CastSession?, sessionId: String) {
            addCastListener(session)
        }

        override fun onSessionStartFailed(session: CastSession?, error: Int) {}

        override fun onSessionSuspended(session: CastSession?, reason Int) {
            removeCastListener()
        }

        override fun onSessionResuming(session: CastSession?, sessionId: String) {}

        override fun onSessionResumed(session: CastSession?, wasSuspended: Boolean) {
            addCastListener(session)
        }

        override fun onSessionResumeFailed(session: CastSession?, error: Int) {}

        override fun onSessionEnding(session: CastSession?) {}

        override fun onSessionEnded(session: CastSession?, error: Int) {
            removeCastListener()
        }
    }

    private inner class CastListener : Cast.Listener() {
        override fun onDeviceNameChanged() {
            mCastSession?.let {
                val castDevice = it.castDevice
                val deviceName = castDevice.friendlyName
                // Update UIs with the new cast device name.
            }
        }
    }

    private fun addCastListener(castSession: CastSession) {
        mCastSession = castSession
        mCastSession?.addCastListener(mCastListener)
    }

    private fun removeCastListener() {
        mCastSession?.removeCastListener(mCastListener)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        mCastContext = CastContext.getSharedInstance(this)
        mSessionManager = mCastContext.sessionManager
        mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession::class.java)
    }

    override fun onDestroy() {
        super.onDestroy()
        mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession::class.java)
    }
}
Java
public class MyActivity extends Activity {
    private CastContext mCastContext;
    private CastSession mCastSession;
    private SessionManager mSessionManager;
    private SessionManagerListener<CastSession> mSessionManagerListener =
            new SessionManagerListenerImpl();
    private Cast.Listener mCastListener = new CastListener();

    private class SessionManagerListenerImpl implements SessionManagerListener<CastSession> {
        @Override
        public void onSessionStarting(CastSession session) {}
        @Override
        public void onSessionStarted(CastSession session, String sessionId) {
            addCastListener(session);
        }
        @Override
        public void onSessionStartFailed(CastSession session, int error) {}
        @Override
        public void onSessionSuspended(CastSession session, int reason) {
            removeCastListener();
        }
        @Override
        public void onSessionResuming(CastSession session, String sessionId) {}
        @Override
        public void onSessionResumed(CastSession session, boolean wasSuspended) {
            addCastListener(session);
        }
        @Override
        public void onSessionResumeFailed(CastSession session, int error) {}
        @Override
        public void onSessionEnding(CastSession session) {}
        @Override
        public void onSessionEnded(CastSession session, int error) {
            removeCastListener();
        }
    }

    private class CastListener extends Cast.Listener {
         @Override
         public void onDeviceNameChanged() {
             if (mCastSession == null) {
                 return;
             }
             CastDevice castDevice = mCastSession.getCastDevice();
             String deviceName = castDevice.getFriendlyName();
             // Update UIs with the new cast device name.
         }
    }

    private void addCastListener(CastSession castSession) {
        mCastSession = castSession;
        mCastSession.addCastListener(mCastListener);
    }

    private void removeCastListener() {
        if (mCastSession != null) {
            mCastSession.removeCastListener(mCastListener);
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mCastContext = CastContext.getSharedInstance(this);
        mSessionManager = mCastContext.getSessionManager();
        mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession.class);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession.class);
    }
}

اختبار من جهاز تحكّم عن بُعد إلى آخر

لاختبار الميزة، اتّبِع الخطوات التالية:

  1. يمكنك بث المحتوى إلى جهاز متوافق مع Google Cast باستخدام ميزة البث التقليدية أو ميزة البث من الجهاز المحلي إلى جهاز بعيد.
  2. افتح "مبدّل الإخراج" باستخدام إحدى نقاط الدخول.
  3. انقر على جهاز آخر مزوّد بتكنولوجيا Cast، وستوسّع تطبيقات الصوت المحتوى ليشمل الجهاز الإضافي، ما يؤدي إلى إنشاء مجموعة ديناميكية.
  4. انقر على الجهاز الذي يعمل بتكنولوجيا Google Cast مرة أخرى، وستتم إزالته من المجموعة الديناميكية.