किसी मीडिया ऐप्लिकेशन से कनेक्ट करना

मीडिया कंट्रोलर, मीडिया सेशन के साथ इंटरैक्ट करता है, ताकि मीडिया ऐप्लिकेशन के प्लेबैक के बारे में क्वेरी की जा सके और उसे कंट्रोल किया जा सके. Media3 में, MediaController एपीआई, Player इंटरफ़ेस को लागू करता है. मीडिया कंट्रोलर का इस्तेमाल करने वाले क्लाइंट ऐप्लिकेशन के उदाहरणों में ये शामिल हैं:

• Android सिस्टम के मीडिया कंट्रोल
• Android Wear OS का साथी ऐप्लिकेशन
• Android Auto और Automotive OS
• Google Assistant जैसी वॉइस असिस्टेंट
• Media Controller Test ऐप्लिकेशन

मीडिया कंट्रोलर, मीडिया ऐप्लिकेशन में भी काम का हो सकता है. उदाहरण के लिए, अगर प्लेयर और मीडिया सेशन, यूज़र इंटरफ़ेस (यूआई) के साथ Activity या Fragment से अलग Service में मौजूद हैं.

MediaController बनाएं

MediaController बनाने के लिए, उससे जुड़े MediaSession के लिए SessionToken बनाएं. इसके लिए, Activity या Fragment के onStart() तरीके का इस्तेमाल किया जा सकता है.

Kotlin

val sessionToken = 
  SessionToken(context, ComponentName(context, PlaybackService::class.java))

Java

SessionToken sessionToken = 
  new SessionToken(context, new ComponentName(context, PlaybackService.class));

इस SessionToken का इस्तेमाल करके, MediaController बनाने पर, कंट्रोलर को दिए गए सेशन से कनेक्ट किया जाता है. यह प्रोसेस एसिंक्रोनस तरीके से होती है. इसलिए, आपको नतीजे के लिए इंतज़ार करना चाहिए और उपलब्ध होने पर उसका इस्तेमाल करना चाहिए.

Kotlin

val controllerFuture =
  MediaController.Builder(context, sessionToken).buildAsync()
controllerFuture.addListener({
  // MediaController is available here with controllerFuture.get()
}, MoreExecutors.directExecutor())

Java

ListenableFuture<MediaController> controllerFuture =
  new MediaController.Builder(context, sessionToken).buildAsync();
controllerFuture.addListener(() -> {
  // MediaController is available here with controllerFuture.get()
}, MoreExecutors.directExecutor());

ध्यान दें: अगर आपने अपनी सेवा को यूज़र इंटरफ़ेस (यूआई) के बजाय किसी दूसरी प्रोसेस में चलाया है, तो MoreExecutors.directExecutor() के बजाय ContextCompat.getMainExecutor() का इस्तेमाल करें.

ध्यान दें: SDK टूल लेवल 30 या उसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन को, अपने मेनिफ़ेस्ट में <queries> एलिमेंट शामिल करना होगा. इससे, किसी दूसरे ऐप्लिकेशन के MediaSessionService (या मिलते-जुलते कॉम्पोनेंट) से कनेक्ट किया जा सकता है. ज़्यादा जानकारी के लिए, पैकेज की उपलब्धता के बारे में बताने वाली गाइड देखें.

MediaController का इस्तेमाल करना

MediaController, Player इंटरफ़ेस को लागू करता है, ताकि कनेक्ट किए गए MediaSession के प्लेबैक को कंट्रोल करने के लिए, इंटरफ़ेस में दिए गए निर्देशों का इस्तेमाल किया जा सके. इसका मतलब है कि MediaController पर play() को कॉल करने से, MediaSession को निर्देश भेजा जाएगा. इसके बाद, MediaSession अपने Player को निर्देश देगा.

