आउटपुट स्विचर, Cast SDK की एक सुविधा है. इसकी मदद से, Android 13 और इसके बाद के वर्शन में, कॉन्टेंट को लोकल और रिमोट कॉन्टेंट के बीच आसानी से ट्रांसफ़र किया जा सकता है. इसका मकसद, भेजने वाले ऐप्लिकेशन को आसानी से और तेज़ी से यह कंट्रोल करने में मदद करना है कि कॉन्टेंट कहां दिखाया जाए.
आउटपुट स्विचर, MediaRouter
लाइब्रेरी का इस्तेमाल करता है. इसकी मदद से, फ़ोन के स्पीकर, जोड़े गए ब्लूटूथ डिवाइसों, और रिमोट Cast की सुविधा वाले डिवाइसों के बीच वीडियो चलाने की सुविधा चालू की जाती है. इस्तेमाल के उदाहरणों को, इन स्थितियों में बांटा जा सकता है:
अपने ऑडियो ऐप्लिकेशन में आउटपुट स्विचर लागू करने का तरीका जानने के लिए, नीचे दिया गया सैंपल डाउनलोड करें और उसका इस्तेमाल करें. सैंपल को चलाने के तरीके के बारे में जानने के लिए, शामिल किया गया README.md देखें.
इस गाइड में बताए गए तरीके से, आउटपुट स्विचर को लोकल-टू-रिमोट और रिमोट-टू-लोकल मोड पर काम करने के लिए चालू किया जाना चाहिए. लोकल डिवाइस स्पीकर और जोड़े गए ब्लूटूथ डिवाइसों के बीच डेटा ट्रांसफ़र करने के लिए, कुछ और करने की ज़रूरत नहीं होती.
ऑडियो ऐप्लिकेशन ऐसे ऐप्लिकेशन होते हैं, जो Google Cast SDK डेवलपर कंसोल में मौजूद पाने वाले ऐप्लिकेशन की सेटिंग में ऑडियो के लिए Google Cast का समर्थन करते हैं
आउटपुट स्विचर यूज़र इंटरफ़ेस (यूआई)
आउटपुट स्विचर, उपलब्ध लोकल और रिमोट डिवाइसों के साथ-साथ, डिवाइस की मौजूदा स्थिति दिखाता है. अगर डिवाइस चुना गया है, कनेक्ट किया जा रहा है, और वॉल्यूम का मौजूदा लेवल देखा जाता है, तो यह भी पता चलता है. अगर मौजूदा डिवाइस के अलावा, दूसरे डिवाइस भी मौजूद हैं, तो किसी दूसरे डिवाइस पर क्लिक करने से, चुने गए डिवाइस पर मीडिया चलाने की सुविधा ट्रांसफ़र की जा सकती है.
पहले से मालूम समस्याएं
- Cast SDK टूल की सूचना पर स्विच करने पर, लोकल प्लेबैक के लिए बनाए गए मीडिया सेशन खारिज कर दिए जाएंगे और उन्हें फिर से बनाया जाएगा.
एंट्री पॉइंट
मीडिया के लिए सूचना
अगर कोई ऐप्लिकेशन, लोकल वीडियो चलाने के लिए MediaSession
का इस्तेमाल करके मीडिया सूचना पोस्ट करता है, तो मीडिया सूचना के सबसे ऊपर दाएं कोने में सूचना चिप के साथ उस डिवाइस का नाम (जैसे कि फ़ोन का स्पीकर) दिखेगा जिस पर फ़िलहाल कॉन्टेंट चलाया जा रहा है. सूचना चिप पर टैप करने से
आउटपुट स्विचर डायलॉग सिस्टम यूज़र इंटरफ़ेस (यूआई) खुलता है.
वॉल्यूम की सेटिंग
आउटपुट स्विचर डायलॉग सिस्टम यूज़र इंटरफ़ेस (यूआई) को ट्रिगर करने के लिए, डिवाइस पर मौजूद वॉल्यूम बटन पर क्लिक करें, सबसे नीचे मौजूद सेटिंग आइकॉन पर टैप करें, और "<Cast Device> पर <App Name> चलाओ" टेक्स्ट पर टैप करें.
चरणों के बारे में खास जानकारी
- ज़रूरी शर्तें पूरी करना
- AndroidManifest.xml में आउटपुट स्विचर चालू करें
- बैकग्राउंड कास्टिंग के लिए SessionManagerListener अपडेट करें
- setRemoteToLocalEnabled फ़्लैग सेट करें
- डिवाइस पर वीडियो चलाना जारी रखें
ज़रूरी शर्तें
- अपने मौजूदा Android ऐप्लिकेशन को AndroidX पर माइग्रेट करें.
- आउटपुट स्विचर के लिए, Android भेजने वाले SDK टूल के कम से कम ज़रूरी वर्शन का इस्तेमाल करने के लिए अपने ऐप्लिकेशन के
build.gradle
को अपडेट करें:dependencies { ... implementation 'com.google.android.gms:play-services-cast-framework:21.2.0' ... }
- ऐप्लिकेशन पर, मीडिया से जुड़ी सूचनाएं पाने की सुविधा काम करती है.
- 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)
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() )
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() )
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 टूल अपने-आप कास्ट सेशन शुरू कर देता है. हालांकि, ऐप्लिकेशन को लोकल से रिमोट पर स्विच
करने की ज़रूरत होती है. उदाहरण के लिए, लोकल प्लेबैक को रोकना और
कास्ट डिवाइस पर मीडिया लोड करना. ऐप्लिकेशन को onSessionStarted()
और onSessionEnded()
कॉलबैक का इस्तेमाल करके, Cast SessionManagerListener
को सुनना चाहिए और कास्ट 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) } } }
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() } }
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
के ट्रिगर होने के बाद ट्रिगर होता है. इसलिए, रिमोट-टू-लोकल कॉलबैक
का क्रम यह है:
onTransferring
onSessionEnding
onSessionEnded
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. } } }
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. } } }
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. } } }