মিডিয়া অ্যাপগুলিতে প্রায়শই মিডিয়া আইটেমের সংগ্রহ থাকে, যা একটি শ্রেণিবিন্যাসে সংগঠিত থাকে। উদাহরণস্বরূপ, একটি অ্যালবামের গান বা একটি প্লেলিস্টে টিভি পর্ব। মিডিয়া আইটেমের এই শ্রেণিবিন্যাসকে মিডিয়া লাইব্রেরি বলা হয়।
একটি 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"/>
<action android:name="android.media.browse.MediaBrowserService"/>
</intent-filter>
</service>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<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 অবজেক্ট অন্তর্ভুক্ত থাকবে যেখানে ক্লায়েন্ট অ্যাপের আগ্রহের ধরণের কন্টেন্ট ট্রি সম্পর্কে অতিরিক্ত সংকেত থাকবে।
মিডিয়া আইটেমের জন্য কমান্ড বোতাম
একটি সেশন অ্যাপ MediaMetadata MediaItem দ্বারা সমর্থিত কমান্ড বোতামগুলি ঘোষণা করতে পারে। এটি একটি মিডিয়া আইটেমে এক বা একাধিক CommandButton এন্ট্রি বরাদ্দ করতে দেয় যা একটি নিয়ামক প্রদর্শন করতে পারে এবং আইটেমটির জন্য কাস্টম কমান্ডটি সেশনে সুবিধাজনক উপায়ে পাঠানোর জন্য ব্যবহার করতে পারে।
সেশন সাইডে কমান্ড বোতাম সেটআপ করুন
সেশন তৈরি করার সময়, একটি সেশন অ্যাপ কাস্টম কমান্ড হিসেবে সেশন পরিচালনা করতে পারে এমন কমান্ড বোতামগুলির সেট ঘোষণা করে:
কোটলিন
val allCommandButtons = listOf( CommandButton.Builder(CommandButton.ICON_PLAYLIST_ADD) .setDisplayName(context.getString(R.string.add_to_playlist)) .setSessionCommand(SessionCommand(COMMAND_PLAYLIST_ADD, Bundle.EMPTY)) .setExtras(playlistAddExtras) .build(), CommandButton.Builder(CommandButton.ICON_RADIO) .setDisplayName(context.getString(R.string.radio_station)) .setSessionCommand(SessionCommand(COMMAND_RADIO, Bundle.EMPTY)) .setExtras(radioExtras) .build(), // possibly more here ) // Add all command buttons for media items supported by the session. val session = MediaSession.Builder(context, player) .setCommandButtonsForMediaItems(allCommandButtons) .build()
জাভা
ImmutableList<CommandButton> allCommandButtons = ImmutableList.of( new CommandButton.Builder(CommandButton.ICON_PLAYLIST_ADD) .setDisplayName(context.getString(R.string.add_to_playlist)) .setSessionCommand(new SessionCommand(COMMAND_PLAYLIST_ADD, Bundle.EMPTY)) .setExtras(playlistAddExtras) .build(), new CommandButton.Builder(CommandButton.ICON_RADIO) .setDisplayName(context.getString(R.string.radio_station)) .setSessionCommand(new SessionCommand(COMMAND_RADIO, Bundle.EMPTY)) .setExtras(radioExtras) .build()); // Add all command buttons for media items supported by the session. MediaSession session = new MediaSession.Builder(context, player) .setCommandButtonsForMediaItems(allCommandButtons) .build();
একটি মিডিয়া আইটেম তৈরি করার সময়, একটি সেশন অ্যাপ সমর্থিত কমান্ড আইডিগুলির একটি সেট যোগ করতে পারে যা সেশন তৈরির সময় সেটআপ করা কমান্ড বোতামগুলির সেশন কমান্ডগুলিকে উল্লেখ করে:
কোটলিন
val mediaItem = MediaItem.Builder() .setMediaMetadata( MediaMetadata.Builder() .setSupportedCommands(listOf(COMMAND_PLAYLIST_ADD, COMMAND_RADIO)) .build()) .build()
জাভা
MediaItem mediaItem = new MediaItem.Builder() .setMediaMetadata( new MediaMetadata.Builder() .setSupportedCommands(ImmutableList.of(COMMAND_PLAYLIST_ADD, COMMAND_RADIO)) .build()) .build();
যখন কোনও কন্ট্রোলার বা ব্রাউজার Callback সেশনের অন্য কোনও পদ্ধতিতে সংযোগ স্থাপন করে বা কল করে, তখন সেশন অ্যাপটি কলব্যাকে পাঠানো ControllerInfo পরীক্ষা করে দেখতে পারে যাতে একটি কন্ট্রোলার বা ব্রাউজার সর্বোচ্চ কতগুলি কমান্ড বোতাম প্রদর্শন করতে পারে। ControllerInfo একটি কলব্যাক পদ্ধতিতে পাস করা হলে এই মানটি সুবিধাজনকভাবে অ্যাক্সেস করার জন্য একটি গেটার সরবরাহ করে। ডিফল্টরূপে মানটি 0 তে সেট করা থাকে যা নির্দেশ করে যে ব্রাউজার বা কন্ট্রোলার এই বৈশিষ্ট্যটি সমর্থন করে না:
কোটলিন
override fun onGetItem( session: MediaLibrarySession, browser: MediaSession.ControllerInfo, mediaId: String, ): ListenableFuture<LibraryResult<MediaItem>> { val settableFuture = SettableFuture.create<LibraryResult<MediaItem>>() val maxCommandsForMediaItems = browser.maxCommandsForMediaItems scope.launch { loadMediaItem(settableFuture, mediaId, maxCommandsForMediaItems) } return settableFuture }
জাভা
@Override public ListenableFuture<LibraryResult<MediaItem>> onGetItem( MediaLibraryService.MediaLibrarySession session, ControllerInfo browser, String mediaId) { SettableFuture<LibraryResult<MediaItem>> settableFuture = SettableFuture.create(); int maxCommandsForMediaItems = browser.getMaxCommandsForMediaItems(); loadMediaItemAsync(settableFuture, mediaId, maxCommandsForMediaItems); return settableFuture; }
কোনও মিডিয়া আইটেমের জন্য প্রেরিত কোনও কাস্টম অ্যাকশন পরিচালনা করার সময়, সেশন অ্যাপটি Bundle এ পাস করা আর্গুমেন্টগুলি থেকে মিডিয়া আইটেম আইডি পেতে পারে onCustomCommand :
কোটলিন
override fun onCustomCommand( session: MediaSession, controller: MediaSession.ControllerInfo, customCommand: SessionCommand, args: Bundle, ): ListenableFuture<SessionResult> { val mediaItemId = args.getString(MediaConstants.EXTRA_KEY_MEDIA_ID) return if (mediaItemId != null) handleCustomCommandForMediaItem(controller, customCommand, mediaItemId, args) else handleCustomCommand(controller, customCommand, args) }
জাভা
@Override public ListenableFuture<SessionResult> onCustomCommand( MediaSession session, ControllerInfo controller, SessionCommand customCommand, Bundle args) { String mediaItemId = args.getString(MediaConstants.EXTRA_KEY_MEDIA_ID); return mediaItemId != null ? handleCustomCommandForMediaItem(controller, customCommand, mediaItemId, args) : handleCustomCommand(controller, customCommand, args); }
ব্রাউজার বা কন্ট্রোলার হিসেবে কমান্ড বোতাম ব্যবহার করুন
MediaController দিক থেকে, একটি অ্যাপ MediaController বা MediaBrowser তৈরি করার সময় একটি মিডিয়া আইটেমের জন্য সর্বোচ্চ কতগুলি কমান্ড বোতাম সমর্থন করে তা ঘোষণা করতে পারে:
কোটলিন
val browserFuture = MediaBrowser.Builder(context, sessionToken) .setMaxCommandsForMediaItems(3) .buildAsync()
জাভা
ListenableFuture<MediaBrowser> browserFuture = new MediaBrowser.Builder(context, sessionToken) .setMaxCommandsForMediaItems(3) .buildAsync();
সেশনের সাথে সংযুক্ত থাকাকালীন, কন্ট্রোলার অ্যাপটি মিডিয়া আইটেম দ্বারা সমর্থিত কমান্ড বোতামগুলি গ্রহণ করতে পারে এবং যার জন্য কন্ট্রোলারটি সেশন অ্যাপ দ্বারা প্রদত্ত উপলব্ধ কমান্ড পেয়েছে:
কোটলিন
val commandButtonsForMediaItem: List<CommandButton> = controller.getCommandButtonsForMediaItem(mediaItem)
জাভা
ImmutableList<CommandButton> commandButtonsForMediaItem = controller.getCommandButtonsForMediaItem(mediaItem);
সুবিধার জন্য, একজন MediaController MediaController.sendCustomCommand(SessionCommand, MediaItem, Bundle) সাহায্যে মিডিয়া আইটেম নির্দিষ্ট কাস্টম কমান্ড পাঠাতে পারে:
কোটলিন
controller.sendCustomCommand(addToPlaylistButton.sessionCommand!!, mediaItem, Bundle.EMPTY)
জাভা
controller.sendCustomCommand( checkNotNull(addToPlaylistButton.sessionCommand), mediaItem, Bundle.EMPTY);