किसी मीडिया से क्वेरी करने और उसे कंट्रोल करने के लिए, मीडिया कंट्रोलर, मीडिया सेशन से इंटरैक्ट करता है
ऐप्लिकेशन पर वीडियो चलाने की सुविधा देते हैं. Media3 में, MediaController
एपीआई, Player
इंटरफ़ेस को लागू करता है. मीडिया का इस्तेमाल करने वाले क्लाइंट ऐप्लिकेशन के उदाहरण
कंट्रोलर में शामिल है:
- Android सिस्टम के मीडिया कंट्रोल
- Android Wear OS का साथी ऐप्लिकेशन
- Android Auto और Automotive OS
- वॉइस असिस्टेंट, जैसे कि Google Assistant
- मीडिया कंट्रोलर टेस्ट ऐप्लिकेशन
मीडिया कंट्रोलर किसी मीडिया ऐप्लिकेशन में भी काम का हो सकता है. उदाहरण के लिए, अगर
प्लेयर और मीडिया सत्र Service
में Activity
से अलग
यूज़र इंटरफ़ेस (यूआई) वाला Fragment
.
MediaController
बनाएं
MediaController
बनाने के लिए, उससे जुड़े MediaSession
के लिए SessionToken
बनाएं. इसका onStart()
तरीका आपके Activity
या
इसके लिए, Fragment
एक अच्छा तरीका हो सकता है.
Kotlin
val sessionToken = SessionToken(context, ComponentName(context, PlaybackService::class.java))
Java
SessionToken sessionToken = new SessionToken(context, new ComponentName(context, PlaybackService.class));
इसके बाद MediaController
बनाने के लिए इस SessionToken
का इस्तेमाल करने पर,
कंट्रोलर को दिए गए सेशन में ले जाना चाहती है. यह प्रोसेस एसिंक्रोनस तरीके से होती है. इसलिए, आपको नतीजे के लिए इंतज़ार करना चाहिए और उपलब्ध होने पर उसका इस्तेमाल करना चाहिए.
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());
MediaController
का इस्तेमाल करना
MediaController
, Player
इंटरफ़ेस को लागू करता है, ताकि आप निर्देशों का इस्तेमाल कर सकें
इंटरफ़ेस में, कनेक्ट किए गए MediaSession
के प्लेबैक को कंट्रोल करने के लिए बनाया गया है.
इसका मतलब यह है कि MediaController
पर play()
को कॉल करने पर
कमांड की मदद से कनेक्ट किए गए MediaSession
को निर्देश दें, जो बाद में
कमांड को इसके अंतर्निहित Player
में जोड़ दें.
इसी तरह, सुनने के लिए कंट्रोलर में Player.Listener
जोड़ा जा सकता है
Player
की स्थिति में बदलाव. Player.Listener
का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, प्लेयर इवेंट गाइड देखें. MediaController.Listener
इंटरफ़ेस, कनेक्ट किए गए MediaSession
से मिलने वाले इवेंट और निर्देशों के लिए अतिरिक्त कॉलबैक तय करता है. जैसे, onAvailableSessionCommandsChanged()
, जब मीडिया सेशन में सेशन के लिए उपलब्ध निर्देशों में बदलाव होता है और onDisconnected()
, जब कंट्रोलर को सेशन से डिसकनेक्ट किया जाता है.
दूसरे कॉम्पोनेंट की तरह, MediaController
को तब रिलीज़ करना न भूलें, जब यह
अब ज़रूरत नहीं है, जैसे कि onStop()
तरीके में Activity
या
Fragment
.
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());