सलाह: मीडिया कंट्रोलर, Player इंटरफ़ेस को लागू करता है. इसलिए, इसे अपने यूज़र इंटरफ़ेस (यूआई) में प्लेयर को असाइन किया जा सकता है.

इसी तरह, Player स्टेटस में होने वाले बदलावों को सुनने के लिए, कंट्रोलर में Player.Listener जोड़ा जा सकता है. Player.Listener का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, प्लेयर इवेंट गाइड देखें. MediaController.Listener इंटरफ़ेस, कनेक्ट किए गए MediaSession से मिलने वाले इवेंट और निर्देशों के लिए अतिरिक्त कॉलबैक तय करता है. जैसे, onAvailableSessionCommandsChanged(), जब मीडिया सेशन में सेशन के लिए उपलब्ध निर्देशों में बदलाव होता है और onDisconnected(), जब कंट्रोलर को सेशन से डिसकनेक्ट किया जाता है.

अन्य कॉम्पोनेंट की तरह ही, जब MediaController की ज़रूरत न हो, तो उसे रिलीज़ करना न भूलें. जैसे, Activity या Fragment के onStop() तरीके में.

Kotlin

MediaController.releaseFuture(controllerFuture)

Java

MediaController.releaseFuture(controllerFuture);

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

MediaBrowser बनाना और उसका इस्तेमाल करना

MediaBrowser, MediaController की सुविधाओं के साथ काम करता है. इससे मीडिया ऐप्लिकेशन के MediaLibraryService की लाइब्रेरी को ब्राउज़ करने की सुविधा भी मिलती है.

Kotlin

val browserFuture = MediaBrowser.Builder(context, sessionToken).buildAsync()
browserFuture.addListener({
  // MediaBrowser is available here with browserFuture.get()
}, MoreExecutors.directExecutor())

Java

ListenableFuture<MediaBrowser> browserFuture =
  new MediaBrowser.Builder(context, sessionToken).buildAsync();
browserFuture.addListener(() -> {
  // MediaBrowser is available here with browserFuture.get()
}, MoreExecutors.directExecutor());

मीडिया ऐप्लिकेशन की कॉन्टेंट लाइब्रेरी को ब्राउज़ करना शुरू करने के लिए, सबसे पहले getLibraryRoot() का इस्तेमाल करके रूट नोड पाएं:

Kotlin

// Get the library root to start browsing the library tree.
val rootFuture = mediaBrowser.getLibraryRoot(/* params= */ null)
rootFuture.addListener({
  // Root node MediaItem is available here with rootFuture.get().value
}, MoreExecutors.directExecutor())

Java

// Get the library root to start browsing the library tree.
ListenableFuture<LibraryResult<MediaItem>> rootFuture =
  mediaBrowser.getLibraryRoot(/* params= */ null);
rootFuture.addListener(() -> {
  // Root node MediaItem is available here with rootFuture.get().value
}, MoreExecutors.directExecutor());

इसके बाद, getChildren() का इस्तेमाल करके लाइब्रेरी में MediaItem के बच्चों को ढूंढकर, मीडिया लाइब्रेरी में नेविगेट किया जा सकता है. उदाहरण के लिए, रूट नोड MediaItem के चाइल्ड को वापस पाने के लिए:

Kotlin

// Get the library root to start browsing the library tree.
val childrenFuture = 
  mediaBrowser.getChildren(rootMediaItem.mediaId, 0, Int.MAX_VALUE, null)
childrenFuture.addListener({
  // List of children MediaItem nodes is available here with
  // childrenFuture.get().value
}, MoreExecutors.directExecutor())

Java

ListenableFuture<LibraryResult<ImmutableList<MediaItem>>> childrenFuture =
  mediaBrowser.getChildren(rootMediaItem.mediaId, 0, Integer.MAX_VALUE, null);
childrenFuture.addListener(() -> {
  // List of children MediaItem nodes is available here with
  // childrenFuture.get().value
}, MoreExecutors.directExecutor());