আউটপুট সুইচার হল কাস্ট এসডিকে-র একটি বৈশিষ্ট্য যা অ্যান্ড্রয়েড ১৩ থেকে শুরু করে স্থানীয় এবং দূরবর্তী প্লেব্যাকের মধ্যে নির্বিঘ্নে কন্টেন্ট স্থানান্তর সক্ষম করে। লক্ষ্য হল প্রেরক অ্যাপগুলিকে কন্টেন্ট কোথায় চলছে তা সহজেই এবং দ্রুত নিয়ন্ত্রণ করতে সাহায্য করা। আউটপুট সুইচার ফোন স্পিকার, পেয়ার করা ব্লুটুথ ডিভাইস এবং দূরবর্তী কাস্ট-সক্ষম ডিভাইসগুলির মধ্যে কন্টেন্ট প্লেব্যাক স্যুইচ করতে MediaRouter লাইব্রেরি ব্যবহার করে। ব্যবহারের ক্ষেত্রে নিম্নলিখিত পরিস্থিতিতে বিভক্ত করা যেতে পারে:
আপনার অ্যাপে আউটপুট সুইচার কীভাবে প্রয়োগ করবেন তার রেফারেন্সের জন্য CastVideos-android নমুনা অ্যাপটি ডাউনলোড করুন এবং ব্যবহার করুন।
এই নির্দেশিকায় বর্ণিত ধাপগুলি ব্যবহার করে আউটপুট সুইচারটি লোকাল-টু-রিমোট, রিমোট-টু-লোকাল এবং রিমোট-টু-রিমোট সমর্থন করার জন্য সক্ষম করা উচিত। স্থানীয় ডিভাইস স্পিকার এবং জোড়াযুক্ত ব্লুটুথ ডিভাইসের মধ্যে স্থানান্তর সমর্থন করার জন্য কোনও অতিরিক্ত পদক্ষেপের প্রয়োজন নেই।
আউটপুট সুইচার UI
আউটপুট সুইচারটি উপলব্ধ স্থানীয় এবং দূরবর্তী ডিভাইসগুলির পাশাপাশি বর্তমান ডিভাইসের অবস্থা প্রদর্শন করে, যার মধ্যে ডিভাইসটি নির্বাচিত কিনা, সংযোগ করছে কিনা, বর্তমান ভলিউম স্তর অন্তর্ভুক্ত। বর্তমান ডিভাইস ছাড়াও যদি অন্যান্য ডিভাইস থাকে, তাহলে অন্য ডিভাইসে ক্লিক করলে আপনি নির্বাচিত ডিভাইসে মিডিয়া প্লেব্যাক স্থানান্তর করতে পারবেন।
জ্ঞাত সমস্যা
- স্থানীয় প্লেব্যাকের জন্য তৈরি মিডিয়া সেশনগুলি কাস্ট SDK বিজ্ঞপ্তিতে স্যুইচ করার সময় খারিজ করা হবে এবং পুনরায় তৈরি করা হবে।
প্রবেশের স্থান
মিডিয়া বিজ্ঞপ্তি
যদি কোনও অ্যাপ স্থানীয় প্লেব্যাকের জন্য MediaSession এর মাধ্যমে একটি মিডিয়া বিজ্ঞপ্তি পোস্ট করে (স্থানীয়ভাবে চালানো হয়), তাহলে মিডিয়া বিজ্ঞপ্তির উপরের ডানদিকের কোণায় একটি বিজ্ঞপ্তি চিপ প্রদর্শিত হয় যেখানে ডিভাইসের নাম (যেমন ফোন স্পিকার) থাকে যেখানে কন্টেন্টটি বর্তমানে চালানো হচ্ছে। বিজ্ঞপ্তি চিপে ট্যাপ করলে আউটপুট সুইচার ডায়ালগ সিস্টেম UI খোলে।
ভলিউম সেটিংস
ডিভাইসের ফিজিক্যাল ভলিউম বোতামে ক্লিক করে, নীচের সেটিংস আইকনে ট্যাপ করে এবং "Play <App Name> on Cast Device>" টেক্সটে ট্যাপ করেও আউটপুট সুইচার ডায়ালগ সিস্টেম UI ট্রিগার করা যেতে পারে।
পদক্ষেপের সারাংশ
- পূর্বশর্ত পূরণ নিশ্চিত করুন
- AndroidManifest.xml-এ আউটপুট সুইচার সক্ষম করুন
- ব্যাকগ্রাউন্ড কাস্টিংয়ের জন্য SessionManagerListener আপডেট করুন
- রিমোট-টু-রিমোটের জন্য সমর্থন যোগ করুন
- setRemoteToLocalEnabled ফ্ল্যাগ সেট করুন
- স্থানীয়ভাবে প্লেব্যাক চালিয়ে যান
পূর্বশর্ত
- আপনার বিদ্যমান Android অ্যাপটি AndroidX-এ স্থানান্তর করুন।
- আউটপুট সুইচারের জন্য Android Sender SDK-এর ন্যূনতম প্রয়োজনীয় সংস্করণ ব্যবহার করতে আপনার অ্যাপের
build.gradleআপডেট করুন:dependencies { ... implementation 'com.google.android.gms:play-services-cast-framework:21.2.0' ... }
- অ্যাপটি মিডিয়া বিজ্ঞপ্তি সমর্থন করে।
- Android 13 চালিত ডিভাইস।
মিডিয়া বিজ্ঞপ্তি সেট আপ করুন
আউটপুট সুইচার ব্যবহার করার জন্য, অডিও এবং ভিডিও অ্যাপগুলিকে স্থানীয় প্লেব্যাকের জন্য তাদের মিডিয়ার প্লেব্যাক স্ট্যাটাস এবং নিয়ন্ত্রণগুলি প্রদর্শনের জন্য একটি মিডিয়া বিজ্ঞপ্তি তৈরি করতে হবে। এর জন্য একটি MediaSession তৈরি করতে হবে, MediaSession এর টোকেন দিয়ে MediaStyle সেট করতে হবে এবং বিজ্ঞপ্তিতে মিডিয়া নিয়ন্ত্রণগুলি সেট করতে হবে।
আপনি যদি বর্তমানে MediaStyle এবং MediaSession ব্যবহার না করেন, তাহলে নিচের স্নিপেটটি কীভাবে সেট আপ করবেন তা দেখায় এবং অডিও এবং ভিডিও অ্যাপের জন্য মিডিয়া সেশন কলব্যাক সেট আপ করার জন্য নির্দেশিকা উপলব্ধ:
// Create a media session. NotificationCompat.MediaStyle // PlayerService is your own Service or Activity responsible for media playback. val mediaSession = MediaSessionCompat(this, "PlayerService") // Create a MediaStyle object and supply your media session token to it. val mediaStyle = Notification.MediaStyle().setMediaSession(mediaSession.sessionToken) // Create a Notification which is styled by your MediaStyle object. // This connects your media session to the media controls. // Don't forget to include a small icon. val notification = Notification.Builder(this@PlayerService, CHANNEL_ID) .setStyle(mediaStyle) .setSmallIcon(R.drawable.ic_app_logo) .build() // Specify any actions which your users can perform, such as pausing and skipping to the next track. val pauseAction: Notification.Action = Notification.Action.Builder( pauseIcon, "Pause", pauseIntent ).build() notification.addAction(pauseAction)
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) { // Create a media session. NotificationCompat.MediaStyle // PlayerService is your own Service or Activity responsible for media playback. MediaSession mediaSession = new MediaSession(this, "PlayerService"); // Create a MediaStyle object and supply your media session token to it. Notification.MediaStyle mediaStyle = new Notification.MediaStyle().setMediaSession(mediaSession.getSessionToken()); // Specify any actions which your users can perform, such as pausing and skipping to the next track. Notification.Action pauseAction = Notification.Action.Builder(pauseIcon, "Pause", pauseIntent).build(); // Create a Notification which is styled by your MediaStyle object. // This connects your media session to the media controls. // Don't forget to include a small icon. String CHANNEL_ID = "CHANNEL_ID"; Notification notification = new Notification.Builder(this, CHANNEL_ID) .setStyle(mediaStyle) .setSmallIcon(R.drawable.ic_app_logo) .addAction(pauseAction) .build(); }
অতিরিক্তভাবে, আপনার মিডিয়ার তথ্য দিয়ে বিজ্ঞপ্তিটি পূরণ করতে, আপনাকে আপনার মিডিয়ার মেটাডেটা এবং প্লেব্যাক অবস্থা MediaSession এ যোগ করতে হবে।
MediaSession এ মেটাডেটা যোগ করতে, setMetaData() ব্যবহার করুন এবং MediaMetadataCompat.Builder() এ আপনার মিডিয়ার জন্য সমস্ত প্রাসঙ্গিক MediaMetadata ধ্রুবক প্রদান করুন।
mediaSession.setMetadata(MediaMetadataCompat.Builder() // Title .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title) // Artist // Could also be the channel name or TV series. .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist) // Album art // Could also be a screenshot or hero image for video content // The URI scheme needs to be "content", "file", or "android.resource". .putString( MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri) ) // Duration // If duration isn't set, such as for live broadcasts, then the progress // indicator won't be shown on the seekbar. .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration) .build() )
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) { mediaSession.setMetadata( new MediaMetadataCompat.Builder() // Title .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title) // Artist // Could also be the channel name or TV series. .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist) // Album art // Could also be a screenshot or hero image for video content // The URI scheme needs to be "content", "file", or "android.resource". .putString(MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri) // Duration // If duration isn't set, such as for live broadcasts, then the progress // indicator won't be shown on the seekbar. .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration) .build() ); }
MediaSession এ প্লেব্যাক অবস্থা যোগ করতে, setPlaybackState() ব্যবহার করুন এবং PlaybackStateCompat.Builder() এ আপনার মিডিয়ার জন্য সমস্ত প্রাসঙ্গিক PlaybackStateCompat ধ্রুবক প্রদান করুন।
mediaSession.setPlaybackState( PlaybackStateCompat.Builder() .setState( PlaybackStateCompat.STATE_PLAYING, // Playback position // Used to update the elapsed time and the progress bar. mediaPlayer.currentPosition.toLong(), // Playback speed // Determines the rate at which the elapsed time changes. playbackSpeed ) // isSeekable // Adding the SEEK_TO action indicates that seeking is supported // and makes the seekbar position marker draggable. If this is not // supplied seek will be disabled but progress will still be shown. .setActions(PlaybackStateCompat.ACTION_SEEK_TO) .build() )
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) { mediaSession.setPlaybackState( new PlaybackStateCompat.Builder() .setState( PlaybackStateCompat.STATE_PLAYING, // Playback position // Used to update the elapsed time and the progress bar. mediaPlayer.currentPosition.toLong(), // Playback speed // Determines the rate at which the elapsed time changes. playbackSpeed ) // isSeekable // Adding the SEEK_TO action indicates that seeking is supported // and makes the seekbar position marker draggable. If this is not // supplied seek will be disabled but progress will still be shown. .setActions(PlaybackStateCompat.ACTION_SEEK_TO) .build() ); }
ভিডিও অ্যাপের বিজ্ঞপ্তির আচরণ
যেসব ভিডিও অ্যাপ বা অডিও অ্যাপ ব্যাকগ্রাউন্ডে স্থানীয় প্লেব্যাক সমর্থন করে না, তাদের মিডিয়া নোটিফিকেশনের জন্য নির্দিষ্ট আচরণ থাকা উচিত যাতে প্লেব্যাক সমর্থিত নয় এমন পরিস্থিতিতে মিডিয়া কমান্ড পাঠানোর সমস্যা এড়ানো যায়:
- স্থানীয়ভাবে মিডিয়া চালানোর সময় মিডিয়া বিজ্ঞপ্তি পোস্ট করুন এবং অ্যাপটি সামনে থাকবে।
- অ্যাপটি ব্যাকগ্রাউন্ডে থাকলে স্থানীয় প্লেব্যাক থামান এবং বিজ্ঞপ্তিটি খারিজ করুন।
- অ্যাপটি যখন ফোরগ্রাউন্ডে ফিরে যাবে, তখন স্থানীয় প্লেব্যাক পুনরায় শুরু হবে এবং বিজ্ঞপ্তিটি পুনরায় পোস্ট করা হবে।
AndroidManifest.xml-এ আউটপুট সুইচার সক্ষম করুন
আউটপুট সুইচার সক্ষম করার জন্য, MediaTransferReceiver অ্যাপের AndroidManifest.xml এ যোগ করতে হবে। যদি তা না হয়, তাহলে বৈশিষ্ট্যটি সক্ষম হবে না এবং রিমোট-টু-লোকাল বৈশিষ্ট্য পতাকাটিও অবৈধ হবে।
<application>
...
<receiver
android:name="androidx.mediarouter.media.MediaTransferReceiver"
android:exported="true">
</receiver>
...
</application>
MediaTransferReceiver হল একটি ব্রডকাস্ট রিসিভার যা সিস্টেম UI সহ ডিভাইসগুলির মধ্যে মিডিয়া ট্রান্সফার সক্ষম করে। আরও তথ্যের জন্য মিডিয়াট্রান্সফাররিসিভার রেফারেন্স দেখুন।
স্থানীয় থেকে দূরবর্তী
যখন ব্যবহারকারী লোকাল থেকে রিমোটে প্লেব্যাক স্যুইচ করে, তখন Cast SDK স্বয়ংক্রিয়ভাবে Cast সেশন শুরু করবে। তবে, অ্যাপগুলিকে লোকাল থেকে রিমোটে স্যুইচিং পরিচালনা করতে হবে, উদাহরণস্বরূপ স্থানীয় প্লেব্যাক বন্ধ করে Cast ডিভাইসে মিডিয়া লোড করতে হবে। অ্যাপগুলিকে onSessionStarted() এবং onSessionEnded() কলব্যাক ব্যবহার করে Cast SessionManagerListener শুনতে হবে এবং Cast SessionManager কলব্যাক গ্রহণ করার সময় অ্যাকশন পরিচালনা করতে হবে। অ্যাপগুলিকে নিশ্চিত করতে হবে যে আউটপুট সুইচার ডায়ালগ খোলা থাকাকালীন এবং অ্যাপটি ফোরগ্রাউন্ডে না থাকাকালীন এই কলব্যাকগুলি এখনও সক্রিয় রয়েছে।
ব্যাকগ্রাউন্ড কাস্টিংয়ের জন্য SessionManagerListener আপডেট করুন
অ্যাপটি ফোরগ্রাউন্ডে থাকাকালীন লিগ্যাসি কাস্ট অভিজ্ঞতা ইতিমধ্যেই লোকাল-টু-রিমোট সমর্থন করে। ব্যবহারকারীরা অ্যাপের কাস্ট আইকনে ক্লিক করলে এবং মিডিয়া স্ট্রিম করার জন্য একটি ডিভাইস বেছে নিলে একটি সাধারণ কাস্ট অভিজ্ঞতা শুরু হয়। এই ক্ষেত্রে, অ্যাপটিকে onCreate() অথবা onStart() ফাইলে SessionManagerListener ফাইলে নিবন্ধন করতে হবে এবং অ্যাপের কার্যকলাপের onStop() অথবা onDestroy() ফাইলে শ্রোতাকে নিবন্ধনমুক্ত করতে হবে।
আউটপুট সুইচার ব্যবহার করে কাস্টিংয়ের নতুন অভিজ্ঞতার মাধ্যমে, অ্যাপগুলি ব্যাকগ্রাউন্ডে থাকাকালীন কাস্টিং শুরু করতে পারে। এটি বিশেষ করে অডিও অ্যাপগুলির জন্য কার্যকর যারা ব্যাকগ্রাউন্ডে চলাকালীন বিজ্ঞপ্তি পোস্ট করে। অ্যাপগুলি পরিষেবার onCreate() এ SessionManager লিসেনারের নিবন্ধন করতে পারে এবং পরিষেবার onDestroy() এ নিবন্ধনমুক্ত করতে পারে। অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন অ্যাপগুলির সর্বদা স্থানীয়-থেকে-দূরবর্তী কলব্যাক (যেমন onSessionStarted ) গ্রহণ করা উচিত।
যদি অ্যাপটি MediaBrowserService ব্যবহার করে, তাহলে সেখানে SessionManagerListener নিবন্ধন করার পরামর্শ দেওয়া হচ্ছে।
class MyService : Service() { private var castContext: CastContext? = null protected fun onCreate() { castContext = CastContext.getSharedInstance(this) castContext .getSessionManager() .addSessionManagerListener(sessionManagerListener, CastSession::class.java) } protected fun onDestroy() { if (castContext != null) { castContext .getSessionManager() .removeSessionManagerListener(sessionManagerListener, CastSession::class.java) } } }
public class MyService extends Service { private CastContext castContext; @Override protected void onCreate() { castContext = CastContext.getSharedInstance(this); castContext .getSessionManager() .addSessionManagerListener(sessionManagerListener, CastSession.class); } @Override protected void onDestroy() { if (castContext != null) { castContext .getSessionManager() .removeSessionManagerListener(sessionManagerListener, CastSession.class); } } }
এই আপডেটের মাধ্যমে, অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন লোকাল-টু-রিমোট প্রচলিত কাস্টিংয়ের মতোই কাজ করবে এবং ব্লুটুথ ডিভাইস থেকে কাস্ট ডিভাইসে স্যুইচ করার জন্য অতিরিক্ত কাজের প্রয়োজন হবে না।
দূরবর্তী থেকে স্থানীয়
আউটপুট সুইচার রিমোট প্লেব্যাক থেকে ফোন স্পিকার বা স্থানীয় ব্লুটুথ ডিভাইসে স্থানান্তর করার ক্ষমতা প্রদান করে। CastOptions এ setRemoteToLocalEnabled ফ্ল্যাগটিকে true তে সেট করে এটি সক্ষম করা যেতে পারে।
যেসব ক্ষেত্রে বর্তমান প্রেরক ডিভাইসটি একাধিক প্রেরকের সাথে একটি বিদ্যমান সেশনে যোগদান করে এবং অ্যাপটিকে বর্তমান মিডিয়া স্থানীয়ভাবে স্থানান্তর করার অনুমতি আছে কিনা তা পরীক্ষা করতে হয়, সেসব ক্ষেত্রে অ্যাপগুলিকে SessionTransferCallback এর onTransferred কলব্যাক ব্যবহার করে SessionState পরীক্ষা করা উচিত।
setRemoteToLocalEnabled ফ্ল্যাগ সেট করুন
CastOptions.Builder একটি setRemoteToLocalEnabled প্রদান করে যা ফোনের স্পিকার এবং স্থানীয় ব্লুটুথ ডিভাইসগুলিকে আউটপুট সুইচার ডায়ালগে ট্রান্সফার-টু টার্গেট হিসেবে দেখাতে বা লুকাতে পারে যখন একটি সক্রিয় কাস্ট সেশন থাকে।
class CastOptionsProvider : OptionsProvider { fun getCastOptions(context: Context?): CastOptions { ... return Builder() ... .setRemoteToLocalEnabled(true) .build() } }
public class CastOptionsProvider implements OptionsProvider { @Override public CastOptions getCastOptions(Context context) { ... return new CastOptions.Builder() ... .setRemoteToLocalEnabled(true) .build() } }
স্থানীয়ভাবে প্লেব্যাক চালিয়ে যান
যেসব অ্যাপ রিমোট-টু-লোকাল সাপোর্ট করে তাদের SessionTransferCallback নিবন্ধন করা উচিত যাতে ইভেন্টটি ঘটলে বিজ্ঞপ্তি পাওয়া যায় এবং তারা পরীক্ষা করতে পারে যে মিডিয়া স্থানান্তর করার অনুমতি দেওয়া উচিত কিনা এবং স্থানীয়ভাবে প্লেব্যাক চালিয়ে যাওয়া উচিত কিনা।
CastContext#addSessionTransferCallback(SessionTransferCallback) একটি অ্যাপকে তার SessionTransferCallback নিবন্ধন করতে এবং যখন একজন প্রেরককে স্থানীয় প্লেব্যাকে স্থানান্তর করা হয় তখন onTransferred এবং onTransferFailed কলব্যাক শুনতে দেয়।
অ্যাপটি তার SessionTransferCallback নিবন্ধনমুক্ত করার পরে, অ্যাপটি আর SessionTransferCallback পাবে না।
SessionTransferCallback হল বিদ্যমান SessionManagerListener কলব্যাকের একটি এক্সটেনশন এবং onSessionEnded ট্রিগার হওয়ার পরে ট্রিগার হয়। রিমোট-টু-লোকাল কলব্যাকের ক্রম হল:
-
onTransferring -
onSessionEnding -
onSessionEnded -
onTransferred
যেহেতু অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন এবং কাস্টিং করার সময় মিডিয়া নোটিফিকেশন চিপ দ্বারা আউটপুট সুইচার খোলা যেতে পারে, তাই অ্যাপগুলিকে ব্যাকগ্রাউন্ড প্লেব্যাক সমর্থন করে কিনা তার উপর নির্ভর করে লোকাল ট্রান্সফারটি ভিন্নভাবে পরিচালনা করতে হবে। ব্যর্থ ট্রান্সফারের ক্ষেত্রে, ত্রুটি দেখা দিলে যেকোনো সময় onTransferFailed চালু হবে।
ব্যাকগ্রাউন্ড প্লেব্যাক সমর্থন করে এমন অ্যাপ
যেসব অ্যাপ ব্যাকগ্রাউন্ডে প্লেব্যাক সমর্থন করে (সাধারণত অডিও অ্যাপ), তাদের জন্য একটি Service (উদাহরণস্বরূপ MediaBrowserService ) ব্যবহার করার পরামর্শ দেওয়া হয়। পরিষেবাগুলিকে onTransferred কলব্যাক শুনতে হবে এবং অ্যাপটি ফোরগ্রাউন্ডে বা ব্যাকগ্রাউন্ডে থাকা অবস্থায় স্থানীয়ভাবে প্লেব্যাক পুনরায় শুরু করতে হবে।
class MyService : Service() { private var castContext: CastContext? = null private var sessionTransferCallback: SessionTransferCallback? = null protected fun onCreate() { castContext = CastContext.getSharedInstance(this) castContext.getSessionManager() .addSessionManagerListener(sessionManagerListener, CastSession::class.java) sessionTransferCallback = MySessionTransferCallback() castContext.addSessionTransferCallback(sessionTransferCallback) } protected fun onDestroy() { if (castContext != null) { castContext.getSessionManager() .removeSessionManagerListener(sessionManagerListener, CastSession::class.java) if (sessionTransferCallback != null) { castContext.removeSessionTransferCallback(sessionTransferCallback) } } } class MySessionTransferCallback : SessionTransferCallback() { fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) { // Perform necessary steps prior to onTransferred } fun onTransferred(@SessionTransferCallback.TransferType transferType: Int, sessionState: SessionState?) { if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) { // Remote stream is transferred to the local device. // Retrieve information from the SessionState to continue playback on the local player. } } fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int, @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) { // Handle transfer failure. } } }
public class MyService extends Service { private CastContext castContext; private SessionTransferCallback sessionTransferCallback; @Override protected void onCreate() { castContext = CastContext.getSharedInstance(this); castContext.getSessionManager() .addSessionManagerListener(sessionManagerListener, CastSession.class); sessionTransferCallback = new MySessionTransferCallback(); castContext.addSessionTransferCallback(sessionTransferCallback); } @Override protected void onDestroy() { if (castContext != null) { castContext.getSessionManager() .removeSessionManagerListener(sessionManagerListener, CastSession.class); if (sessionTransferCallback != null) { castContext.removeSessionTransferCallback(sessionTransferCallback); } } } public static class MySessionTransferCallback extends SessionTransferCallback { public MySessionTransferCallback() {} @Override public void onTransferring(@SessionTransferCallback.TransferType int transferType) { // Perform necessary steps prior to onTransferred } @Override public void onTransferred(@SessionTransferCallback.TransferType int transferType, SessionState sessionState) { if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) { // Remote stream is transferred to the local device. // Retrieve information from the SessionState to continue playback on the local player. } } @Override public void onTransferFailed(@SessionTransferCallback.TransferType int transferType, @SessionTransferCallback.TransferFailedReason int transferFailedReason) { // Handle transfer failure. } } }
যেসব অ্যাপ ব্যাকগ্রাউন্ড প্লেব্যাক সমর্থন করে না
যেসব অ্যাপ ব্যাকগ্রাউন্ড প্লেব্যাক সমর্থন করে না (সাধারণত ভিডিও অ্যাপ), তাদের জন্য onTransferred কলব্যাক শোনা এবং অ্যাপটি যদি ফোরগ্রাউন্ডে থাকে তবে স্থানীয়ভাবে প্লেব্যাক পুনরায় শুরু করার পরামর্শ দেওয়া হয়।
যদি অ্যাপটি ব্যাকগ্রাউন্ডে থাকে, তাহলে এটি প্লেব্যাক থামাবে এবং SessionState থেকে প্রয়োজনীয় তথ্য (উদাহরণস্বরূপ, মিডিয়া মেটাডেটা এবং প্লেব্যাক অবস্থান) সংরক্ষণ করবে। যখন অ্যাপটি ব্যাকগ্রাউন্ড থেকে ফোরগ্রাউন্ড করা হয়, তখন স্থানীয় প্লেব্যাকটি সঞ্চিত তথ্যের সাথে চলতে থাকবে।
class MyActivity : AppCompatActivity() { private var castContext: CastContext? = null private var sessionTransferCallback: SessionTransferCallback? = null protected fun onCreate() { castContext = CastContext.getSharedInstance(this) castContext.getSessionManager() .addSessionManagerListener(sessionManagerListener, CastSession::class.java) sessionTransferCallback = MySessionTransferCallback() castContext.addSessionTransferCallback(sessionTransferCallback) } protected fun onDestroy() { if (castContext != null) { castContext.getSessionManager() .removeSessionManagerListener(sessionManagerListener, CastSession::class.java) if (sessionTransferCallback != null) { castContext.removeSessionTransferCallback(sessionTransferCallback) } } } class MySessionTransferCallback : SessionTransferCallback() { fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) { // Perform necessary steps prior to onTransferred } fun onTransferred(@SessionTransferCallback.TransferType transferType: Int, sessionState: SessionState?) { if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) { // Remote stream is transferred to the local device. // Retrieve information from the SessionState to continue playback on the local player. } } fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int, @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) { // Handle transfer failure. } } }
public class MyActivity extends AppCompatActivity { private CastContext castContext; private SessionTransferCallback sessionTransferCallback; @Override protected void onCreate() { castContext = CastContext.getSharedInstance(this); castContext .getSessionManager() .addSessionManagerListener(sessionManagerListener, CastSession.class); sessionTransferCallback = new MySessionTransferCallback(); castContext.addSessionTransferCallback(sessionTransferCallback); } @Override protected void onDestroy() { if (castContext != null) { castContext .getSessionManager() .removeSessionManagerListener(sessionManagerListener, CastSession.class); if (sessionTransferCallback != null) { castContext.removeSessionTransferCallback(sessionTransferCallback); } } } public static class MySessionTransferCallback extends SessionTransferCallback { public MySessionTransferCallback() {} @Override public void onTransferring(@SessionTransferCallback.TransferType int transferType) { // Perform necessary steps prior to onTransferred } @Override public void onTransferred(@SessionTransferCallback.TransferType int transferType, SessionState sessionState) { if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) { // Remote stream is transferred to the local device. // Retrieve information from the SessionState to continue playback on the local player. } } @Override public void onTransferFailed(@SessionTransferCallback.TransferType int transferType, @SessionTransferCallback.TransferFailedReason int transferFailedReason) { // Handle transfer failure. } } }
রিমোট-টু-রিমোট
আউটপুট সুইচার স্ট্রিম এক্সপ্যানশন ব্যবহার করে অডিও অ্যাপের জন্য একাধিক কাস্ট-সক্ষম স্পিকার ডিভাইসে প্রসারিত করার ক্ষমতা সমর্থন করে।
অডিও অ্যাপ হল এমন অ্যাপ যা Google Cast SDK ডেভেলপার কনসোলের রিসিভার অ্যাপ সেটিংসে অডিওর জন্য Google Cast সমর্থন করে।
স্পিকার সহ স্ট্রিম সম্প্রসারণ
আউটপুট সুইচার ব্যবহারকারী অডিও অ্যাপগুলিতে স্ট্রিম এক্সপ্যানশন ব্যবহার করে কাস্ট সেশনের সময় একাধিক কাস্ট-সক্ষম স্পিকার ডিভাইসে অডিও প্রসারিত করার ক্ষমতা থাকে।
এই বৈশিষ্ট্যটি কাস্ট প্ল্যাটফর্ম দ্বারা সমর্থিত এবং যদি অ্যাপটি ডিফল্ট UI ব্যবহার করে তবে আর কোনও পরিবর্তনের প্রয়োজন হয় না। যদি একটি কাস্টম UI ব্যবহার করা হয়, তাহলে অ্যাপটি একটি গ্রুপে কাস্ট করছে তা প্রতিফলিত করার জন্য অ্যাপটিকে UI আপডেট করতে হবে।
স্ট্রিম সম্প্রসারণের সময় নতুন সম্প্রসারিত গ্রুপের নাম পেতে, CastSession#addCastListener ব্যবহার করে একটি Cast.Listener নিবন্ধন করুন। তারপর onDeviceNameChanged কলব্যাকের সময় CastSession#getCastDevice() কল করুন।
class MyActivity : Activity() { private var mCastSession: CastSession? = null private lateinit var mCastContext: CastContext private lateinit var mSessionManager: SessionManager private val mSessionManagerListener: SessionManagerListener<CastSession> = SessionManagerListenerImpl() private val mCastListener = CastListener() private inner class SessionManagerListenerImpl : SessionManagerListener<CastSession?> { override fun onSessionStarting(session: CastSession?) {} override fun onSessionStarted(session: CastSession?, sessionId: String) { addCastListener(session) } override fun onSessionStartFailed(session: CastSession?, error: Int) {} override fun onSessionSuspended(session: CastSession?, reason Int) { removeCastListener() } override fun onSessionResuming(session: CastSession?, sessionId: String) {} override fun onSessionResumed(session: CastSession?, wasSuspended: Boolean) { addCastListener(session) } override fun onSessionResumeFailed(session: CastSession?, error: Int) {} override fun onSessionEnding(session: CastSession?) {} override fun onSessionEnded(session: CastSession?, error: Int) { removeCastListener() } } private inner class CastListener : Cast.Listener() { override fun onDeviceNameChanged() { mCastSession?.let { val castDevice = it.castDevice val deviceName = castDevice.friendlyName // Update UIs with the new cast device name. } } } private fun addCastListener(castSession: CastSession) { mCastSession = castSession mCastSession?.addCastListener(mCastListener) } private fun removeCastListener() { mCastSession?.removeCastListener(mCastListener) } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) mCastContext = CastContext.getSharedInstance(this) mSessionManager = mCastContext.sessionManager mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession::class.java) } override fun onDestroy() { super.onDestroy() mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession::class.java) } }
public class MyActivity extends Activity { private CastContext mCastContext; private CastSession mCastSession; private SessionManager mSessionManager; private SessionManagerListener<CastSession> mSessionManagerListener = new SessionManagerListenerImpl(); private Cast.Listener mCastListener = new CastListener(); private class SessionManagerListenerImpl implements SessionManagerListener<CastSession> { @Override public void onSessionStarting(CastSession session) {} @Override public void onSessionStarted(CastSession session, String sessionId) { addCastListener(session); } @Override public void onSessionStartFailed(CastSession session, int error) {} @Override public void onSessionSuspended(CastSession session, int reason) { removeCastListener(); } @Override public void onSessionResuming(CastSession session, String sessionId) {} @Override public void onSessionResumed(CastSession session, boolean wasSuspended) { addCastListener(session); } @Override public void onSessionResumeFailed(CastSession session, int error) {} @Override public void onSessionEnding(CastSession session) {} @Override public void onSessionEnded(CastSession session, int error) { removeCastListener(); } } private class CastListener extends Cast.Listener { @Override public void onDeviceNameChanged() { if (mCastSession == null) { return; } CastDevice castDevice = mCastSession.getCastDevice(); String deviceName = castDevice.getFriendlyName(); // Update UIs with the new cast device name. } } private void addCastListener(CastSession castSession) { mCastSession = castSession; mCastSession.addCastListener(mCastListener); } private void removeCastListener() { if (mCastSession != null) { mCastSession.removeCastListener(mCastListener); } } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mCastContext = CastContext.getSharedInstance(this); mSessionManager = mCastContext.getSessionManager(); mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession.class); } @Override protected void onDestroy() { super.onDestroy(); mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession.class); } }
রিমোট-টু-রিমোট পরীক্ষা করা হচ্ছে
বৈশিষ্ট্যটি পরীক্ষা করতে:
- প্রচলিত কাস্টিং ব্যবহার করে অথবা লোকাল-টু-রিমোট ব্যবহার করে আপনার কন্টেন্ট একটি কাস্ট-সক্ষম ডিভাইসে কাস্ট করুন।
- যেকোনো একটি এন্ট্রি পয়েন্ট ব্যবহার করে আউটপুট সুইচারটি খুলুন।
- অন্য একটি কাস্ট-সক্ষম ডিভাইসে আলতো চাপুন, অডিও অ্যাপগুলি অতিরিক্ত ডিভাইসে সামগ্রীটি প্রসারিত করবে, একটি গতিশীল গোষ্ঠী তৈরি করবে।
- কাস্ট-সক্ষম ডিভাইসটিতে আবার ট্যাপ করুন, এটি ডায়নামিক গ্রুপ থেকে সরানো হবে।