মিডিয়া অ্যাপ্লিকেশানগুলিতে প্রায়ই মিডিয়া আইটেমগুলির সংগ্রহ থাকে, একটি শ্রেণিবিন্যাসে সংগঠিত৷ উদাহরণস্বরূপ, একটি অ্যালবামের গান বা প্লেলিস্টে টিভি পর্ব। মিডিয়া আইটেমগুলির এই শ্রেণিবিন্যাস একটি মিডিয়া লাইব্রেরি হিসাবে পরিচিত।
একটি MediaLibraryService আপনার মিডিয়া লাইব্রেরি পরিবেশন এবং অ্যাক্সেস করার জন্য একটি প্রমিত API প্রদান করে। এটি সহায়ক হতে পারে, উদাহরণস্বরূপ, আপনার মিডিয়া অ্যাপে Android Auto-এর জন্য সমর্থন যোগ করার সময়, যা আপনার মিডিয়া লাইব্রেরির জন্য নিজস্ব ড্রাইভার-নিরাপদ UI প্রদান করে।
একটি MediaLibraryService তৈরি করুন
একটি MediaLibraryService বাস্তবায়ন করা একটি MediaSessionService বাস্তবায়নের অনুরূপ, onGetSession() পদ্ধতিতে, আপনি একটি MediaSession এর পরিবর্তে একটি MediaLibrarySession ফেরত দেবেন।
কোটলিন
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() } }
জাভা
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 API আশা করে যে আপনার মিডিয়া লাইব্রেরিটি একটি ট্রি ফরম্যাটে গঠন করা হবে, একটি একক রুট নোড এবং চিলড্রেন নোড সহ যা প্লে করা যায় বা আরও ব্রাউজ করা যায় ।
একটি MediaLibrarySession কন্টেন্ট ব্রাউজিং API যোগ করতে MediaSession API-কে প্রসারিত করে। MediaSession কলব্যাকের তুলনায়, MediaLibrarySession কলব্যাক পদ্ধতি যোগ করে যেমন:
-
onGetLibraryRoot()যখন কোনো ক্লায়েন্ট কোনো কন্টেন্ট ট্রির রুটMediaItemঅনুরোধ করে -
onGetChildren()যখন কোনো ক্লায়েন্ট কন্টেন্ট ট্রিতে একটিMediaItemএর বাচ্চাদের অনুরোধ করে -
onGetSearchResult()যখন একটি ক্লায়েন্ট একটি প্রদত্ত প্রশ্নের জন্য বিষয়বস্তু গাছ থেকে অনুসন্ধান ফলাফলের অনুরোধ করে
প্রাসঙ্গিক কলব্যাক পদ্ধতিতে একটি LibraryParams অবজেক্ট অন্তর্ভুক্ত থাকবে যাতে একটি ক্লায়েন্ট অ্যাপ আগ্রহী এমন বিষয়বস্তু গাছের ধরন সম্পর্কে অতিরিক্ত সংকেত দেয়।