आउटपुट स्विचर

आउटपुट स्विचर, Cast SDK टूल की एक सुविधा है. इसकी मदद से Android 13 और इसके बाद के वर्शन में, कॉन्टेंट को लोकल और रिमोट मोड में चलाने के बीच आसानी से ट्रांसफ़र किया जा सकता है. इसका मकसद, भेजने वाले ऐप्लिकेशन को आसानी से और तुरंत यह कंट्रोल करने में मदद करना है कि कॉन्टेंट कहां चल रहा है. आउटपुट स्विचर, MediaRouter लाइब्रेरी का इस्तेमाल करके, कॉन्टेंट प्लेबैक को फ़ोन के स्पीकर, जोड़े गए ब्लूटूथ डिवाइसों, और रिमोट कास्ट करने की सुविधा वाले डिवाइसों के बीच स्विच करता है. इस्तेमाल के उदाहरणों को इन स्थितियों में बांटा जा सकता है:

अपने ऑडियो ऐप्लिकेशन में आउटपुट स्विचर को लागू करने का तरीक़ा जानने के लिए, नीचे दिया गया सैंपल डाउनलोड करें और उसका इस्तेमाल करें. सैंपल चलाने के तरीके के बारे में जानने के लिए, इसके साथ दिया गया README.md देखें.

सैंपल डाउनलोड करें

आउटपुट स्विचर की सुविधा चालू होनी चाहिए, ताकि लोकल-टू-रिमोट और रिमोट-टू-लोकल, इस गाइड में बताए गए तरीके के साथ काम कर सकें. लोकल डिवाइस के स्पीकर और जोड़े गए ब्लूटूथ डिवाइसों के बीच, डेटा ट्रांसफ़र करने के लिए, आपको कोई अतिरिक्त कदम नहीं उठाना होगा.

ऑडियो ऐप्लिकेशन ऐसे ऐप्लिकेशन होते हैं जो Google Cast SDK डेवलपर में ऑडियो पाने वाले की ऐप्लिकेशन सेटिंग में 'ऑडियो के लिए Google Cast' की सुविधा देते हैं कंसोल

आउटपुट स्विचर यूज़र इंटरफ़ेस (यूआई)

आउटपुट स्विचर, उपलब्ध लोकल और रिमोट डिवाइस के साथ-साथ डिवाइस की मौजूदा स्थिति दिखाता है. इसमें यह जानकारी भी शामिल होती है कि डिवाइस को चुना गया है या नहीं, यानी कि आवाज़ का मौजूदा लेवल क्या है. अगर मौजूदा डिवाइस के अलावा दूसरे डिवाइस मौजूद हैं, तो दूसरे डिवाइस पर क्लिक करके, मीडिया को चुने गए डिवाइस पर ट्रांसफ़र किया जा सकता है.

आम तौर पर होने वाली समस्याएं

  • कास्ट SDK टूल की सूचना पर स्विच करने पर, लोकल प्लेबैक के लिए बनाए गए मीडिया सेशन खारिज कर दिए जाएंगे और इन्हें फिर से बनाया जाएगा.

एंट्री पॉइंट

मीडिया के लिए सूचना

अगर कोई ऐप्लिकेशन, स्थानीय वीडियो चलाने (स्थानीय तौर पर चलाया जा रहा है) के लिए MediaSession के साथ कोई मीडिया सूचना पोस्ट करता है, तो मीडिया सूचना के सबसे ऊपर दाएं कोने में डिवाइस का नाम (जैसे कि फ़ोन का स्पीकर) दिखता है जिसके साथ अभी वह कॉन्टेंट चलाया जा रहा है. सूचना चिप पर टैप करने से, आउटपुट स्विचर डायलॉग सिस्टम यूज़र इंटरफ़ेस (यूआई) खुलता है.

वॉल्यूम की सेटिंग

आउटपुट स्विचर डायलॉग सिस्टम यूज़र इंटरफ़ेस (यूआई) को डिवाइस पर फ़िज़िकल वॉल्यूम बटन पर क्लिक करके, सबसे नीचे मौजूद सेटिंग आइकॉन पर टैप करके, और "<Cast डिवाइस> पर <ऐप्लिकेशन का नाम> चलाएँ" टेक्स्ट पर टैप करके भी ट्रिगर किया जा सकता है.

चरणों का सारांश

ज़रूरी शर्तें

  1. अपने मौजूदा Android ऐप्लिकेशन को AndroidX पर माइग्रेट करें.
  2. आउटपुट स्विचर के लिए, Android सेंडर SDK टूल का ज़रूरी वर्शन इस्तेमाल करने के लिए, अपने ऐप्लिकेशन का build.gradle अपडेट करें:
    dependencies {
      ...
      implementation 'com.google.android.gms:play-services-cast-framework:21.2.0'
      ...
    }
  3. यह ऐप्लिकेशन, मीडिया की सूचनाएं पाने की सुविधा देता है.
  4. Android 13 पर चलने वाला डिवाइस.

