MediaLibraryService के साथ कॉन्टेंट दिखाएं

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

क्रम में व्यवस्थित किए गए मीडिया कॉन्टेंट के उदाहरण
पहली इमेज: अलग-अलग तरह के मीडिया आइटम की हैरारकी के उदाहरण मीडिया लाइब्रेरी.

MediaLibraryService, एक स्टैंडर्ड एपीआई उपलब्ध कराता है. इसकी मदद से, मीडिया लाइब्रेरी. यह सहायक हो सकता है, उदाहरण के लिए, Android Auto, जो कि आपके मीडिया ऐप्लिकेशन में भी काम करता है. Android Auto की मदद से, आपकी मीडिया लाइब्रेरी के लिए ड्राइवर-सुरक्षित यूज़र इंटरफ़ेस (यूआई).

MediaLibraryService बनाएं

MediaLibraryService को लागू करना MediaSessionService लागू करना, इसके अलावा, onGetSession() वाले तरीके में आपको MediaSession के बजाय MediaLibrarySession दिखाएं.

Kotlin

class PlaybackService : MediaLibraryService() {
  var mediaLibrarySession: MediaLibrarySession? = null
  var callback: MediaLibrarySession.Callback = object : MediaLibrarySession.Callback {...}

  // If desired, validate the controller before returning the media library session
  override fun onGetSession(controllerInfo: MediaSession.ControllerInfo): MediaLibrarySession? =
    mediaLibrarySession

  // Create your player and media library session in the onCreate lifecycle event
  override fun onCreate() {
    super.onCreate()
    val player = ExoPlayer.Builder(this).build()
    mediaLibrarySession = MediaLibrarySession.Builder(this, player, callback).build()
  }

  // Remember to release the player and media library session in onDestroy
  override fun onDestroy() {
    mediaLibrarySession?.run { 
      player.release()
      release()
      mediaLibrarySession = null
    }
    super.onDestroy()
  }
}

Java

class PlaybackService extends MediaLibraryService {
  MediaLibrarySession mediaLibrarySession = null;
  MediaLibrarySession.Callback callback = new MediaLibrarySession.Callback() {...};

  @Override
  public MediaLibrarySession onGetSession(MediaSession.ControllerInfo controllerInfo) {
    // If desired, validate the controller before returning the media library session
    return mediaLibrarySession;
  }

  // Create your player and media library session in the onCreate lifecycle event
  @Override
  public void onCreate() {
    super.onCreate();
    ExoPlayer player = new ExoPlayer.Builder(this).build();
    mediaLibrarySession = new MediaLibrarySession.Builder(this, player, callback).build();
  }

  // Remember to release the player and media library session in onDestroy
  @Override
  public void onDestroy() {
    if (mediaLibrarySession != null) {
      mediaLibrarySession.getPlayer().release();
      mediaLibrarySession.release();
      mediaLibrarySession = null;
    }
    super.onDestroy();
  }
}

मेनिफ़ेस्ट फ़ाइल में, अपने Service और ज़रूरी अनुमतियों के बारे में एलान करना न भूलें साथ ही:

<service
    android:name=".PlaybackService"
    android:foregroundServiceType="mediaPlayback"
    android:exported="true">
    <intent-filter>
        <action android:name="androidx.media3.session.MediaSessionService"/>
    </intent-filter>
</service>

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- For targetSdk 34+ -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

MediaLibrarySession का इस्तेमाल करें

MediaLibraryService एपीआई के मुताबिक, आपकी मीडिया लाइब्रेरी ट्री फ़ॉर्मैट, जिसमें सिंगल रूट नोड और चाइल्ड नोड होते हैं. यह चलाया जा सकता है या फिर इन्हें ब्राउज़ किया जा सके.

MediaLibrarySession कॉन्टेंट ब्राउज़िंग एपीआई जोड़ने के लिए, MediaSession एपीआई को बढ़ाएं. इसकी तुलना में MediaSession कॉलबैक, MediaLibrarySession कॉलबैक इस तरह की विधियां जोड़ता है:

  • onGetLibraryRoot() जब कोई क्लाइंट किसी कॉन्टेंट ट्री के रूट MediaItem का अनुरोध करता है
  • onGetChildren() जब कोई क्लाइंट, कॉन्टेंट ट्री में मौजूद MediaItem के बच्चों से अनुरोध करता है
  • onGetSearchResult() जब कोई क्लाइंट किसी दिए गए विषय के लिए कॉन्टेंट ट्री से खोज नतीजों का अनुरोध करता है क् वेरी

काम के कॉलबैक के तरीकों में एक LibraryParams शामिल होगा ऐसा ऑब्जेक्ट जो क्लाइंट ऐप्लिकेशन के कॉन्टेंट ट्री के टाइप के बारे में अतिरिक्त सिग्नल के साथ करता है रुचि है.