مبدِّل النتائج

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

تنزيل واستخدام نموذج تطبيق Cast Videos-android كمرجع حول كيفية تنفيذ "أداة التبديل بين أجهزة التشغيل" في تطبيقك.

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

واجهة مستخدم "أداة تبديل الإخراج"

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

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

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

نقاط الإدخال

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

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

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

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

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

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

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

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

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

من المحلية إلى الاتصال عن بُعد

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

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

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

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

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

الوصول عن بعد إلى المناطق المحلية

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

SessionTransferCallback هو إضافة إلى قائمة SessionManagerListener الحالية عمليات معاودة الاتصال ويتم تشغيلها بعد تشغيل onSessionEnded. ترتيب هي:

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

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

إذا كان التطبيق يعمل في الخلفية، من المفترض أن يوقف تشغيل الوسائط مؤقتًا وأن يخزِّن المعلومات اللازمة من 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 للصوت في إعدادات "تطبيق المُستلِم" في "وحدة تحكّم المطوّر" لـ Google Cast SDK.

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

يمكن توسيع الصوت في تطبيقات الصوت التي تستخدم "أداة التبديل بين أجهزة التشغيل" إلى عدة أجهزة مكبّرات صوت تعمل بتكنولوجيا Google 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 باستخدام البث التقليدي أو عبر local-to-remote.
  2. افتح "أداة التبديل بين أجهزة التشغيل" باستخدام إحدى نقاط الدخول.
  3. انقر على جهاز آخر يعمل بتكنولوجيا Google Cast، وستوسع التطبيقات الصوتية المحتوى ليشمل جهاز إضافي، وإنشاء مجموعة ديناميكية.
  4. انقر مرة أخرى على الجهاز الذي يعمل بتكنولوجيا Google Cast وستتم إزالته من الإعدادات الديناميكية. المجموعة.