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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

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

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

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

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

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

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

MediaController.releaseFuture(controllerFuture)

MediaController.releaseFuture(controllerFuture);

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

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

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

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

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

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

// 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())

// 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 के चाइल्ड को वापस पाने के लिए:

// 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())

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());

किसी दूसरे मीडिया ऐप्लिकेशन के लिए प्लेबैक कंट्रोल दिखाना

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

ऐप्लिकेशन की प्राथमिकताओं और यूज़र इंटरफ़ेस (यूआई) की सीमाओं और ज़रूरी शर्तों को हल करने का सबसे अच्छा तरीका, CommandButton.DisplayConstraints का इस्तेमाल करना है. आपके पास अपने यूज़र इंटरफ़ेस की सीमाओं और पाबंदियों को तय करने का विकल्प होता है. साथ ही, resolve तरीके से बटन की एक खास सूची मिलती है, जिसमें उनके आइकॉन, पोज़िशन, और कार्रवाई की जानकारी होती है.