अपने ऐप्लिकेशन में MediaRouter फ़्रेमवर्क का इस्तेमाल करने के लिए, आपको MediaRouter ऑब्जेक्ट का इंस्टेंस पाना होगा. साथ ही, रूटिंग इवेंट सुनने के लिए, MediaRouter.Callback ऑब्जेक्ट को अटैच करना होगा.
मीडिया रूट पर भेजा गया कॉन्टेंट, रूट से जुड़े MediaRouteProvider से होकर गुज़रता है. हालांकि, कुछ खास मामलों में ऐसा नहीं होता. जैसे, ब्लूटूथ आउटपुट डिवाइस. पहली इमेज में, डिवाइसों के बीच कॉन्टेंट को रूट करने के लिए इस्तेमाल की जाने वाली क्लास के बारे में खास जानकारी दी गई है.
पहली इमेज. ऐप्लिकेशन में इस्तेमाल होने वाली मुख्य मीडिया राऊटर क्लास की खास जानकारी.
ध्यान दें: अगर आपको अपने ऐप्लिकेशन को Google Cast डिवाइसों के साथ काम करने लायक बनाना है, तो आपको Cast SDK का इस्तेमाल करना चाहिए. साथ ही, अपने ऐप्लिकेशन को Cast सेंडर के तौर पर बनाना चाहिए. MediaRouter फ़्रेमवर्क का सीधे तौर पर इस्तेमाल करने के बजाय, Cast के दस्तावेज़ में दिए गए निर्देशों का पालन करें.
मीडिया रूट बटन
Android ऐप्लिकेशन को मीडिया रूटिंग को कंट्रोल करने के लिए, मीडिया रूट बटन का इस्तेमाल करना चाहिए. MediaRouter फ़्रेमवर्क, बटन के लिए एक स्टैंडर्ड इंटरफ़ेस उपलब्ध कराता है. इससे उपयोगकर्ताओं को रूटिंग की सुविधा उपलब्ध होने पर, उसे पहचानने और इस्तेमाल करने में मदद मिलती है. मीडिया रूट बटन को आम तौर पर, आपके ऐप्लिकेशन के कार्रवाई बार की दाईं ओर रखा जाता है. जैसा कि दूसरी इमेज में दिखाया गया है.
दूसरी इमेज. कार्रवाई बार में मीडिया रूट बटन.
जब उपयोगकर्ता मीडिया रूट बटन दबाता है, तो उपलब्ध मीडिया रूट एक सूची में दिखते हैं. जैसा कि तीसरी इमेज में दिखाया गया है.
तीसरी इमेज. मीडिया रूट बटन दबाने के बाद, उपलब्ध मीडिया रूट की सूची दिखती है.
मीडिया रूट बटन बनाने के लिए, यह तरीका अपनाएं:
- AppCompatActivity का इस्तेमाल करना
- मीडिया रूट बटन के मेन्यू आइटम को तय करना
- MediaRouteSelector बनाना
- कार्रवाई बार में मीडिया रूट बटन जोड़ना
- अपनी गतिविधि की लाइफ़साइकल में MediaRouter.Callback के तरीके बनाना और उन्हें मैनेज करना
इस सेक्शन में, पहले चार चरणों के बारे में बताया गया है. अगले सेक्शन में, कॉलबैक के तरीकों के बारे में बताया गया है.
AppCompatActivity का इस्तेमाल करना
किसी गतिविधि में मीडिया राऊटर फ़्रेमवर्क का इस्तेमाल करते समय, आपको AppCompatActivity से गतिविधि को बढ़ाना चाहिए और androidx.appcompat.app पैकेज को इंपोर्ट करना चाहिए. आपको अपने ऐप्लिकेशन डेवलपमेंट प्रोजेक्ट में, androidx.appcompat:appcompat और androidx.mediarouter:mediarouter सपोर्ट लाइब्रेरी जोड़नी होंगी. अपने प्रोजेक्ट में सहायता लाइब्रेरी जोड़ने के बारे में ज़्यादा जानने के लिए, Android Jetpack का इस्तेमाल शुरू करना लेख पढ़ें.
चेतावनी: मीडिया राऊटर फ़्रेमवर्क के androidx
इंप्लिमेंटेशन का इस्तेमाल करें. पुराने android.media पैकेज का इस्तेमाल न करें.
मीडिया रूट बटन के मेन्यू आइटम को तय करना
एक एक्सएमएल फ़ाइल बनाएं, जो मीडिया रूट बटन के लिए मेन्यू आइटम तय करती हो.
आइटम की कार्रवाई, MediaRouteActionProvider क्लास होनी चाहिए.
यहां एक उदाहरण दिया गया है:
<menu xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" > <item android:id="@+id/media_route_menu_item" android:title="@string/media_route_menu_title" app:actionProviderClass="androidx.mediarouter.app.MediaRouteActionProvider" app:showAsAction="always" /> </menu>
MediaRouteSelector बनाना
मीडिया रूट बटन के मेन्यू में दिखने वाले रूट, MediaRouteSelector से तय होते हैं.
AppCompatActivity से अपनी गतिविधि को बढ़ाएं और onCreate() तरीके से MediaRouteSelector.Builder को कॉल करके गतिविधि बनने पर सिलेक्टर बनाएं. इसके बारे में यहां दिए गए कोड सैंपल में बताया गया है. ध्यान दें कि सिलेक्टर को क्लास वैरिएबल में सेव किया जाता है. साथ ही, अनुमति वाले रूट टाइप की जानकारी, MediaControlIntent ऑब्जेक्ट जोड़कर दी जाती है:
class MediaRouterPlaybackActivity : AppCompatActivity() { private var mSelector: MediaRouteSelector? = null override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Create a route selector for the type of routes your app supports. mSelector = MediaRouteSelector.Builder() // These are the framework-supported intents. .addControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK) .build() } }
ज़्यादातर ऐप्लिकेशन के लिए, सिर्फ़ CATEGORY_REMOTE_PLAYBACK रूट टाइप की ज़रूरत होती है. इस रूट टाइप में, आपके ऐप्लिकेशन को चलाने वाले डिवाइस को रिमोट कंट्रोल के तौर पर इस्तेमाल किया जाता है.
कनेक्ट किया गया रिसीवर डिवाइस, कॉन्टेंट के डेटा को वापस पाने, डिकोड करने, और चलाने की प्रोसेस को मैनेज करता है.
Google Cast की सुविधा वाले ऐप्लिकेशन, जैसे कि Chromecast इसी तरह काम करते हैं.
कुछ मैन्युफ़ैक्चरर, "सेकंडरी आउटपुट" नाम के खास रूटिंग विकल्प के साथ काम करते हैं. इस रूटिंग की मदद से, आपका मीडिया ऐप्लिकेशन, चुने गए रिमोट रिसीवर डिवाइस की स्क्रीन और/या स्पीकर पर सीधे वीडियो या संगीत को वापस लाता है, रेंडर करता है, और स्ट्रीम करता है.
सेकंडरी आउटपुट का इस्तेमाल करके, वायरलेस सुविधा वाले म्यूज़िक सिस्टम या वीडियो डिसप्ले पर कॉन्टेंट भेजें. इन डिवाइसों को खोजने और चुनने की सुविधा चालू करने के लिए, आपको MediaRouteSelector में CATEGORY_LIVE_AUDIO या CATEGORY_LIVE_VIDEO कंट्रोल कैटगरी जोड़नी होंगी. आपको अपना Presentation डायलॉग भी बनाना और मैनेज करना होगा.
कार्रवाई बार में मीडिया रूट बटन जोड़ना
मीडिया रूट मेन्यू और MediaRouteSelector तय करने के बाद, अब किसी गतिविधि में मीडिया रूट बटन जोड़ा जा सकता है.
विकल्प मेन्यू जोड़ने के लिए, अपनी हर गतिविधि के लिए onCreateOptionsMenu() तरीके को बदलें.
override fun onCreateOptionsMenu(menu: Menu): Boolean { super.onCreateOptionsMenu(menu) // Inflate the menu and configure the media router action provider. menuInflater.inflate(R.menu.sample_media_router_menu, menu) // Attach the MediaRouteSelector to the menu item. val mediaRouteMenuItem = menu.findItem(R.id.media_route_menu_item) val mediaRouteActionProvider = MenuItemCompat.getActionProvider(mediaRouteMenuItem) as MediaRouteActionProvider // Attach the MediaRouteSelector that you built in onCreate(). selector?.also(mediaRouteActionProvider::setRouteSelector) // Return true to show the menu. return true }
अपने ऐप्लिकेशन में कार्रवाई बार को लागू करने के बारे में ज़्यादा जानने के लिए, कार्रवाई बार डेवलपर गाइड देखें.
किसी भी व्यू में, मीडिया रूट बटन को MediaRouteButton के तौर पर भी जोड़ा जा सकता है. setRouteSelector() तरीके का इस्तेमाल करके, आपको बटन में MediaRouteSelector अटैच करना होगा. अपने ऐप्लिकेशन में मीडिया रूट बटन को शामिल करने के दिशा-निर्देशों के लिए, Google Cast की डिज़ाइन चेकलिस्ट देखें.
MediaRouter कॉलबैक
एक ही डिवाइस पर चल रहे सभी ऐप्लिकेशन, एक ही MediaRouter इंस्टेंस और उसके रूट शेयर करते हैं. इन्हें ऐप्लिकेशन के MediaRouteSelector की मदद से, हर ऐप्लिकेशन के हिसाब से फ़िल्टर किया जाता है. हर गतिविधि, MediaRouter.Callback तरीकों को लागू करके, MediaRouter के साथ कम्यूनिकेट करती है. जब भी उपयोगकर्ता किसी रूट को चुनता है, बदलता है या डिसकनेक्ट करता है, तब MediaRouter कॉलबैक के तरीकों को कॉल करता है.
कॉलबैक में कई तरीके हैं जिन्हें बदला जा सकता है. इससे आपको रूटिंग इवेंट के बारे में जानकारी मिलेगी. कम से कम, MediaRouter.Callback क्लास के आपके लागू करने के तरीके को onRouteSelected() और onRouteUnselected() को ओवरराइड करना चाहिए.
MediaRouter एक शेयर किया गया संसाधन है. इसलिए, आपके ऐप्लिकेशन को गतिविधि लाइफ़साइकल कॉलबैक के सामान्य कॉलबैक के जवाब में, MediaRouter कॉलबैक को मैनेज करना होगा:
- गतिविधि (
onCreate(Bundle)) बनने पर,MediaRouterका पॉइंटर लें और ऐप्लिकेशन के लाइफ़टाइम के लिए उसे होल्ड करके रखें. - जब गतिविधि दिखे (
onStart()), तब MediaRouter में कॉलबैक अटैच करें. साथ ही, गतिविधि छिपने (onStop()) पर उन्हें अलग करें.
यहां दिए गए कोड सैंपल में, कॉलबैक ऑब्जेक्ट बनाने और उसे सेव करने का तरीका बताया गया है. साथ ही, MediaRouter का इंस्टेंस पाने और कॉलबैक मैनेज करने का तरीका भी बताया गया है.
onStart() में कॉलबैक अटैच करते समय, CALLBACK_FLAG_REQUEST_DISCOVERY फ़्लैग के इस्तेमाल पर ध्यान दें.
इससे MediaRouteSelector, मीडिया रूट बटन की उपलब्ध रूट की सूची को रीफ़्रेश कर पाता है.
class MediaRouterPlaybackActivity : AppCompatActivity() { private var mediaRouter: MediaRouter? = null private var mSelector: MediaRouteSelector? = null // Variables to hold the currently selected route and its playback client. private var mRoute: MediaRouter.RouteInfo? = null private var remotePlaybackClient: RemotePlaybackClient? = null // Define the Callback object and its methods, save the object in a class variable. private val mediaRouterCallback = object : MediaRouter.Callback() { override fun onRouteSelected( router: MediaRouter, route: MediaRouter.RouteInfo, reason: Int ) { Log.d(TAG, "onRouteSelected: route=$route") if (route.supportsControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) { // Stop local playback (if necessary). // ... // Save the new route. mRoute = route // Attach a new playback client. remotePlaybackClient = RemotePlaybackClient(this@MediaRouterPlaybackActivity, route) // Start remote playback (if necessary). // ... } } override fun onRouteUnselected( router: MediaRouter, route: MediaRouter.RouteInfo, reason: Int ) { Log.d(TAG, "onRouteUnselected: route=$route") if (route.supportsControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) { // Changed route: tear down previous client. mRoute?.also { remotePlaybackClient?.release() remotePlaybackClient = null } // Save the new route. mRoute = route when { reason != MediaRouter.UNSELECT_REASON_ROUTE_CHANGED -> { // Resume local playback (if necessary). // ... } } } } } // Retain a pointer to the MediaRouter. override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Get the media router service. mediaRouter = MediaRouter.getInstance(this) // ... } // Use this callback to run your MediaRouteSelector to generate the // list of available media routes. override fun onStart() { mSelector?.also { selector -> mediaRouter?.addCallback( selector, mediaRouterCallback, MediaRouter.CALLBACK_FLAG_REQUEST_DISCOVERY ) } super.onStart() } // Remove the selector on stop to tell the media router that it no longer // needs to discover routes for your app. override fun onStop() { mediaRouter?.removeCallback(mediaRouterCallback) super.onStop() } // ... }
मीडिया राऊटर फ़्रेमवर्क, MediaRouteDiscoveryFragment क्लास भी उपलब्ध कराता है. यह किसी गतिविधि के लिए कॉलबैक जोड़ने और हटाने का काम करती है.
ध्यान दें: अगर आपको संगीत चलाने वाला कोई ऐप्लिकेशन बनाना है और आपको चाहिए कि वह बैकग्राउंड में भी संगीत चलाए, तो आपको संगीत चलाने के लिए Service बनाना होगा. साथ ही, सेवा के लाइफ़साइकल कॉलबैक से मीडिया राऊटर फ़्रेमवर्क को कॉल करना होगा.
रिमोट प्लेबैक रूट को कंट्रोल करना
रिमोट प्लेबैक रूट चुनने पर, आपका ऐप्लिकेशन रिमोट कंट्रोल की तरह काम करता है. रूट के दूसरे छोर पर मौजूद डिवाइस, कॉन्टेंट के डेटा को वापस पाने, डिकोड करने, और वीडियो चलाने के सभी फ़ंक्शन को मैनेज करता है. आपके ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में मौजूद कंट्रोल, RemotePlaybackClient ऑब्जेक्ट का इस्तेमाल करके, रिसीवर डिवाइस से कम्यूनिकेट करते हैं.
RemotePlaybackClient क्लास, कॉन्टेंट चलाने की सुविधा को मैनेज करने के लिए अन्य तरीके उपलब्ध कराती है. यहां RemotePlaybackClient क्लास से वीडियो चलाने के कुछ मुख्य तरीके दिए गए हैं:
play()—Uriसे तय की गई कोई मीडिया फ़ाइल चलाएं.pause()— फ़िलहाल चल रहे मीडिया ट्रैक को रोकें.resume()— रोकने के निर्देश के बाद, मौजूदा ट्रैक को चलाना जारी रखें.seek()— मौजूदा ट्रैक में किसी खास पोज़िशन पर जाएं.release()— अपने ऐप्लिकेशन से रिमोट प्लेबैक डिवाइस का कनेक्शन खत्म करें.
इन तरीकों का इस्तेमाल करके, अपने ऐप्लिकेशन में दिए गए प्लेबैक कंट्रोल में कार्रवाइयां जोड़ी जा सकती हैं. इनमें से ज़्यादातर तरीकों में, कॉलबैक ऑब्जेक्ट को शामिल करने की सुविधा भी मिलती है. इससे, प्लेबैक टास्क या कंट्रोल के अनुरोध की प्रोग्रेस को मॉनिटर किया जा सकता है.
RemotePlaybackClient क्लास, मीडिया चलाने के लिए कई मीडिया आइटम को सूची में जोड़ने और मीडिया सूची को मैनेज करने की सुविधा भी देती है.
सैंपल कोड
Android BasicMediaRouter और MediaRouter के सैंपल, MediaRouter API के इस्तेमाल के बारे में ज़्यादा जानकारी देते हैं.