मीडिया नोटिफ़िकेशन सेट अप करें

आउटपुट स्विचर का इस्तेमाल करने के लिए, ऑडियो और वीडियो ऐप्लिकेशन को मीडिया से जुड़ी सूचना तैयार करनी होगी. इससे उनकी मीडिया फ़ाइल के लिए, वीडियो चलाने की स्थिति और कंट्रोल दिखेंगे. इसके लिए, MediaSession बनाना, MediaSession के टोकन के साथ MediaStyle, और सूचना पर मीडिया कंट्रोल सेट करना होगा.

अगर फ़िलहाल MediaStyle और MediaSession का इस्तेमाल नहीं किया जा रहा है, तो नीचे दिए गए स्निपेट में इन्हें सेट अप करने का तरीका बताया गया है. साथ ही, ऑडियो और वीडियो ऐप्लिकेशन के लिए, मीडिया सेशन कॉलबैक सेट अप करने के लिए गाइड उपलब्ध हैं:

कोटलिन
// 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() का इस्तेमाल करें और MediaMetadataCompat.Builder() में मीडिया के लिए काम के सभी MediaMetadata कॉन्सटेंट उपलब्ध कराएं.

कोटलिन
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.Builder() में अपने मीडिया के लिए, PlaybackStateCompat से जुड़ी सभी ज़रूरी जानकारी दें.

कोटलिन
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() में जाकर रजिस्टर करना होगा.

आउटपुट स्विचर की मदद से कास्ट करने की नई सुविधा से, ऐप्लिकेशन बैकग्राउंड में कास्ट करते समय कास्ट करना शुरू कर सकते हैं. यह खास तौर पर ऐसे ऑडियो ऐप्लिकेशन के लिए फ़ायदेमंद है जो बैकग्राउंड में चलते समय सूचनाएं पोस्ट करते हैं. ऐप्लिकेशन, सेवा के onCreate() में SessionManager लिसनर को रजिस्टर कर सकते हैं और onDestroy() में रजिस्ट्रेशन रद्द कर सकते हैं. इस तरह, ऐप्लिकेशन को बैकग्राउंड में चलने पर, ऐप्लिकेशन को हमेशा लोकल-टू-रिमोट कॉलबैक (जैसे कि onSessionStarted) मिलने चाहिए.

अगर ऐप्लिकेशन MediaBrowserService का इस्तेमाल करता है, तो हमारा सुझाव है कि SessionManagerListener को वहां रजिस्टर करें.

कोटलिन
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);
    }
  }
}

इस अपडेट के बाद, जब ऐप्लिकेशन बैकग्राउंड में चलता है, तब लोकल-टू-रिमोट की तरह ही कास्ट करने की सुविधा भी काम करती है. ब्लूटूथ डिवाइसों से कास्ट डिवाइसों पर स्विच करने के लिए, आपको अलग से कुछ नहीं करना पड़ता.

रिमोट-से-लोकल

आउटपुट स्विचर की मदद से, रिमोट प्लेबैक से फ़ोन के स्पीकर या लोकल ब्लूटूथ डिवाइस पर डेटा ट्रांसफ़र किया जा सकता है. इसे चालू करने के लिए, CastOptions पर setRemoteToLocalEnabled फ़्लैग को true पर सेट करें.

ऐसे मामले जब डिवाइस भेजने वाला मौजूदा डिवाइस एक से ज़्यादा लोगों वाले किसी मौजूदा सेशन में शामिल होता है और ऐप्लिकेशन यह जांच करता है कि मौजूदा मीडिया को डिवाइस पर ही ट्रांसफ़र किया जा सकता है या नहीं, ऐसे में SessionState की जांच करने के लिए ऐप्लिकेशन को SessionTransferCallback के onTransferred कॉलबैक का इस्तेमाल करना चाहिए.

setRemoteToLocalEnabled फ़्लैग सेट करें

कास्ट सेशन चालू होने पर, CastOptions, फ़ोन के स्पीकर और लोकल ब्लूटूथ डिवाइसों को आउटपुट स्विचर डायलॉग में ट्रांसफ़र-टू टारगेट के तौर पर दिखाने या छिपाने के लिए setRemoteToLocalEnabled की सुविधा देता है.

कोटलिन
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 कॉलबैक सुननी चाहिए और स्थानीय तौर पर वीडियो चलाना फिर से शुरू करना चाहिए.

कोटलिन
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 से ज़रूरी जानकारी (जैसे कि मीडिया मेटाडेटा और वीडियो चलाने की स्थिति) सेव करनी चाहिए. ऐप्लिकेशन को बैकग्राउंड में चलाने पर, सेव की गई जानकारी के साथ ऐप्लिकेशन चलते रहेंगे.

कोटलिन
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.
    }
  }
}