इस पेज पर, कोड स्निपेट और Android TV रिसीवर ऐप्लिकेशन को पसंद के मुताबिक बनाने के लिए उपलब्ध सुविधाओं की जानकारी दी गई है.
लाइब्रेरी कॉन्फ़िगर करना
अपने Android TV ऐप्लिकेशन में Cast Connect API उपलब्ध कराने के लिए:
-
अपनी ऐप्लिकेशन मॉड्यूल डायरेक्ट्री में
build.gradle
फ़ाइल खोलें. -
पुष्टि करें कि
google()
को सूचीrepositories
में शामिल किया गया है.repositories { google() }
-
अपने ऐप्लिकेशन के लिए टारगेट किए गए डिवाइस के हिसाब से, लाइब्रेरी के सबसे नए वर्शन
अपनी डिपेंडेंसी में जोड़ें:
-
Android रिसीवर ऐप्लिकेशन के लिए:
dependencies { implementation 'com.google.android.gms:play-services-cast-tv:21.1.0' implementation 'com.google.android.gms:play-services-cast:21.5.0' }
-
Android सेंडर ऐप्लिकेशन के लिए:
dependencies { implementation 'com.google.android.gms:play-services-cast:21.1.0' implementation 'com.google.android.gms:play-services-cast-framework:21.5.0' }
-
Android रिसीवर ऐप्लिकेशन के लिए:
-
बदलावों को सेव करें और टूलबार में
Sync Project with Gradle Files
पर क्लिक करें.
-
पक्का करें कि आपका
Podfile
,google-cast-sdk
4.8.1 या उसके बाद के वर्शन को टारगेट कर रहा है -
iOS 14 या इसके बाद के वर्शन को टारगेट करें. ज़्यादा जानकारी के लिए, रिलीज़ नोट
देखें.
platform: ios, '14' def target_pods pod 'google-cast-sdk', '~>4.8.1' end
- इसके लिए, Chromium ब्राउज़र का M87 या इसके बाद का वर्शन होना ज़रूरी है.
-
अपने प्रोजेक्ट में Web सेंडर एपीआई लाइब्रेरी जोड़ें
<script src="//www.gstatic.com/cv/js/sender/v1/cast_sender.js?loadCastFramework=1"></script>
AndroidX की ज़रूरी शर्तें
Google Play services के नए वर्शन में, androidx
नेमस्पेस का इस्तेमाल करने के लिए, ऐप्लिकेशन को अपडेट करना ज़रूरी है. AndroidX पर माइग्रेट करने के लिए,
इन निर्देशों का पालन करें.
Android TV ऐप्लिकेशन—ज़रूरी शर्तें
अपने Android TV ऐप्लिकेशन में Cast Connect की सुविधा देने के लिए, आपको मीडिया सेशन से इवेंट बनाने होंगे और उन इवेंट में मदद करनी होगी. आपके मीडिया सेशन से मिलने वाला डेटा, आपके मीडिया की स्थिति की बुनियादी जानकारी देता है. जैसे, पोज़िशन, वीडियो चलाने की स्थिति वगैरह. आपके मीडिया सेशन का इस्तेमाल Cast Connect लाइब्रेरी भी करती है, ताकि यह पता चल सके कि उसे भेजने वाले किसी व्यक्ति से कुछ मैसेज मिले हैं. जैसे, मीडिया सेशन को रोकना.
मीडिया सेशन और मीडिया सेशन शुरू करने के तरीके के बारे में ज़्यादा जानकारी के लिए, मीडिया सेशन की गाइड के साथ काम करना लेख पढ़ें.
मीडिया सेशन का लाइफ़साइकल
प्लेबैक शुरू होने पर आपके ऐप्लिकेशन को एक मीडिया सेशन बनाना चाहिए और जब कंट्रोल न किया जा सके, तो उसे रिलीज़ कर देना चाहिए. उदाहरण के लिए, अगर आपका ऐप्लिकेशन एक वीडियो ऐप्लिकेशन है, तो आपको सेशन को तब रिलीज़ करना चाहिए, जब उपयोगकर्ता वीडियो चलाने की गतिविधि से बाहर निकल जाता है. दूसरे कॉन्टेंट को ब्राउज़ करने के लिए 'वापस जाएं' को चुनें या ऐप्लिकेशन को बैकग्राउंड में चलाएं. अगर आपका ऐप्लिकेशन कोई संगीत ऐप्लिकेशन है, तो आपको उसे तब रिलीज़ करना चाहिए, जब आपके ऐप्लिकेशन पर कोई मीडिया नहीं चल रहा हो.
सेशन की स्थिति अपडेट की जा रही है
आपके मीडिया सेशन का डेटा, आपके प्लेयर की स्थिति के साथ अप-टू-डेट होना चाहिए. उदाहरण के लिए, वीडियो चलाने की प्रोसेस रोकने पर, आपको वीडियो चलाने की स्थिति और काम करने वाली कार्रवाइयों की स्थिति को अपडेट करना चाहिए. नीचे दी गई टेबल में उन राज्यों की सूची दी गई है जिन्हें अप-टू-डेट रखने की ज़िम्मेदारी आपकी है.
MediaMetadataCompat
मेटाडेटा फ़ील्ड | कंपनी का ब्यौरा |
---|---|
METADATA_KEY_TITLE (ज़रूरी) | मीडिया का टाइटल. |
METADATA_KEY_DISPLAY_SUBTITLE | सबटाइटल. |
METADATA_KEY_DISPLAY_ICON_URI | आइकॉन का यूआरएल. |
METADATA_KEY_DURATION (ज़रूरी है) | मीडिया की अवधि. |
METADATA_KEY_MEDIA_URI | Content ID. |
METADATA_KEY_ARTIST | कलाकार. |
METADATA_KEY_ALBUM | एल्बम. |
PlaybackStateCompat
ज़रूरी तरीका | कंपनी का ब्यौरा |
---|---|
setActions() | काम करने वाले मीडिया निर्देश सेट करता है. |
setState() | वीडियो चलाने की स्थिति और मौजूदा स्थिति सेट करें. |
MediaSessionCompat
ज़रूरी तरीका | कंपनी का ब्यौरा |
---|---|
setRepeatMode() | दोहराने वाला मोड सेट करता है. |
setShuffleMode() | शफ़ल मोड सेट करता है. |
setMetadata() | मीडिया का मेटाडेटा सेट करता है. |
setPlaybackState() | इससे वीडियो चलाने की स्थिति सेट की जाती है. |
private fun updateMediaSession() { val metadata = MediaMetadataCompat.Builder() .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI, mMovie.getCardImageUrl()) .build() val playbackState = PlaybackStateCompat.Builder() .setState( PlaybackStateCompat.STATE_PLAYING, player.getPosition(), player.getPlaybackSpeed(), System.currentTimeMillis() ) .build() mediaSession.setMetadata(metadata) mediaSession.setPlaybackState(playbackState) }
private void updateMediaSession() { MediaMetadataCompat metadata = new MediaMetadataCompat.Builder() .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle") .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI,mMovie.getCardImageUrl()) .build(); PlaybackStateCompat playbackState = new PlaybackStateCompat.Builder() .setState( PlaybackStateCompat.STATE_PLAYING, player.getPosition(), player.getPlaybackSpeed(), System.currentTimeMillis()) .build(); mediaSession.setMetadata(metadata); mediaSession.setPlaybackState(playbackState); }
ट्रांसपोर्ट कंट्रोल हैंडलिंग
आपके ऐप्लिकेशन को मीडिया सेशन ट्रांसपोर्ट कंट्रोल कॉलबैक लागू करना चाहिए. यहां दी गई टेबल में बताया गया है कि उन्हें ट्रांसपोर्ट कंट्रोल से जुड़ी कौनसी कार्रवाइयां करनी होंगी:
MediaSessionCompat.Callback
कार्रवाइयां | कंपनी का ब्यौरा |
---|---|
onPlay() | फिर से शुरू करें |
onPause() | रोकें |
onSeekTo() | किसी जगह पर जाएं |
onStop() | मौजूदा मीडिया बंद करें |
class MyMediaSessionCallback : MediaSessionCompat.Callback() { override fun onPause() { // Pause the player and update the play state. ... } override fun onPlay() { // Resume the player and update the play state. ... } override fun onSeekTo (long pos) { // Seek and update the play state. ... } ... } mediaSession.setCallback( MyMediaSessionCallback() );
public MyMediaSessionCallback extends MediaSessionCompat.Callback { public void onPause() { // Pause the player and update the play state. ... } public void onPlay() { // Resume the player and update the play state. ... } public void onSeekTo (long pos) { // Seek and update the play state. ... } ... } mediaSession.setCallback(new MyMediaSessionCallback());
Cast सहायता कॉन्फ़िगर करना
जब भेजने वाले किसी ऐप्लिकेशन से लॉन्च का अनुरोध भेजा जाता है, तो ऐप्लिकेशन नेमस्पेस का इस्तेमाल करके एक इंटेंट बनाया जाता है. टीवी ऐप्लिकेशन लॉन्च होने पर, उसे मैनेज करने और CastReceiverContext
ऑब्जेक्ट का इंस्टेंस बनाने की ज़िम्मेदारी आपके ऐप्लिकेशन की होती है. टीवी ऐप्लिकेशन के चलने के दौरान, 'कास्ट करें' सुविधा का इस्तेमाल करने के लिए, CastReceiverContext
ऑब्जेक्ट की ज़रूरत होती है. यह ऑब्जेक्ट, आपके टीवी ऐप्लिकेशन को, कनेक्ट किए गए किसी भी ईमेल पते से आने वाले कास्ट मीडिया मैसेज को स्वीकार करने की अनुमति देता है.
Android TV का सेटअप
लॉन्च इंटेंट फ़िल्टर जोड़ना
उस गतिविधि में एक नया इंटेंट फ़िल्टर जोड़ें जिसे आपको भेजने वाले ऐप्लिकेशन के लॉन्च के इंटेंट को मैनेज करना है:
<activity android:name="com.example.activity">
<intent-filter>
<action android:name="com.google.android.gms.cast.tv.action.LAUNCH" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
रिसीवर के लिए विकल्प उपलब्ध कराने वाली कंपनी का नाम दें
आपको ReceiverOptionsProvider
लागू करना होगा, ताकि CastReceiverOptions
:
class MyReceiverOptionsProvider : ReceiverOptionsProvider { override fun getOptions(context: Context?): CastReceiverOptions { return CastReceiverOptions.Builder(context) .setStatusText("My App") .build() } }
public class MyReceiverOptionsProvider implements ReceiverOptionsProvider { @Override public CastReceiverOptions getOptions(Context context) { return new CastReceiverOptions.Builder(context) .setStatusText("My App") .build(); } }
इसके बाद, अपने AndroidManifest
में विकल्प देने वाली कंपनी के बारे में बताएं:
<meta-data
android:name="com.google.android.gms.cast.tv.RECEIVER_OPTIONS_PROVIDER_CLASS_NAME"
android:value="com.example.mysimpleatvapplication.MyReceiverOptionsProvider" />
CastReceiverContext
शुरू करने पर, ReceiverOptionsProvider
का इस्तेमाल CastReceiverOptions
देने के लिए किया जाता है.
कास्ट किए जाने वाले डिवाइस से जुड़ी जानकारी
अपना ऐप्लिकेशन बनाने के बाद, CastReceiverContext
को इस्तेमाल करने की प्रोसेस शुरू करें:
override fun onCreate() { CastReceiverContext.initInstance(this) ... }
@Override public void onCreate() { CastReceiverContext.initInstance(this); ... }
जब आपका ऐप्लिकेशन फ़ोरग्राउंड में चला जाए, तब CastReceiverContext
शुरू करें:
CastReceiverContext.getInstance().start()
CastReceiverContext.getInstance().start();
अगर बैकग्राउंड में वीडियो चलाने की सुविधा मौजूद नहीं है, तो ऐप्लिकेशन के बैकग्राउंड में जाने के बाद, CastReceiverContext
पर stop()
कॉल करें. इसके लिए:
// Player has stopped. CastReceiverContext.getInstance().stop()
// Player has stopped. CastReceiverContext.getInstance().stop();
इसके अलावा, अगर आपके ऐप्लिकेशन को बैकग्राउंड में चलाने की सुविधा काम करती है, तो CastReceiverContext
पर stop()
को कॉल करें. ऐसा तब करें, जब बैकग्राउंड में वीडियो चलना बंद हो जाए.
हमारा सुझाव है कि कॉल करने की सुविधा को मैनेज करने के लिए, androidx.lifecycle
लाइब्रेरी के LifecycleObserver का इस्तेमाल करें.CastReceiverContext.start()
और CastReceiverContext.stop()
का इस्तेमाल करें. खास तौर पर तब, जब आपके ऐप्लिकेशन में कई गतिविधियां हों. इससे, अलग-अलग गतिविधियों के लिए start()
और stop()
को कॉल करने पर, रेस की स्थितियों से बचा जा सकता है.
// Create a LifecycleObserver class. class MyLifecycleObserver : DefaultLifecycleObserver { override fun onStart(owner: LifecycleOwner) { // App prepares to enter foreground. CastReceiverContext.getInstance().start() } override fun onStop(owner: LifecycleOwner) { // App has moved to the background or has terminated. CastReceiverContext.getInstance().stop() } } // Add the observer when your application is being created. class MyApplication : Application() { fun onCreate() { super.onCreate() // Initialize CastReceiverContext. CastReceiverContext.initInstance(this /* android.content.Context */) // Register LifecycleObserver ProcessLifecycleOwner.get().lifecycle.addObserver( MyLifecycleObserver()) } }
// Create a LifecycleObserver class. public class MyLifecycleObserver implements DefaultLifecycleObserver { @Override public void onStart(LifecycleOwner owner) { // App prepares to enter foreground. CastReceiverContext.getInstance().start(); } @Override public void onStop(LifecycleOwner owner) { // App has moved to the background or has terminated. CastReceiverContext.getInstance().stop(); } } // Add the observer when your application is being created. public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); // Initialize CastReceiverContext. CastReceiverContext.initInstance(this /* android.content.Context */); // Register LifecycleObserver ProcessLifecycleOwner.get().getLifecycle().addObserver( new MyLifecycleObserver()); } }
// In AndroidManifest.xml set MyApplication as the application class
<application
...
android:name=".MyApplication">
Mediasession को MediaManager से कनेक्ट किया जा रहा है
MediaSession
बनाते समय, आपको CastReceiverContext
को मौजूदा MediaSession
टोकन भी देना होगा, ताकि उसे पता चल सके कि निर्देश कहां भेजने हैं और मीडिया प्लेबैक की स्थिति क्या है:
val mediaManager: MediaManager = receiverContext.getMediaManager() mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken())
MediaManager mediaManager = receiverContext.getMediaManager(); mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());
वीडियो बंद होने की वजह से MediaSession
को रिलीज़ करने पर, आपको MediaManager
पर शून्य टोकन सेट करना चाहिए:
myPlayer.stop() mediaSession.release() mediaManager.setSessionCompatToken(null)
myPlayer.stop(); mediaSession.release(); mediaManager.setSessionCompatToken(null);
अगर आपके ऐप्लिकेशन के बैकग्राउंड में चलने पर भी मीडिया चलाने की सुविधा है, तो उसे कॉल करने के बजाय CastReceiverContext.stop()
बैकग्राउंड में भेजें. ऐसे में, ऐप्लिकेशन को सिर्फ़ तब कॉल करना चाहिए, जब बैकग्राउंड में ऐप्लिकेशन चल रहा हो और उस पर मीडिया नहीं चल रहा हो. उदाहरण के लिए:
class MyLifecycleObserver : DefaultLifecycleObserver { ... // App has moved to the background. override fun onPause(owner: LifecycleOwner) { mIsBackground = true myStopCastReceiverContextIfNeeded() } } // Stop playback on the player. private fun myStopPlayback() { myPlayer.stop() myStopCastReceiverContextIfNeeded() } // Stop the CastReceiverContext when both the player has // stopped and the app has moved to the background. private fun myStopCastReceiverContextIfNeeded() { if (mIsBackground && myPlayer.isStopped()) { CastReceiverContext.getInstance().stop() } }
public class MyLifecycleObserver implements DefaultLifecycleObserver { ... // App has moved to the background. @Override public void onPause(LifecycleOwner owner) { mIsBackground = true; myStopCastReceiverContextIfNeeded(); } } // Stop playback on the player. private void myStopPlayback() { myPlayer.stop(); myStopCastReceiverContextIfNeeded(); } // Stop the CastReceiverContext when both the player has // stopped and the app has moved to the background. private void myStopCastReceiverContextIfNeeded() { if (mIsBackground && myPlayer.isStopped()) { CastReceiverContext.getInstance().stop(); } }
Cast Connect के साथ Exoplayer का इस्तेमाल करना
अगर Exoplayer
का इस्तेमाल किया जा रहा है, तो बदलावों को मैन्युअल तौर पर ट्रैक करने के बजाय, MediaSessionConnector
का इस्तेमाल करके सेशन और उससे जुड़ी जानकारी को अपने-आप बनाए रखने की सुविधा चालू की जा सकती है. इसमें, वीडियो चलाने की स्थिति भी शामिल है.
MediaSessionConnector.MediaButtonEventHandler
का इस्तेमाल, MediaButton इवेंट को कॉल करके setMediaButtonEventHandler(MediaButtonEventHandler)
करने के लिए किया जा सकता है. इसे डिफ़ॉल्ट रूप से MediaSessionCompat.Callback
से मैनेज किया जाता है.
MediaSessionConnector
को अपने ऐप्लिकेशन में इंटिग्रेट करने के लिए, खिलाड़ियों की गतिविधि वाली क्लास में इन चीज़ों को जोड़ें. इसके अलावा, उन जगहों पर भी जोड़ें जहां मीडिया सेशन को मैनेज किया जाता है:
class PlayerActivity : Activity() { private var mMediaSession: MediaSessionCompat? = null private var mMediaSessionConnector: MediaSessionConnector? = null private var mMediaManager: MediaManager? = null override fun onCreate(savedInstanceState: Bundle?) { ... mMediaSession = MediaSessionCompat(this, LOG_TAG) mMediaSessionConnector = MediaSessionConnector(mMediaSession!!) ... } override fun onStart() { ... mMediaManager = receiverContext.getMediaManager() mMediaManager!!.setSessionCompatToken(currentMediaSession.getSessionToken()) mMediaSessionConnector!!.setPlayer(mExoPlayer) mMediaSessionConnector!!.setMediaMetadataProvider(mMediaMetadataProvider) mMediaSession!!.isActive = true ... } override fun onStop() { ... mMediaSessionConnector!!.setPlayer(null) mMediaSession!!.release() mMediaManager!!.setSessionCompatToken(null) ... } }
public class PlayerActivity extends Activity { private MediaSessionCompat mMediaSession; private MediaSessionConnector mMediaSessionConnector; private MediaManager mMediaManager; @Override protected void onCreate(Bundle savedInstanceState) { ... mMediaSession = new MediaSessionCompat(this, LOG_TAG); mMediaSessionConnector = new MediaSessionConnector(mMediaSession); ... } @Override protected void onStart() { ... mMediaManager = receiverContext.getMediaManager(); mMediaManager.setSessionCompatToken(currentMediaSession.getSessionToken()); mMediaSessionConnector.setPlayer(mExoPlayer); mMediaSessionConnector.setMediaMetadataProvider(mMediaMetadataProvider); mMediaSession.setActive(true); ... } @Override protected void onStop() { ... mMediaSessionConnector.setPlayer(null); mMediaSession.release(); mMediaManager.setSessionCompatToken(null); ... } }
ईमेल भेजने वाले व्यक्ति के लिए ऐप्लिकेशन का सेटअप
Cast Connect सहायता चालू करें
Cast Connect की सुविधा के साथ अपने भेजने वाले ऐप्लिकेशन को अपडेट कर लेने के बाद, androidReceiverCompatible
फ़्लैग को LaunchOptions
पर 'सही' पर सेट करके यह बताया जा सकता है कि वह तैयार है.
इसके लिए, play-services-cast-framework
वर्शन
19.0.0
या इसके बाद का वर्शन होना ज़रूरी है.
androidReceiverCompatible
फ़्लैग को
LaunchOptions
(जो CastOptions
का हिस्सा है) में सेट किया गया है:
class CastOptionsProvider : OptionsProvider { override fun getCastOptions(context: Context?): CastOptions { val launchOptions: LaunchOptions = Builder() .setAndroidReceiverCompatible(true) .build() return CastOptions.Builder() .setLaunchOptions(launchOptions) ... .build() } }
public class CastOptionsProvider implements OptionsProvider { @Override public CastOptions getCastOptions(Context context) { LaunchOptions launchOptions = new LaunchOptions.Builder() .setAndroidReceiverCompatible(true) .build(); return new CastOptions.Builder() .setLaunchOptions(launchOptions) ... .build(); } }
इसके लिए, google-cast-sdk
वर्शन v4.4.8
या
इसके बाद का वर्शन होना ज़रूरी है.
androidReceiverCompatible
फ़्लैग को
GCKLaunchOptions
(जो
GCKCastOptions
का हिस्सा है) में सेट किया गया है:
let options = GCKCastOptions(discoveryCriteria: GCKDiscoveryCriteria(applicationID: kReceiverAppID)) ... let launchOptions = GCKLaunchOptions() launchOptions.androidReceiverCompatible = true options.launchOptions = launchOptions GCKCastContext.setSharedInstanceWith(options)
इसके लिए, Chromium ब्राउज़र का M87
या इसके बाद का वर्शन होना ज़रूरी है.
const context = cast.framework.CastContext.getInstance(); const castOptions = new cast.framework.CastOptions(); castOptions.receiverApplicationId = kReceiverAppID; castOptions.androidReceiverCompatible = true; context.setOptions(castOptions);
Cast Developer Console सेटअप
Android TV ऐप्लिकेशन को कॉन्फ़िगर करें
अपने Android TV ऐप्लिकेशन को Cast Developer Console में अपने Cast ऐप्लिकेशन आईडी से जोड़ने के लिए पैकेज का नाम जोड़ें.
डेवलपर डिवाइस रजिस्टर करें
Cast Developer Console में डेवलपमेंट के लिए इस्तेमाल किए जाने वाले Android TV डिवाइस का सीरियल नंबर रजिस्टर करें.
पंजीकरण के बिना, Cast Connect केवल सुरक्षा कारणों से Google Play Store से इंस्टॉल किए गए ऐप्लिकेशन के लिए काम करेगा.
कास्ट डेवलपमेंट के लिए, Cast या Android TV डिवाइस को रजिस्टर करने के बारे में ज़्यादा जानकारी के लिए, रजिस्ट्रेशन पेज देखें.
मीडिया लोड हो रहा है
अगर आपने Android TV ऐप्लिकेशन में, डीप लिंक सपोर्ट की सुविधा पहले ही लागू कर दी है, तो आपके Android TV मेनिफ़ेस्ट में इससे मिलती-जुलती डेफ़िनिशन कॉन्फ़िगर की गई होगी:
<activity android:name="com.example.activity">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data android:scheme="https"/>
<data android:host="www.example.com"/>
<data android:pathPattern=".*"/>
</intent-filter>
</activity>
भेजने वाले पर इकाई के हिसाब से लोड करें
भेजने वालों पर, लोड करने के अनुरोध की मीडिया जानकारी में entity
सेट करके डीप लिंक पास किया जा सकता है:
val mediaToLoad = MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") ... .build() val loadRequest = MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build() remoteMediaClient.load(loadRequest)
MediaInfo mediaToLoad = new MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") ... .build(); MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build(); remoteMediaClient.load(loadRequest);
let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id") ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation mediaLoadRequestDataBuilder.credentials = "user-credentials" ... let mediaLoadRequestData = mediaLoadRequestDataBuilder.build() remoteMediaClient?.loadMedia(with: mediaLoadRequestData)
इसके लिए, Chromium ब्राउज़र का M87
या इसके बाद का वर्शन होना ज़रूरी है.
let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4'); mediaInfo.entity = 'https://example.com/watch/some-id'; ... let request = new chrome.cast.media.LoadRequest(mediaInfo); request.credentials = 'user-credentials'; ... cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);
लोड कमांड, आपके डीप लिंक और डेवलपर कंसोल में तय किए गए पैकेज के नाम के साथ इंटेंट के ज़रिए भेजी जाती है.
भेजने वाले के डिवाइस पर ATV क्रेडेंशियल सेट करने के बारे में जानकारी
ऐसा हो सकता है कि आपका वेब रिसीवर ऐप्लिकेशन और Android TV ऐप्लिकेशन, अलग-अलग डीप लिंक और credentials
के साथ काम करता हो. उदाहरण के लिए, अगर दोनों प्लैटफ़ॉर्म पर पुष्टि करने की प्रक्रिया को अलग-अलग तरीके से मैनेज किया जा रहा हो. इसे ठीक करने के लिए, Android TV के लिए entity
और credentials
का दूसरा विकल्प उपलब्ध कराया जा सकता है:
val mediaToLoad = MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") .setAtvEntity("myscheme://example.com/atv/some-id") ... .build() val loadRequest = MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") .setAtvCredentials("atv-user-credentials") ... .build() remoteMediaClient.load(loadRequest)
MediaInfo mediaToLoad = new MediaInfo.Builder("some-id") .setEntity("https://example.com/watch/some-id") .setAtvEntity("myscheme://example.com/atv/some-id") ... .build(); MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") .setAtvCredentials("atv-user-credentials") ... .build(); remoteMediaClient.load(loadRequest);
let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id") mediaInfoBuilder.atvEntity = "myscheme://example.com/atv/some-id" ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation mediaLoadRequestDataBuilder.credentials = "user-credentials" mediaLoadRequestDataBuilder.atvCredentials = "atv-user-credentials" ... let mediaLoadRequestData = mediaLoadRequestDataBuilder.build() remoteMediaClient?.loadMedia(with: mediaLoadRequestData)
इसके लिए, Chromium ब्राउज़र का M87
या इसके बाद का वर्शन होना ज़रूरी है.
let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4'); mediaInfo.entity = 'https://example.com/watch/some-id'; mediaInfo.atvEntity = 'myscheme://example.com/atv/some-id'; ... let request = new chrome.cast.media.LoadRequest(mediaInfo); request.credentials = 'user-credentials'; request.atvCredentials = 'atv-user-credentials'; ... cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);
अगर वेब रिसीवर ऐप्लिकेशन लॉन्च किया गया है, तो वह लोड करने के अनुरोध में entity
और credentials
का इस्तेमाल करता है. हालांकि, अगर आपका Android TV ऐप्लिकेशन लॉन्च हो गया है, तो SDK टूल, entity
और credentials
को atvEntity
और atvCredentials
(अगर बताई गई) से बदल देता है.
Content ID या Media QueData से लोड हो रहा है
अगर आपने entity
या atvEntity
का इस्तेमाल नहीं किया है और मीडिया की जानकारी में Content ID या कॉन्टेंट यूआरएल का इस्तेमाल किया है या मीडिया लोड करने के ज़्यादा जानकारी वाले डेटा का इस्तेमाल किया है, तो आपको अपने Android TV ऐप्लिकेशन में, पहले से तय इन इंटेंट फ़िल्टर को जोड़ना होगा:
<activity android:name="com.example.activity">
<intent-filter>
<action android:name="com.google.android.gms.cast.tv.action.LOAD"/>
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
भेजने वाले की ओर, इकाई के ज़रिए लोड करें की तरह ही, अपने कॉन्टेंट की जानकारी के साथ लोड करने का अनुरोध किया जा सकता है और load()
को कॉल किया जा सकता है.
val mediaToLoad = MediaInfo.Builder("some-id").build() val loadRequest = MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build() remoteMediaClient.load(loadRequest)
MediaInfo mediaToLoad = new MediaInfo.Builder("some-id").build(); MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder() .setMediaInfo(mediaToLoad) .setCredentials("user-credentials") ... .build(); remoteMediaClient.load(loadRequest);
let mediaInfoBuilder = GCKMediaInformationBuilder(contentId: "some-id") ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation mediaLoadRequestDataBuilder.credentials = "user-credentials" ... let mediaLoadRequestData = mediaLoadRequestDataBuilder.build() remoteMediaClient?.loadMedia(with: mediaLoadRequestData)
इसके लिए, Chromium ब्राउज़र का M87
या इसके बाद का वर्शन होना ज़रूरी है.
let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4'); ... let request = new chrome.cast.media.LoadRequest(mediaInfo); ... cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);
कॉन्टेंट लोड करने के अनुरोधों को मैनेज करना
अपनी गतिविधि में, लोड करने के इन अनुरोधों को मैनेज करने के लिए, आपको ऐक्टिविटी लाइफ़साइकल कॉलबैक में, इंटेंट मैनेज करने होंगे:
class MyActivity : Activity() { override fun onStart() { super.onStart() val mediaManager = CastReceiverContext.getInstance().getMediaManager() // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(intent)) { // If the SDK recognizes the intent, you should early return. return } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } // For some cases, a new load intent triggers onNewIntent() instead of // onStart(). override fun onNewIntent(intent: Intent) { val mediaManager = CastReceiverContext.getInstance().getMediaManager() // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(intent)) { // If the SDK recognizes the intent, you should early return. return } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } }
public class MyActivity extends Activity { @Override protected void onStart() { super.onStart(); MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(getIntent())) { // If the SDK recognizes the intent, you should early return. return; } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } // For some cases, a new load intent triggers onNewIntent() instead of // onStart(). @Override protected void onNewIntent(Intent intent) { MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); // Pass the intent to the SDK. You can also do this in onCreate(). if (mediaManager.onNewIntent(intent)) { // If the SDK recognizes the intent, you should early return. return; } // If the SDK doesn't recognize the intent, you can handle the intent with // your own logic. ... } }
अगर MediaManager
को पता चलता है कि इंटेंट एक लोड इंटेंट है, तो यह इंटेंट से एक MediaLoadRequestData
ऑब्जेक्ट निकालता है और MediaLoadCommandCallback.onLoad()
को शुरू करता है.
लोड करने के अनुरोध को मैनेज करने के लिए, आपको इस तरीके को बदलना होगा. कॉलबैक को कॉल किए जाने से पहले, MediaManager.onNewIntent()
को रजिस्टर करना ज़रूरी है. हमारा सुझाव है कि ऐक्टिविटी या ऐप्लिकेशन onCreate()
वाले तरीके का इस्तेमाल करें.
class MyActivity : Activity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val mediaManager = CastReceiverContext.getInstance().getMediaManager() mediaManager.setMediaLoadCommandCallback(MyMediaLoadCommandCallback()) } } class MyMediaLoadCommandCallback : MediaLoadCommandCallback() { override fun onLoad( senderId: String?, loadRequestData: MediaLoadRequestData ): Task{ return Tasks.call { // Resolve the entity into your data structure and load media. val mediaInfo = loadRequestData.getMediaInfo() if (!checkMediaInfoSupported(mediaInfo)) { // Throw MediaException to indicate load failure. throw MediaException( MediaError.Builder() .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED) .setReason(MediaError.ERROR_REASON_INVALID_REQUEST) .build() ) } myFillMediaInfo(MediaInfoWriter(mediaInfo)) myPlayerLoad(mediaInfo.getContentUrl()) // Update media metadata and state (this clears all previous status // overrides). castReceiverContext.getMediaManager() .setDataFromLoad(loadRequestData) ... castReceiverContext.getMediaManager().broadcastMediaStatus() // Return the resolved MediaLoadRequestData to indicate load success. return loadRequestData } } private fun myPlayerLoad(contentURL: String) { myPlayer.load(contentURL) // Update the MediaSession state. val playbackState: PlaybackStateCompat = Builder() .setState( player.getState(), player.getPosition(), System.currentTimeMillis() ) ... .build() mediaSession.setPlaybackState(playbackState) }
public class MyActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.setMediaLoadCommandCallback(new MyMediaLoadCommandCallback()); } } public class MyMediaLoadCommandCallback extends MediaLoadCommandCallback { @Override public TaskonLoad(String senderId, MediaLoadRequestData loadRequestData) { return Tasks.call(() -> { // Resolve the entity into your data structure and load media. MediaInfo mediaInfo = loadRequestData.getMediaInfo(); if (!checkMediaInfoSupported(mediaInfo)) { // Throw MediaException to indicate load failure. throw new MediaException( new MediaError.Builder() .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED) .setReason(MediaError.ERROR_REASON_INVALID_REQUEST) .build()); } myFillMediaInfo(new MediaInfoWriter(mediaInfo)); myPlayerLoad(mediaInfo.getContentUrl()); // Update media metadata and state (this clears all previous status // overrides). castReceiverContext.getMediaManager() .setDataFromLoad(loadRequestData); ... castReceiverContext.getMediaManager().broadcastMediaStatus(); // Return the resolved MediaLoadRequestData to indicate load success. return loadRequestData; }); } private void myPlayerLoad(String contentURL) { myPlayer.load(contentURL); // Update the MediaSession state. PlaybackStateCompat playbackState = new PlaybackStateCompat.Builder() .setState( player.getState(), player.getPosition(), System.currentTimeMillis()) ... .build(); mediaSession.setPlaybackState(playbackState); }
लोड इंटेंट को प्रोसेस करने के लिए, इंटेंट को उन डेटा स्ट्रक्चर में पार्स किया जा सकता है जो हमने तय किए हैं (लोड अनुरोधों के लिए MediaLoadRequestData
).
मीडिया से जुड़े निर्देश दिए जा सकते हैं
बेसिक प्लेबैक कंट्रोल की सुविधा
बेसिक इंटिग्रेशन कमांड में ऐसे कमांड शामिल होते हैं जो मीडिया सेशन के साथ काम करते हैं. इन निर्देशों को मीडिया सेशन कॉलबैक के ज़रिए सूचना दी जाती है. इसके लिए, आपको मीडिया सेशन में कॉलबैक रजिस्टर करना होगा (हो सकता है कि आप पहले से ही ऐसा कर रहे हों).
private class MyMediaSessionCallback : MediaSessionCompat.Callback() { override fun onPause() { // Pause the player and update the play state. myPlayer.pause() } override fun onPlay() { // Resume the player and update the play state. myPlayer.play() } override fun onSeekTo(pos: Long) { // Seek and update the play state. myPlayer.seekTo(pos) } ... } mediaSession.setCallback(MyMediaSessionCallback())
private class MyMediaSessionCallback extends MediaSessionCompat.Callback { @Override public void onPause() { // Pause the player and update the play state. myPlayer.pause(); } @Override public void onPlay() { // Resume the player and update the play state. myPlayer.play(); } @Override public void onSeekTo(long pos) { // Seek and update the play state. myPlayer.seekTo(pos); } ... } mediaSession.setCallback(new MyMediaSessionCallback());
कास्ट कंट्रोल से जुड़े निर्देश काम करने की सुविधा
कुछ Cast निर्देश, MediaSession
में उपलब्ध नहीं हैं, जैसे कि skipAd()
या setActiveMediaTracks()
.
साथ ही, यहां कुछ क्यू कमांड लागू करने होंगे, क्योंकि कास्ट की सूची, MediaSession
क्यू के साथ पूरी तरह से काम नहीं करती है.
class MyMediaCommandCallback : MediaCommandCallback() { override fun onSkipAd(requestData: RequestData?): Task{ // Skip your ad ... return Tasks.forResult(null) } } val mediaManager = CastReceiverContext.getInstance().getMediaManager() mediaManager.setMediaCommandCallback(MyMediaCommandCallback())
public class MyMediaCommandCallback extends MediaCommandCallback { @Override public TaskonSkipAd(RequestData requestData) { // Skip your ad ... return Tasks.forResult(null); } } MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.setMediaCommandCallback(new MyMediaCommandCallback());
इस्तेमाल किए जा सकने वाले मीडिया कमांड के बारे में बताएं
आपके Cast रिसीवर की तरह ही, आपके Android TV ऐप्लिकेशन को यह तय करना चाहिए कि कौनसे निर्देश काम करेंगे, ताकि भेजने वाले कुछ यूज़र इंटरफ़ेस (यूआई) कंट्रोल को चालू या बंद कर सकें. जो कमांड MediaSession
का हिस्सा हैं उनके लिए PlaybackStateCompat
में निर्देश दें.
अन्य निर्देशों के बारे में MediaStatusModifier
में बताया गया है.
// Set media session supported commands val playbackState: PlaybackStateCompat = PlaybackStateCompat.Builder() .setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PAUSE) .setState(PlaybackStateCompat.STATE_PLAYING) .build() mediaSession.setPlaybackState(playbackState) // Set additional commands in MediaStatusModifier val mediaManager = CastReceiverContext.getInstance().getMediaManager() mediaManager.getMediaStatusModifier() .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT)
// Set media session supported commands PlaybackStateCompat playbackState = new PlaybackStateCompat.Builder() .setActions(PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PAUSE) .setState(PlaybackStateCompat.STATE_PLAYING) .build(); mediaSession.setPlaybackState(playbackState); // Set additional commands in MediaStatusModifier MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.getMediaStatusModifier() .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT);
इस बटन के साथ काम न करने वाले बटन छिपाएं
अगर आपका Android TV ऐप्लिकेशन सिर्फ़ बुनियादी मीडिया कंट्रोल की सुविधा देता है, लेकिन आपका वेब रिसीवर ऐप्लिकेशन ज़्यादा बेहतर कंट्रोल के साथ काम करता है, तो आपको यह पक्का करना चाहिए कि उसे Android TV ऐप्लिकेशन पर कास्ट करते समय ऐप्लिकेशन सही तरीके से काम करे. उदाहरण के लिए, अगर आपके वेब रिसीवर ऐप्लिकेशन में प्लेबैक रेट बदलने की सुविधा काम नहीं करती, तो आपको हर प्लैटफ़ॉर्म पर काम करने वाली कार्रवाइयों को सही तरीके से सेट करना चाहिए और पक्का करना चाहिए कि आपका भेजने वाला ऐप्लिकेशन यूज़र इंटरफ़ेस (यूआई) को ठीक से रेंडर करे.
MediaStatus में बदलाव किया जा रहा है
ट्रैक, विज्ञापन, लाइव स्ट्रीम, और सूची बनाने जैसी बेहतर सुविधाएं इस्तेमाल करने के लिए, आपके Android TV ऐप्लिकेशन को ऐसी अतिरिक्त जानकारी देनी होगी जिसका पता MediaSession
से न लगाया जा सके.
इसके लिए, हम MediaStatusModifier
क्लास उपलब्ध कराते हैं. MediaStatusModifier
हमेशा उस MediaSession
पर काम करेगा जिसे आपने CastReceiverContext
में सेट किया है.
MediaStatus
बनाने और ब्रॉडकास्ट करने के लिए:
val mediaManager: MediaManager = castReceiverContext.getMediaManager() val statusModifier: MediaStatusModifier = mediaManager.getMediaStatusModifier() statusModifier .setLiveSeekableRange(seekableRange) .setAdBreakStatus(adBreakStatus) .setCustomData(customData) mediaManager.broadcastMediaStatus()
MediaManager mediaManager = castReceiverContext.getMediaManager(); MediaStatusModifier statusModifier = mediaManager.getMediaStatusModifier(); statusModifier .setLiveSeekableRange(seekableRange) .setAdBreakStatus(adBreakStatus) .setCustomData(customData); mediaManager.broadcastMediaStatus();
हमारी क्लाइंट लाइब्रेरी को MediaSession
से बेस MediaStatus
मिलेगा. आपका Android TV ऐप्लिकेशन, MediaStatus
मॉडिफ़ायर की मदद से अतिरिक्त स्टेटस और बदलाव के स्टेटस की जानकारी दे सकता है.
कुछ राज्यों और मेटाडेटा को MediaSession
और
MediaStatusModifier
, दोनों में सेट किया जा सकता है. हमारा सुझाव है कि आप इसे
MediaSession
में ही सेट करें. हालांकि, MediaSession
में स्थितियों को बदलने के लिए, अब भी मॉडिफ़ायर का इस्तेमाल किया जा सकता है. हालांकि, आपको ऐसा नहीं करना चाहिए, क्योंकि मॉडिफ़ायर में स्थिति की प्राथमिकता, MediaSession
में दी गई वैल्यू से ज़्यादा होती है.
बाहर भेजने से पहले MediaStatus में रुकावट डालना
वेब रिसीवर SDK टूल की तरह ही, अगर आपको भेजने से पहले कुछ अंतिम रूप देना है, तो भेजे जाने वाले MediaStatus
को प्रोसेस करने के लिए MediaStatusInterceptor
तय करें. MediaStatus
को भेजने से पहले, उसमें बदलाव करने के लिए हम MediaStatusWriter
पास करते हैं.
mediaManager.setMediaStatusInterceptor(object : MediaStatusInterceptor { override fun intercept(mediaStatusWriter: MediaStatusWriter) { // Perform customization. mediaStatusWriter.setCustomData(JSONObject("{data: \"my Hello\"}")) } })
mediaManager.setMediaStatusInterceptor(new MediaStatusInterceptor() { @Override public void intercept(MediaStatusWriter mediaStatusWriter) { // Perform customization. mediaStatusWriter.setCustomData(new JSONObject("{data: \"my Hello\"}")); } });
उपयोगकर्ता के क्रेडेंशियल मैनेज करना
ऐसा हो सकता है कि आपका Android TV ऐप्लिकेशन, सिर्फ़ कुछ लोगों को ऐप्लिकेशन सेशन लॉन्च करने या उसमें शामिल होने की अनुमति दे. उदाहरण के लिए, न्योता भेजने या शामिल करने की अनुमति सिर्फ़ तब दें, जब:
- मैसेज भेजने वाले ऐप्लिकेशन से, उसी खाते और प्रोफ़ाइल में लॉग इन किया गया हो जिससे ATV ऐप्लिकेशन में लॉग इन किया गया है.
- भेजने वाले ऐप्लिकेशन से उसी खाते में लॉग इन किया गया है, लेकिन ATV ऐप्लिकेशन की प्रोफ़ाइल अलग है.
अगर आपका ऐप्लिकेशन कई लोगों या पहचान छिपाने वाले उपयोगकर्ताओं को मैनेज कर सकता है, तो दूसरे किसी भी उपयोगकर्ता को एटीवी सेशन में शामिल होने की अनुमति दी जा सकती है. अगर उपयोगकर्ता क्रेडेंशियल देता है, तो आपके एटीवी ऐप्लिकेशन को उसके क्रेडेंशियल मैनेज करने होंगे. इससे उसकी प्रोग्रेस और अन्य उपयोगकर्ता डेटा को सही तरीके से ट्रैक किया जा सकेगा.
जब आपका भेजने वाला ऐप्लिकेशन, Android TV ऐप्लिकेशन को लॉन्च करता है या उसमें शामिल होता है, तो भेजने वाले के ऐप्लिकेशन को वे क्रेडेंशियल देने चाहिए जिनसे पता चल सके कि सेशन में कौन शामिल हो रहा है.
आपके Android TV ऐप्लिकेशन को लॉन्च करने और उसमें शामिल होने से पहले, आपके पास एक लॉन्च चेकर तय करके यह देखने का विकल्प होता है कि उसे भेजने वाले के क्रेडेंशियल की अनुमति है या नहीं. अगर ऐसा नहीं है, तो Cast Connect SDK टूल फिर से आपके वेब रिसीवर को लॉन्च कर देता है.
ईमेल भेजने वाले ऐप्लिकेशन के क्रेडेंशियल का डेटा
भेजने वाले की तरफ़, CredentialsData
डालकर बताया जा सकता है कि सेशन में कौन शामिल हो रहा है.
credentials
एक ऐसी स्ट्रिंग है जिसे उपयोगकर्ता तब तक तय कर सकता है, जब तक आपका ATV ऐप्लिकेशन उसे समझ सके. credentialsType
से तय होता है कि CredentialsData
किस प्लैटफ़ॉर्म से आ रहा है या यह कस्टम वैल्यू हो सकती है. डिफ़ॉल्ट रूप से, यह उस प्लैटफ़ॉर्म पर सेट होता है
जिससे उसे भेजा जा रहा है.
CredentialsData
को सिर्फ़ आपके Android TV ऐप्लिकेशन को लॉन्च या शामिल होने के दौरान ही पास किया जाता है. अगर कनेक्ट होने के दौरान इसे फिर से सेट किया जाता है, तो यह आपके Android TV ऐप्लिकेशन को नहीं भेजा जाएगा. अगर प्रोफ़ाइल से कनेक्ट रहने के दौरान प्रोफ़ाइल स्विच की जाती है, तो सेशन में बने रह सकते हैं या अगर आपको लगता है कि नई प्रोफ़ाइल, सेशन के साथ काम नहीं करती है, तो SessionManager.endCurrentCastSession(boolean stopCasting)
पर कॉल करें.
CastLaunchRequest
और फिर getCredentialsData()
को पाने के लिए, CastReceiverContext
पर getCastLaunchRequest()
का इस्तेमाल करके, CredentialsData
का इस्तेमाल करके CastReceiverContext
को वापस लाया जा सकता है.getSenders
SenderInfo
इसके लिए, play-services-cast-framework
वर्शन
19.0.0
या इसके बाद का वर्शन होना ज़रूरी है.
CastContext.getSharedInstance().setLaunchCredentialsData( CredentialsData.Builder() .setCredentials("{\"userId\": \"abc\"}") .build() )
CastContext.getSharedInstance().setLaunchCredentialsData( new CredentialsData.Builder() .setCredentials("{\"userId\": \"abc\"}") .build());
इसके लिए, google-cast-sdk
वर्शन v4.8.1
या
इसके बाद का वर्शन होना ज़रूरी है.
विकल्प सेट होने के बाद, कभी भी कॉल किया जा सकता है:
GCKCastContext.setSharedInstanceWith(options)
.
GCKCastContext.sharedInstance().setLaunch( GCKCredentialsData(credentials: "{\"userId\": \"abc\"}")
इसके लिए, Chromium ब्राउज़र का M87
या इसके बाद का वर्शन होना ज़रूरी है.
विकल्प सेट होने के बाद, कभी भी कॉल किया जा सकता है:
cast.framework.CastContext.getInstance().setOptions(options);
.
let credentialsData = new chrome.cast.CredentialsData("{\"userId\": \"abc\"}"); cast.framework.CastContext.getInstance().setLaunchCredentialsData(credentialsData);
एटीवी के लॉन्च के अनुरोध पर जांच करने की सुविधा को लागू करना
जब कोई व्यक्ति आपके Android TV ऐप्लिकेशन को लॉन्च करता है या उसमें शामिल होने की कोशिश करता है, तब CredentialsData
को आपके Android TV ऐप्लिकेशन में भेज दिया जाता है. LaunchRequestChecker
लागू किया जा सकता है.
इस अनुरोध को स्वीकार या अस्वीकार करें.
अगर कोई अनुरोध अस्वीकार कर दिया जाता है, तो वेब रिसीवर को एटीवी ऐप्लिकेशन में स्थानीय रूप से लॉन्च करने के बजाय लोड किया जाता है. अगर आपका एटीवी, ऐप्लिकेशन लॉन्च करने या जॉइन करने के अनुरोध को मैनेज नहीं कर पा रहा है, तो आपको अनुरोध अस्वीकार कर देना चाहिए. उदाहरण के लिए, ऐसा हो सकता है कि अनुरोध करने के बजाय किसी दूसरे उपयोगकर्ता ने ATV ऐप्लिकेशन में लॉग इन किया हो और आपका ऐप्लिकेशन, क्रेडेंशियल बदलने के लिए काम न कर रहा हो. इसके अलावा, यह भी हो सकता है कि फ़िलहाल किसी उपयोगकर्ता ने ATV ऐप्लिकेशन में लॉग इन न किया हो.
अनुरोध की अनुमति मिलने पर, ATV ऐप्लिकेशन लॉन्च हो जाता है. इस सुविधा को इस आधार पर कस्टमाइज़ किया जा सकता है कि जब कोई उपयोगकर्ता एटीवी ऐप्लिकेशन में लॉग इन नहीं है या वह मेल नहीं खाता है, तो आपका ऐप्लिकेशन लोड करने के अनुरोध भेजने की सुविधा देता है या नहीं. इस व्यवहार को LaunchRequestChecker
में पूरी तरह से समझा जा सकता है.
CastReceiverOptions.LaunchRequestChecker
इंटरफ़ेस को लागू करने वाली क्लास बनाएं:
class MyLaunchRequestChecker : LaunchRequestChecker { override fun checkLaunchRequestSupported(launchRequest: CastLaunchRequest): Task{ return Tasks.call { myCheckLaunchRequest( launchRequest ) } } } private fun myCheckLaunchRequest(launchRequest: CastLaunchRequest): Boolean { val credentialsData = launchRequest.getCredentialsData() ?: return false // or true if you allow anonymous users to join. // The request comes from a mobile device, e.g. checking user match. return if (credentialsData.credentialsType == CredentialsData.CREDENTIALS_TYPE_ANDROID) { myCheckMobileCredentialsAllowed(credentialsData.getCredentials()) } else false // Unrecognized credentials type. }
public class MyLaunchRequestChecker implements CastReceiverOptions.LaunchRequestChecker { @Override public TaskcheckLaunchRequestSupported(CastLaunchRequest launchRequest) { return Tasks.call(() -> myCheckLaunchRequest(launchRequest)); } } private boolean myCheckLaunchRequest(CastLaunchRequest launchRequest) { CredentialsData credentialsData = launchRequest.getCredentialsData(); if (credentialsData == null) { return false; // or true if you allow anonymous users to join. } // The request comes from a mobile device, e.g. checking user match. if (credentialsData.getCredentialsType().equals(CredentialsData.CREDENTIALS_TYPE_ANDROID)) { return myCheckMobileCredentialsAllowed(credentialsData.getCredentials()); } // Unrecognized credentials type. return false; }
इसके बाद, इसे अपने
ReceiverOptionsProvider
में सेट करें:
class MyReceiverOptionsProvider : ReceiverOptionsProvider { override fun getOptions(context: Context?): CastReceiverOptions { return CastReceiverOptions.Builder(context) ... .setLaunchRequestChecker(MyLaunchRequestChecker()) .build() } }
public class MyReceiverOptionsProvider implements ReceiverOptionsProvider { @Override public CastReceiverOptions getOptions(Context context) { return new CastReceiverOptions.Builder(context) ... .setLaunchRequestChecker(new MyLaunchRequestChecker()) .build(); } }
LaunchRequestChecker
में true
को हल करने से ATV ऐप्लिकेशन लॉन्च हो जाता है और false
आपका वेब रिसीवर ऐप्लिकेशन लॉन्च हो जाता है.
कस्टम मैसेज भेजना और पाना
कास्ट प्रोटोकॉल से आप भेजने वालों और रिसीवर ऐप्लिकेशन के बीच कस्टम स्ट्रिंग मैसेज भेज सकते हैं. अपना CastReceiverContext
शुरू करने से पहले, सभी पर मैसेज भेजने के लिए, आपको नेमस्पेस (चैनल) रजिस्टर करना होगा.
Android TV—पसंद के मुताबिक नेमस्पेस बताएं
सेटअप के दौरान, आपको अपने CastReceiverOptions
में काम करने वाले नेमस्पेस के बारे में बताना होगा:
class MyReceiverOptionsProvider : ReceiverOptionsProvider { override fun getOptions(context: Context?): CastReceiverOptions { return CastReceiverOptions.Builder(context) .setCustomNamespaces( Arrays.asList("urn:x-cast:com.example.cast.mynamespace") ) .build() } }
public class MyReceiverOptionsProvider implements ReceiverOptionsProvider { @Override public CastReceiverOptions getOptions(Context context) { return new CastReceiverOptions.Builder(context) .setCustomNamespaces( Arrays.asList("urn:x-cast:com.example.cast.mynamespace")) .build(); } }
Android TV—मैसेज भेजना
// If senderId is null, then the message is broadcasted to all senders. CastReceiverContext.getInstance().sendMessage( "urn:x-cast:com.example.cast.mynamespace", senderId, customString)
// If senderId is null, then the message is broadcasted to all senders. CastReceiverContext.getInstance().sendMessage( "urn:x-cast:com.example.cast.mynamespace", senderId, customString);
Android TV—पसंद के मुताबिक नेमस्पेस मैसेज पाएं
class MyCustomMessageListener : MessageReceivedListener { override fun onMessageReceived( namespace: String, senderId: String?, message: String ) { ... } } CastReceiverContext.getInstance().setMessageReceivedListener( "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());
class MyCustomMessageListener implements CastReceiverContext.MessageReceivedListener { @Override public void onMessageReceived( String namespace, String senderId, String message) { ... } } CastReceiverContext.getInstance().setMessageReceivedListener( "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());