আপনার Android TV রিসিভারে মূল ফিচার যোগ করা

এই পৃষ্ঠায় Android TV রিসিভার অ্যাপ কাস্টমাইজ করার জন্য উপলভ্য ফিচারের কোড স্নিপেট ও বিবরণ দেওয়া আছে।

মনে রাখবেন: আমরা আপনাকে নিম্নলিখিত ধাপগুলি অনুসরণ করার সাজেশন দিই:

• Cast Android TV কোডল্যাব টিউটোরিয়াল - Google Cast SDK ব্যবহার করে কীভাবে Cast-সক্ষম Android TV রিসিভার অ্যাপ তৈরি করতে হয় তা ধাপে ধাপে শিখুন, যা ভিডিও কাস্ট রিসিভ করতে পারে।
• CastAndroidTvReceiver স্যাম্পেল অ্যাপ (GitHub) - এই রেফারেন্স স্যাম্পেল অ্যাপ রান, নেভিগেট ও দেখুন যা UX নির্দেশিকা এবং ডিজাইন চেকলিস্ট মেনে চলে।
• CastVideos Sender স্যাম্পেল অ্যাপ (GitHub) - Cast Connect-চালু থাকা প্রেরক রেফারেন্স স্যাম্পেল অ্যাপ ব্যবহার করে পরীক্ষা করুন।

লাইব্রেরি কনফিগার করা হচ্ছে

আপনার Android TV অ্যাপে Cast Connect API উপলভ্য করতে:

Android

1. আপনার অ্যাপ্লিকেশন মডিউল ডিরেক্টরির মধ্যে build.gradle ফাইলটি খুলুন।
   মনে রাখবেন: Android Studio প্রোজেক্টে একটি টপ-লেভেল build.gradle ফাইল এবং প্রতিটি মডিউলের জন্য একটি build.gradle ফাইল থাকে। আপনার অ্যাপ্লিকেশন মডিউলের জন্য ফাইলটি এডিট করতে ভুলবেন না। Gradle সম্পর্কে আরও তথ্যের জন্য Gradle-এর সাহায্যে আপনার প্রোজেক্ট তৈরি করা দেখুন।
2. google(), তালিকাভুক্ত repositories-এ অন্তর্ভুক্ত আছে কিনা তা যাচাই করুন।

     repositories {
       google()
     }

3. আপনার অ্যাপের জন্য টার্গেট ডিভাইসের ধরনের উপর নির্ভর করে, আপনার ডিপেন্ডেন্সিতে লাইব্রেরির লেটেস্ট ভার্সন যোগ করুন:
   • Android Receiver অ্যাপের জন্য:

       dependencies {
         implementation 'com.google.android.gms:play-services-cast-tv:21.1.1'
         implementation 'com.google.android.gms:play-services-cast:23.0.0'
       }

   • Android প্রেরক অ্যাপের জন্য:

       dependencies {
         implementation 'com.google.android.gms:play-services-cast:21.1.1'
         implementation 'com.google.android.gms:play-services-cast-framework:23.0.0'
       }

   প্রতিবার পরিষেবা আপডেট করার সময় এই ভার্সন নম্বর আপডেট করতে ভুলবেন না।
4. পরিবর্তনগুলি সেভ করুন এবং টুলবারে Sync Project with Gradle Files ক্লিক করুন।

iOS

1. আপনার Podfile যেন google-cast-sdk 4.8.6 বা তার পরবর্তী ভার্সনকে টার্গেট করে তা নিশ্চিত করুন
2. iOS 16 বা তার পরবর্তী যেকোনও ভার্সন টার্গেট করুন। আরও তথ্যের জন্য রিলিজ নোট দেখুন।

     platform: ios, '16'
   
     def target_pods
        pod 'google-cast-sdk', '~>4.8.6'
     end

ওয়েব

1. Chromium ব্রাউজার ভার্সন M87 বা তার পরবর্তী ভার্সন প্রয়োজন।
2. আপনার প্রোজেক্টে Web Sender API লাইব্রেরি যোগ করুন

     <script src="//www.gstatic.com/cv/js/sender/v1/cast_sender.js?loadCastFramework=1"></script>

AndroidX সংক্রান্ত প্রয়োজনীয়তা

Google Play পরিষেবার নতুন ভার্সনে androidx নেমস্পেস ব্যবহার করার জন্য অ্যাপ আপডেট করতে হবে। AndroidX-এ মাইগ্রেট করার জন্য নির্দেশাবলী অনুসরণ করুন।

Android TV অ্যাপ—প্রয়োজনীয়তা

আপনার Android TV অ্যাপে Cast Connect-এর সুবিধা দিতে, আপনাকে অবশ্যই একটি মিডিয়া সেশন থেকে ইভেন্ট তৈরি করতে এবং সমর্থন করতে হবে। আপনার মিডিয়া সেশন থেকে পাওয়া ডেটা আপনার মিডিয়া স্ট্যাটাসের জন্য প্রাথমিক তথ্য—যেমন, পজিশন, প্লেব্যাক স্টেট ইত্যাদি—প্রদান করে। এছাড়াও, Cast Connect লাইব্রেরি আপনার মিডিয়া সেশন ব্যবহার করে যাতে প্রেরকের থেকে নির্দিষ্ট কোনও মেসেজ পেলে, যেমন পজ, তা সিগন্যাল করতে পারে।

মিডিয়া সেশন এবং কীভাবে মিডিয়া সেশন শুরু করতে হয় সেই সম্পর্কে আরও জানতে, মিডিয়া সেশন গাইডের সাথে কাজ করা দেখুন।

মিডিয়া সেশনের লাইফসাইকেল

প্লেব্যাক শুরু হলে আপনার অ্যাপকে একটি মিডিয়া সেশন তৈরি করতে হবে এবং এটি আর কন্ট্রোল করা না গেলে সেটি রিলিজ করতে হবে। যেমন, আপনার অ্যাপটি যদি কোনও ভিডিও অ্যাপ হয়, তাহলে ব্যবহারকারী প্লেব্যাক অ্যাক্টিভিটি থেকে বেরিয়ে গেলে আপনাকে সেশন রিলিজ করতে হবে—অন্য কন্টেন্ট ব্রাউজ করার জন্য 'ফিরে যান' বিকল্প বেছে নিয়ে অথবা অ্যাপটি ব্যাকগ্রাউন্ডে পাঠিয়ে। আপনার অ্যাপটি যদি কোনও মিউজিক অ্যাপ হয়, তাহলে আপনার অ্যাপটি আর কোনও মিডিয়া না চালালে আপনাকে এটি রিলিজ করতে হবে।

সেশন স্ট্যাটাস আপডেট করা হচ্ছে

মনে রাখবেন: আপনি Exoplayer ব্যবহার করলে, কীভাবে আপনার মিডিয়া সেশন অটোমেটিক আপডেট করবেন তা জানতে Cast Connect-এর সাথে Exoplayer ব্যবহার করা দেখুন।

আপনার মিডিয়া সেশনের ডেটা আপনার প্লেয়ারের স্ট্যাটাসের সাথে আপ-টু-ডেট রাখতে হবে। যেমন, প্লেব্যাক পজ করা হলে, আপনাকে প্লেব্যাক স্ট্যাটাস ও কাজ করে এমন অ্যাকশন আপডেট করতে হবে। নিম্নলিখিত সারণীতে সেইসব রাজ্যের তালিকা দেওয়া আছে যেগুলির তথ্য আপ-টু-ডেট রাখার দায়িত্ব আপনার।

MediaMetadataCompat

মেটাডেটা ফিল্ড	বিবরণ
METADATA_KEY_TITLE (প্রয়োজনীয়)	মিডিয়ার শীর্ষক।
METADATA_KEY_DISPLAY_SUBTITLE	সাবটাইটেল।
METADATA_KEY_DISPLAY_ICON_URI	আইকন URL।
METADATA_KEY_DURATION (প্রয়োজন)	মিডিয়ার সময়সীমা।
METADATA_KEY_MEDIA_URI	Content ID.
METADATA_KEY_ARTIST	শিল্পী।
METADATA_KEY_ALBUM	অ্যালবাম।

PlaybackStateCompat

প্রয়োজনীয় পদ্ধতি	বিবরণ
setActions()	কাজ করে এমন মিডিয়া কমান্ড সেট করে।
setState()	প্লে করার স্ট্যাটাস ও বর্তমান পজিশন সেট করুন।

MediaSessionCompat

প্রয়োজনীয় পদ্ধতি	বিবরণ
setRepeatMode()	রিপিট মোড সেট করে।
setShuffleMode()	শাফেল মোড সেট করে।
setMetadata()	মিডিয়া মেটাডেটা সেট করে।
setPlaybackState()	প্লেব্যাক স্ট্যাটাস সেট করে।

Kotlin

private fun updateMediaSession() {
    val metadata = MediaMetadataCompat.Builder()
         .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title")
         .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle")
         .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI, mMovie.getCardImageUrl())
         .build()

    val playbackState = PlaybackStateCompat.Builder()
         .setState(
             PlaybackStateCompat.STATE_PLAYING,
             player.getPosition(),
             player.getPlaybackSpeed(),
             System.currentTimeMillis()
        )
         .build()

    mediaSession.setMetadata(metadata)
    mediaSession.setPlaybackState(playbackState)
}

Java

private void updateMediaSession() {
  MediaMetadataCompat metadata =
      new MediaMetadataCompat.Builder()
          .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "title")
          .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_SUBTITLE, "subtitle")
          .putString(MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI,mMovie.getCardImageUrl())
          .build();

  PlaybackStateCompat playbackState =
      new PlaybackStateCompat.Builder()
          .setState(
               PlaybackStateCompat.STATE_PLAYING,
               player.getPosition(),
               player.getPlaybackSpeed(),
               System.currentTimeMillis())
          .build();

  mediaSession.setMetadata(metadata);
  mediaSession.setPlaybackState(playbackState);
}

ট্রান্সপোর্ট কন্ট্রোল ম্যানেজ করা

আপনার অ্যাপে মিডিয়া সেশন ট্রান্সপোর্ট কন্ট্রোল কলব্যাক প্রয়োগ করতে হবে। নিচের সারণীতে দেখানো হয়েছে যে তাদের কোন কোন ট্রান্সপোর্ট কন্ট্রোল অ্যাকশন ম্যানেজ করতে হবে:

MediaSessionCompat.Callback

ক্রিয়াসমূহ	বিবরণ
onPlay()	আবার শুরু করুন
onPause()	পজ করুন
onSeekTo()	কোনও পজিশনে যান
onStop()	বর্তমান মিডিয়া বন্ধ করুন

Kotlin

class MyMediaSessionCallback : MediaSessionCompat.Callback() {
  override fun onPause() {
    // Pause the player and update the play state.
    ...
  }

  override fun onPlay() {
    // Resume the player and update the play state.
    ...
  }

  override fun onSeekTo (long pos) {
    // Seek and update the play state.
    ...
  }
  ...
}

mediaSession.setCallback( MyMediaSessionCallback() );

Java

public MyMediaSessionCallback extends MediaSessionCompat.Callback {
  public void onPause() {
    // Pause the player and update the play state.
    ...
  }

  public void onPlay() {
    // Resume the player and update the play state.
    ...
  }

  public void onSeekTo (long pos) {
    // Seek and update the play state.
    ...
  }
  ...
}

mediaSession.setCallback(new MyMediaSessionCallback());

Cast সহায়তা কনফিগার করা হচ্ছে

কোনও প্রেরক অ্যাপ্লিকেশন লঞ্চের অনুরোধ পাঠালে, অ্যাপ্লিকেশন নেমস্পেসের সাথে একটি ইনটেন্ট তৈরি করা হয়। আপনার অ্যাপ্লিকেশন এটি ম্যানেজ করার জন্য এবং টিভি অ্যাপ চালু হলে CastReceiverContext অবজেক্টের ইনস্ট্যান্স তৈরি করার জন্য দায়ী। টিভি অ্যাপ চলাকালীন Cast-এর সাথে ইন্টার‍্যাক্ট করতে CastReceiverContext অবজেক্ট প্রয়োজন। এই অবজেক্ট আপনার টিভি অ্যাপ্লিকেশনকে যেকোনও কানেক্ট করা প্রেরকের থেকে আসা Cast মিডিয়া মেসেজ গ্রহণ করার অনুমতি দেয়।

Android TV সেট-আপ

লঞ্চ ইনটেন্ট ফিল্টার যোগ করা হচ্ছে

আপনি যে অ্যাক্টিভিটি লঞ্চ ইনটেন্ট হ্যান্ডেল করতে চান তাতে নতুন ইনটেন্ট ফিল্টার যোগ করুন আপনার প্রেরক অ্যাপ থেকে:

<activity android:name="com.example.activity">
  <intent-filter>
      <action android:name="com.google.android.gms.cast.tv.action.LAUNCH" />
      <category android:name="android.intent.category.DEFAULT" />
  </intent-filter>
</activity>

রিসিভার বিকল্প প্রদানকারী নির্দিষ্ট করুন

CastReceiverOptions প্রদান করতে আপনাকে ReceiverOptionsProvider প্রয়োগ করতে হবে:

Kotlin

class MyReceiverOptionsProvider : ReceiverOptionsProvider {
  override fun getOptions(context: Context?): CastReceiverOptions {
    return CastReceiverOptions.Builder(context)
          .setStatusText("My App")
          .build()
    }
}

Java

public class MyReceiverOptionsProvider implements ReceiverOptionsProvider {
  @Override
  public CastReceiverOptions getOptions(Context context) {
    return new CastReceiverOptions.Builder(context)
        .setStatusText("My App")
        .build();
  }
}

মনে রাখবেন: আপনি setStatusText সেট না করলে, এটি আপনার Android TV ম্যানিফেস্টে android:label থেকে অটোমেটিক পুল করা হয়।

তারপর আপনার AndroidManifest-এ বিকল্প প্রদানকারী নির্দিষ্ট করুন:

 <meta-data
    android:name="com.google.android.gms.cast.tv.RECEIVER_OPTIONS_PROVIDER_CLASS_NAME"
    android:value="com.example.mysimpleatvapplication.MyReceiverOptionsProvider" />

CastReceiverContext শুরু করার সময় CastReceiverOptions প্রদান করতে ReceiverOptionsProvider ব্যবহার করা হয়।

Cast রিসিভার কনটেক্সট

আপনার অ্যাপ তৈরি করার সময় CastReceiverContext ইনিশিয়ালাইজ করুন:

Kotlin

override fun onCreate() {
  CastReceiverContext.initInstance(this)

  ...
}

Java

@Override
public void onCreate() {
  CastReceiverContext.initInstance(this);

  ...
}

আপনার অ্যাপ ফোরগ্রাউন্ডে এলে CastReceiverContext শুরু করুন:

Kotlin

CastReceiverContext.getInstance().start()

Java

CastReceiverContext.getInstance().start();

ভিডিও অ্যাপ বা ব্যাকগ্রাউন্ড প্লেব্যাক কাজ করে না এমন অ্যাপের ক্ষেত্রে অ্যাপ ব্যাকগ্রাউন্ডে চলে যাওয়ার পরে CastReceiverContext-এ stop() কল করুন:

Kotlin

// Player has stopped.
CastReceiverContext.getInstance().stop()

Java

// Player has stopped.
CastReceiverContext.getInstance().stop();

এছাড়াও, আপনার অ্যাপ ব্যাকগ্রাউন্ডে চালানোর সুবিধা দিলে, ব্যাকগ্রাউন্ডে চলাকালীন এটি বন্ধ হয়ে গেলে CastReceiverContext-এ stop() কল করুন।

আমরা আপনাকে androidx.lifecycle লাইব্রেরি থেকে LifecycleObserver ব্যবহার করে CastReceiverContext.start() এবং CastReceiverContext.stop() কল ম্যানেজ করার জন্য সাজেস্ট করি, বিশেষ করে আপনার নেটিভ অ্যাপে একাধিক অ্যাক্টিভিটি থাকলে। এটি বিভিন্ন অ্যাক্টিভিটি থেকে start() এবং stop() কল করার সময় রেস কন্ডিশন এড়িয়ে যায়।

Kotlin

// Create a LifecycleObserver class.
class MyLifecycleObserver : DefaultLifecycleObserver {
  override fun onStart(owner: LifecycleOwner) {
    // App prepares to enter foreground.
    CastReceiverContext.getInstance().start()
  }

  override fun onStop(owner: LifecycleOwner) {
    // App has moved to the background or has terminated.
    CastReceiverContext.getInstance().stop()
  }
}

// Add the observer when your application is being created.
class MyApplication : Application() {
  fun onCreate() {
    super.onCreate()

    // Initialize CastReceiverContext.
    CastReceiverContext.initInstance(this /* android.content.Context */)

    // Register LifecycleObserver
    ProcessLifecycleOwner.get().lifecycle.addObserver(
        MyLifecycleObserver())
  }
}

Java

// Create a LifecycleObserver class.
public class MyLifecycleObserver implements DefaultLifecycleObserver {
  @Override
  public void onStart(LifecycleOwner owner) {
    // App prepares to enter foreground.
    CastReceiverContext.getInstance().start();
  }

  @Override
  public void onStop(LifecycleOwner owner) {
    // App has moved to the background or has terminated.
    CastReceiverContext.getInstance().stop();
  }
}

// Add the observer when your application is being created.
public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();

    // Initialize CastReceiverContext.
    CastReceiverContext.initInstance(this /* android.content.Context */);

    // Register LifecycleObserver
    ProcessLifecycleOwner.get().getLifecycle().addObserver(
        new MyLifecycleObserver());
  }
}

// In AndroidManifest.xml set MyApplication as the application class
<application
    ...
    android:name=".MyApplication">

MediaManager-এর সাথে MediaSession কানেক্ট করা হচ্ছে

আপনি যখন MediaSession তৈরি করেন, আপনাকে বর্তমান MediaSession টোকেনও CastReceiverContext-এ প্রদান করতে হবে যাতে এটি জানতে পারে যে কোথায় কমান্ড পাঠাতে হবে এবং মিডিয়া প্লেব্যাক স্ট্যাটাস ফিরিয়ে আনতে হবে:

Kotlin

val mediaManager: MediaManager = receiverContext.getMediaManager()
mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken())

Java

MediaManager mediaManager = receiverContext.getMediaManager();
mediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());

ইনঅ্যাক্টিভ প্লেব্যাকের কারণে আপনার MediaSession রিলিজ করার সময়, আপনাকে MediaManager-এ নাল টোকেন সেট করতে হবে:

Kotlin

myPlayer.stop()
mediaSession.release()
mediaManager.setSessionCompatToken(null)

Java

myPlayer.stop();
mediaSession.release();
mediaManager.setSessionCompatToken(null);

আপনার অ্যাপ ব্যাকগ্রাউন্ডে থাকাকালীন মিডিয়া চালানোর সুবিধা থাকলে, অ্যাপ ব্যাকগ্রাউন্ডে পাঠানোর সময় CastReceiverContext.stop() কল করার পরিবর্তে, আপনার অ্যাপ ব্যাকগ্রাউন্ডে থাকলে এবং মিডিয়া না চললে তবেই কল করা উচিত। যেমন:

Kotlin

class MyLifecycleObserver : DefaultLifecycleObserver {
  ...
  // App has moved to the background.
  override fun onPause(owner: LifecycleOwner) {
    mIsBackground = true
    myStopCastReceiverContextIfNeeded()
  }
}

// Stop playback on the player.
private fun myStopPlayback() {
  myPlayer.stop()

  myStopCastReceiverContextIfNeeded()
}

// Stop the CastReceiverContext when both the player has
// stopped and the app has moved to the background.
private fun myStopCastReceiverContextIfNeeded() {
  if (mIsBackground && myPlayer.isStopped()) {
    CastReceiverContext.getInstance().stop()
  }
}

Java

public class MyLifecycleObserver implements DefaultLifecycleObserver {
  ...
  // App has moved to the background.
  @Override
  public void onPause(LifecycleOwner owner) {
    mIsBackground = true;

    myStopCastReceiverContextIfNeeded();
  }
}

// Stop playback on the player.
private void myStopPlayback() {
  myPlayer.stop();

  myStopCastReceiverContextIfNeeded();
}

// Stop the CastReceiverContext when both the player has
// stopped and the app has moved to the background.
private void myStopCastReceiverContextIfNeeded() {
  if (mIsBackground && myPlayer.isStopped()) {
    CastReceiverContext.getInstance().stop();
  }
}

Cast Connect-এর সাথে Exoplayer ব্যবহার করা

আপনি যদি Exoplayer ব্যবহার করেন, তাহলে আপনি MediaSessionConnector ব্যবহার করতে পারেন যাতে ম্যানুয়ালি পরিবর্তনগুলি ট্র্যাক করার পরিবর্তে সেশন এবং প্লেব্যাক স্টেট সহ সমস্ত সম্পর্কিত তথ্য অটোমেটিক বজায় রাখা যায়।

MediaSessionConnector.MediaButtonEventHandler কল করার মাধ্যমে MediaButton ইভেন্ট ম্যানেজ করতে ব্যবহার করা যেতে পারে setMediaButtonEventHandler(MediaButtonEventHandler) যা অন্যথায় MediaSessionCompat.Callback ডিফল্ট হিসেবে ম্যানেজ করে।

আপনার অ্যাপে MediaSessionConnector ইন্টিগ্রেট করতে, আপনার প্লেয়ার অ্যাক্টিভিটি ক্লাস বা যেখানে আপনি মিডিয়া সেশন ম্যানেজ করেন সেখানে নিম্নলিখিতগুলি যোগ করুন:

Kotlin

class PlayerActivity : Activity() {
  private var mMediaSession: MediaSessionCompat? = null
  private var mMediaSessionConnector: MediaSessionConnector? = null
  private var mMediaManager: MediaManager? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    ...
    mMediaSession = MediaSessionCompat(this, LOG_TAG)
    mMediaSessionConnector = MediaSessionConnector(mMediaSession!!)
    ...
  }

  override fun onStart() {
    ...
    mMediaManager = receiverContext.getMediaManager()
    mMediaManager!!.setSessionCompatToken(currentMediaSession.getSessionToken())
    mMediaSessionConnector!!.setPlayer(mExoPlayer)
    mMediaSessionConnector!!.setMediaMetadataProvider(mMediaMetadataProvider)
    mMediaSession!!.isActive = true
    ...
  }

  override fun onStop() {
    ...
    mMediaSessionConnector!!.setPlayer(null)
    mMediaSession!!.release()
    mMediaManager!!.setSessionCompatToken(null)
    ...
  }
}

Java

public class PlayerActivity extends Activity {
  private MediaSessionCompat mMediaSession;
  private MediaSessionConnector mMediaSessionConnector;
  private MediaManager mMediaManager;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ...
    mMediaSession = new MediaSessionCompat(this, LOG_TAG);
    mMediaSessionConnector = new MediaSessionConnector(mMediaSession);
    ...
  }

  @Override
  protected void onStart() {
    ...
    mMediaManager = receiverContext.getMediaManager();
    mMediaManager.setSessionCompatToken(currentMediaSession.getSessionToken());

    mMediaSessionConnector.setPlayer(mExoPlayer);
    mMediaSessionConnector.setMediaMetadataProvider(mMediaMetadataProvider);
    mMediaSession.setActive(true);
    ...
  }

  @Override
  protected void onStop() {
    ...
    mMediaSessionConnector.setPlayer(null);
    mMediaSession.release();
    mMediaManager.setSessionCompatToken(null);
    ...
  }
}

প্রেরক অ্যাপ সেট-আপ

Cast Connect সহায়তা চালু করুন

Cast Connect সাপোর্ট সহ আপনার প্রেরক অ্যাপ আপডেট করার পরে, আপনি LaunchOptions -এ androidReceiverCompatible ফ্ল্যাগকে true হিসেবে সেট করে এটি প্রস্তুত বলে ঘোষণা করতে পারেন।

Android

play-services-cast-framework ভার্সন 19.0.0 বা তার পরের যেকোনও ভার্সন প্রয়োজন।

androidReceiverCompatible ফ্ল্যাগটি LaunchOptions-এ সেট করা আছে (যা CastOptions-এর অংশ):

Kotlin

class CastOptionsProvider : OptionsProvider {
  override fun getCastOptions(context: Context?): CastOptions {
    val launchOptions: LaunchOptions = Builder()
          .setAndroidReceiverCompatible(true)
          .build()
    return CastOptions.Builder()
          .setLaunchOptions(launchOptions)
          ...
          .build()
    }
}

জাভা

public class CastOptionsProvider implements OptionsProvider {
  @Override
  public CastOptions getCastOptions(Context context) {
    LaunchOptions launchOptions = new LaunchOptions.Builder()
              .setAndroidReceiverCompatible(true)
              .build();
    return new CastOptions.Builder()
        .setLaunchOptions(launchOptions)
        ...
        .build();
  }
}

iOS

google-cast-sdk ভার্সন v4.4.8 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

androidReceiverCompatible ফ্ল্যাগটি GCKLaunchOptions-এ সেট করা আছে (যা GCKCastOptions-এর অংশ):

let options = GCKCastOptions(discoveryCriteria: GCKDiscoveryCriteria(applicationID: kReceiverAppID))
...
let launchOptions = GCKLaunchOptions()
launchOptions.androidReceiverCompatible = true
options.launchOptions = launchOptions
GCKCastContext.setSharedInstanceWith(options)

ওয়েব

Chromium ব্রাউজার ভার্সন M87 বা তার পরবর্তী ভার্সন প্রয়োজন।

const context = cast.framework.CastContext.getInstance();
const castOptions = new cast.framework.CastOptions();
castOptions.receiverApplicationId = kReceiverAppID;
castOptions.androidReceiverCompatible = true;
context.setOptions(castOptions);

Cast Developer Console সেট-আপ

Android TV অ্যাপ কনফিগার করুন

আপনার Cast অ্যাপ আইডির সাথে যুক্ত করতে Cast Developer Console-এ আপনার Android TV অ্যাপের প্যাকেজের নাম যোগ করুন।

ডেভেলপার ডিভাইস রেজিস্টার করুন

আপনি ডেভেলপমেন্টের জন্য যে Android TV ডিভাইস ব্যবহার করতে চলেছেন, Cast Developer Console-এ তার সিরিয়াল নম্বর রেজিস্টার করুন।

মনে রাখবেন: Android TV (ATV) ডিভাইসের সাথে একাধিক সিরিয়াল নম্বর যুক্ত থাকে। আপনাকে অবশ্যই ATV ডিভাইসের সফ্টওয়্যার (Cast) সিরিয়াল নম্বর ব্যবহার করতে হবে। এটি কীভাবে খুঁজে পাবেন সেই সম্পর্কে বিস্তারিত জানতে, ATV ডিভাইসের সিরিয়াল নম্বর নির্ধারণ করা দেখুন।

নিরাপত্তার কারণে, রেজিস্ট্রেশন না করলে, Cast Connect শুধুমাত্র Google Play Store থেকে ইনস্টল করা অ্যাপের জন্য কাজ করবে।

Cast ডেভেলপমেন্টের জন্য Cast বা Android TV ডিভাইস রেজিস্টার করার ব্যাপারে আরও তথ্য পেতে, রেজিস্ট্রেশন পৃষ্ঠা দেখুন।

মিডিয়া লোড হচ্ছে

আপনি যদি আগে থেকেই Android TV অ্যাপে ডিপ লিঙ্ক সাপোর্ট প্রয়োগ করে থাকেন, তাহলে আপনার Android TV ম্যানিফেস্টে একই ধরনের সংজ্ঞা কনফিগার করা থাকতে হবে:

<activity android:name="com.example.activity">
  <intent-filter>
     <action android:name="android.intent.action.VIEW" />
     <category android:name="android.intent.category.DEFAULT" />
     <data android:scheme="https"/>
     <data android:host="www.example.com"/>
     <data android:pathPattern=".*"/>
  </intent-filter>
</activity>

প্রেরকের উপর এন্টিটি অনুযায়ী লোড করুন

প্রেরকের ক্ষেত্রে, লোড করার অনুরোধের জন্য মিডিয়া তথ্যে entity সেট করে আপনি ডিপ লিঙ্ক পাস করতে পারবেন:

Kotlin

val mediaToLoad = MediaInfo.Builder("some-id")
    .setEntity("https://example.com/watch/some-id")
    ...
    .build()
val loadRequest = MediaLoadRequestData.Builder()
    .setMediaInfo(mediaToLoad)
    .setCredentials("user-credentials")
    ...
    .build()
remoteMediaClient.load(loadRequest)

Android

Java

MediaInfo mediaToLoad =
    new MediaInfo.Builder("some-id")
        .setEntity("https://example.com/watch/some-id")
        ...
        .build();
MediaLoadRequestData loadRequest =
    new MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        ...
        .build();
remoteMediaClient.load(loadRequest);

iOS

let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id")
...
mediaInformation = mediaInfoBuilder.build()

let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder()
mediaLoadRequestDataBuilder.mediaInformation = mediaInformation
mediaLoadRequestDataBuilder.credentials = "user-credentials"
...
let mediaLoadRequestData = mediaLoadRequestDataBuilder.build()

remoteMediaClient?.loadMedia(with: mediaLoadRequestData)

ওয়েব

Chromium ব্রাউজার ভার্সন M87 বা তার পরবর্তী ভার্সন প্রয়োজন।

let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4');
mediaInfo.entity = 'https://example.com/watch/some-id';
...

let request = new chrome.cast.media.LoadRequest(mediaInfo);
request.credentials = 'user-credentials';
...

cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);

লোড কমান্ডটি আপনার ডিপ লিঙ্ক এবং ডেভেলপার কনসোলে আপনার সংজ্ঞায়িত প্যাকেজের নাম সহ একটি ইনটেন্টের মাধ্যমে পাঠানো হয়।

প্রেরকের ডিভাইসে ATV ক্রেডেনশিয়াল সেট করা হচ্ছে

আপনার Web Receiver অ্যাপ এবং Android TV অ্যাপে আলাদা ডিপ লিঙ্ক এবং credentials কাজ করতে পারে (যেমন, আপনি যদি দুটি প্ল্যাটফর্মে আলাদাভাবে যাচাইকরণ ম্যানেজ করেন)। এই সমস্যার সমাধান করতে, আপনি Android TV-এর জন্য বিকল্প entity এবং credentials দিতে পারেন:

Android

Kotlin

val mediaToLoad = MediaInfo.Builder("some-id")
        .setEntity("https://example.com/watch/some-id")
        .setAtvEntity("myscheme://example.com/atv/some-id")
        ...
        .build()
val loadRequest = MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        .setAtvCredentials("atv-user-credentials")
        ...
        .build()
remoteMediaClient.load(loadRequest)

জাভা

MediaInfo mediaToLoad =
    new MediaInfo.Builder("some-id")
        .setEntity("https://example.com/watch/some-id")
        .setAtvEntity("myscheme://example.com/atv/some-id")
        ...
        .build();
MediaLoadRequestData loadRequest =
    new MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        .setAtvCredentials("atv-user-credentials")
        ...
        .build();
remoteMediaClient.load(loadRequest);

iOS

let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "https://example.com/watch/some-id")
mediaInfoBuilder.atvEntity = "myscheme://example.com/atv/some-id"
...
mediaInformation = mediaInfoBuilder.build()

let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder()
mediaLoadRequestDataBuilder.mediaInformation = mediaInformation
mediaLoadRequestDataBuilder.credentials = "user-credentials"
mediaLoadRequestDataBuilder.atvCredentials = "atv-user-credentials"
...
let mediaLoadRequestData = mediaLoadRequestDataBuilder.build()

remoteMediaClient?.loadMedia(with: mediaLoadRequestData)

ওয়েব

Chromium ব্রাউজার ভার্সন M87 বা তার পরবর্তী ভার্সন প্রয়োজন।

let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4');
mediaInfo.entity = 'https://example.com/watch/some-id';
mediaInfo.atvEntity = 'myscheme://example.com/atv/some-id';
...

let request = new chrome.cast.media.LoadRequest(mediaInfo);
request.credentials = 'user-credentials';
request.atvCredentials = 'atv-user-credentials';
...

cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);

ওয়েব রিসিভার অ্যাপ চালু করা হলে, এটি লোড করার অনুরোধে entity এবং credentials ব্যবহার করে। তবে, আপনার Android TV অ্যাপ লঞ্চ করা হলে, SDK entity এবং credentials-এর পরিবর্তে আপনার atvEntity এবং atvCredentials (যদি উল্লেখ করা থাকে) ব্যবহার করে।

Content ID বা MediaQueueData-এর মাধ্যমে লোড করা হচ্ছে

আপনি entity বা atvEntity ব্যবহার না করলে এবং আপনার মিডিয়া তথ্যে Content ID বা Content URL ব্যবহার করলে অথবা আরও বিস্তারিত মিডিয়া লোড অনুরোধ ডেটা ব্যবহার করলে, আপনার Android TV অ্যাপে নিম্নলিখিত আগে থেকে নির্ধারিত ইনটেন্ট ফিল্টার যোগ করতে হবে:

<activity android:name="com.example.activity">
  <intent-filter>
     <action android:name="com.google.android.gms.cast.tv.action.LOAD"/>
     <category android:name="android.intent.category.DEFAULT" />
  </intent-filter>
</activity>

প্রেরকের ক্ষেত্রে, এন্টিটি অনুযায়ী লোড করার মতো, আপনি কন্টেন্টের তথ্য দিয়ে লোড করার অনুরোধ তৈরি করতে এবং load() কল করতে পারবেন।

Android

Kotlin

val mediaToLoad = MediaInfo.Builder("some-id").build()
val loadRequest = MediaLoadRequestData.Builder()
    .setMediaInfo(mediaToLoad)
    .setCredentials("user-credentials")
    ...
    .build()
remoteMediaClient.load(loadRequest)

জাভা

MediaInfo mediaToLoad =
    new MediaInfo.Builder("some-id").build();
MediaLoadRequestData loadRequest =
    new MediaLoadRequestData.Builder()
        .setMediaInfo(mediaToLoad)
        .setCredentials("user-credentials")
        ...
        .build();
remoteMediaClient.load(loadRequest);

iOS

let mediaInfoBuilder = GCKMediaInformationBuilder(contentId: "some-id")
...
mediaInformation = mediaInfoBuilder.build()

let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder()
mediaLoadRequestDataBuilder.mediaInformation = mediaInformation
mediaLoadRequestDataBuilder.credentials = "user-credentials"
...
let mediaLoadRequestData = mediaLoadRequestDataBuilder.build()

remoteMediaClient?.loadMedia(with: mediaLoadRequestData)

ওয়েব

Chromium ব্রাউজার ভার্সন M87 বা তার পরবর্তী ভার্সন প্রয়োজন।

let mediaInfo = new chrome.cast.media.MediaInfo('some-id"', 'video/mp4');
...

let request = new chrome.cast.media.LoadRequest(mediaInfo);
...

cast.framework.CastContext.getInstance().getCurrentSession().loadMedia(request);

লোড সংক্রান্ত অনুরোধ ম্যানেজ করা

আপনার অ্যাক্টিভিটিতে, এইসব লোড অনুরোধ ম্যানেজ করতে, আপনার অ্যাক্টিভিটি লাইফসাইকেল কলব্যাকে আপনাকে ইনটেন্ট ম্যানেজ করতে হবে:

Kotlin

class MyActivity : Activity() {
  override fun onStart() {
    super.onStart()
    val mediaManager = CastReceiverContext.getInstance().getMediaManager()
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(intent)) {
        // If the SDK recognizes the intent, you should early return.
        return
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }

  // For some cases, a new load intent triggers onNewIntent() instead of
  // onStart().
  override fun onNewIntent(intent: Intent) {
    val mediaManager = CastReceiverContext.getInstance().getMediaManager()
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(intent)) {
        // If the SDK recognizes the intent, you should early return.
        return
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }
}

Java

public class MyActivity extends Activity {
  @Override
  protected void onStart() {
    super.onStart();
    MediaManager mediaManager =
        CastReceiverContext.getInstance().getMediaManager();
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(getIntent())) {
      // If the SDK recognizes the intent, you should early return.
      return;
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }

  // For some cases, a new load intent triggers onNewIntent() instead of
  // onStart().
  @Override
  protected void onNewIntent(Intent intent) {
    MediaManager mediaManager =
        CastReceiverContext.getInstance().getMediaManager();
    // Pass the intent to the SDK. You can also do this in onCreate().
    if (mediaManager.onNewIntent(intent)) {
      // If the SDK recognizes the intent, you should early return.
      return;
    }
    // If the SDK doesn't recognize the intent, you can handle the intent with
    // your own logic.
    ...
  }
}

MediaManager যদি শনাক্ত করে যে ইনটেন্টটি একটি লোড ইনটেন্ট, তাহলে এটি ইনটেন্ট থেকে একটি MediaLoadRequestData অবজেক্ট এক্সট্র্যাক্ট করে এবং MediaLoadCommandCallback.onLoad()-কে ইনভোক করে। লোড করার অনুরোধ ম্যানেজ করতে আপনাকে এই পদ্ধতি ওভাররাইড করতে হবে। MediaManager.onNewIntent() কল করার আগে কলব্যাক রেজিস্টার করতে হবে (এটি অ্যাক্টিভিটি বা অ্যাপ্লিকেশন onCreate() পদ্ধতিতে করার জন্য সাজেস্ট করা হয়)।

Kotlin

class MyActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val mediaManager = CastReceiverContext.getInstance().getMediaManager()
        mediaManager.setMediaLoadCommandCallback(MyMediaLoadCommandCallback())
    }
}

class MyMediaLoadCommandCallback : MediaLoadCommandCallback() {
  override fun onLoad(
        senderId: String?,
        loadRequestData: MediaLoadRequestData
  ): Task {
      return Tasks.call {
        // Resolve the entity into your data structure and load media.
        val mediaInfo = loadRequestData.getMediaInfo()
        if (!checkMediaInfoSupported(mediaInfo)) {
            // Throw MediaException to indicate load failure.
            throw MediaException(
                MediaError.Builder()
                    .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED)
                    .setReason(MediaError.ERROR_REASON_INVALID_REQUEST)
                    .build()
            )
        }
        myFillMediaInfo(MediaInfoWriter(mediaInfo))
        myPlayerLoad(mediaInfo.getContentUrl())

        // Update media metadata and state (this clears all previous status
        // overrides).
        castReceiverContext.getMediaManager()
            .setDataFromLoad(loadRequestData)
        ...
        castReceiverContext.getMediaManager().broadcastMediaStatus()

        // Return the resolved MediaLoadRequestData to indicate load success.
        return loadRequestData
     }
  }

  private fun myPlayerLoad(contentURL: String) {
    myPlayer.load(contentURL)

    // Update the MediaSession state.
    val playbackState: PlaybackStateCompat = Builder()
        .setState(
            player.getState(), player.getPosition(), System.currentTimeMillis()
        )
        ...
        .build()
    mediaSession.setPlaybackState(playbackState)
  }

Java

public class MyActivity extends Activity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    MediaManager mediaManager =
        CastReceiverContext.getInstance().getMediaManager();
    mediaManager.setMediaLoadCommandCallback(new MyMediaLoadCommandCallback());
  }
}

public class MyMediaLoadCommandCallback extends MediaLoadCommandCallback {
  @Override
  public Task onLoad(String senderId, MediaLoadRequestData loadRequestData) {
    return Tasks.call(() -> {
        // Resolve the entity into your data structure and load media.
        MediaInfo mediaInfo = loadRequestData.getMediaInfo();
        if (!checkMediaInfoSupported(mediaInfo)) {
          // Throw MediaException to indicate load failure.
          throw new MediaException(
              new MediaError.Builder()
                  .setDetailedErrorCode(DetailedErrorCode.LOAD_FAILED)
                  .setReason(MediaError.ERROR_REASON_INVALID_REQUEST)
                  .build());
        }
        myFillMediaInfo(new MediaInfoWriter(mediaInfo));
        myPlayerLoad(mediaInfo.getContentUrl());

        // Update media metadata and state (this clears all previous status
        // overrides).
        castReceiverContext.getMediaManager()
            .setDataFromLoad(loadRequestData);
        ...
        castReceiverContext.getMediaManager().broadcastMediaStatus();

        // Return the resolved MediaLoadRequestData to indicate load success.
        return loadRequestData;
    });
}

private void myPlayerLoad(String contentURL) {
  myPlayer.load(contentURL);

  // Update the MediaSession state.
  PlaybackStateCompat playbackState =
      new PlaybackStateCompat.Builder()
          .setState(
              player.getState(), player.getPosition(), System.currentTimeMillis())
          ...
          .build();
  mediaSession.setPlaybackState(playbackState);
}

লোড ইনটেন্ট প্রসেস করতে, আমাদের সংজ্ঞায়িত করা ডেটা স্ট্রাকচারে আপনি ইনটেন্ট পার্স করতে পারবেন (লোড অনুরোধের জন্য MediaLoadRequestData)।

মিডিয়া কমান্ড কাজ করে

প্রাথমিক প্লেব্যাক কন্ট্রোল সংক্রান্ত সহায়তা

প্রাথমিক ইন্টিগ্রেশন কমান্ডের মধ্যে এমন কমান্ড অন্তর্ভুক্ত থাকে যা মিডিয়া সেশনের সাথে মানানসই। মিডিয়া সেশন কলব্যাকের মাধ্যমে এইসব কমান্ডের ব্যাপারে জানানো হয়। এটি কাজ করার জন্য আপনাকে মিডিয়া সেশনে কলব্যাক রেজিস্টার করতে হবে (আপনি হয়ত এটি আগেই করেছেন)।

Kotlin

private class MyMediaSessionCallback : MediaSessionCompat.Callback() {
  override fun onPause() {
    // Pause the player and update the play state.
    myPlayer.pause()
  }

  override fun onPlay() {
    // Resume the player and update the play state.
    myPlayer.play()
  }

  override fun onSeekTo(pos: Long) {
    // Seek and update the play state.
    myPlayer.seekTo(pos)
  }
    ...
 }

mediaSession.setCallback(MyMediaSessionCallback())

Java

private class MyMediaSessionCallback extends MediaSessionCompat.Callback {
  @Override
  public void onPause() {
    // Pause the player and update the play state.
    myPlayer.pause();
  }
  @Override
  public void onPlay() {
    // Resume the player and update the play state.
    myPlayer.play();
  }
  @Override
  public void onSeekTo(long pos) {
    // Seek and update the play state.
    myPlayer.seekTo(pos);
  }

  ...
}

mediaSession.setCallback(new MyMediaSessionCallback());

Cast কন্ট্রোল কমান্ড কাজ করে

কিছু Cast কমান্ড আছে যা MediaSession-এ উপলভ্য নয়, যেমন skipAd() বা setActiveMediaTracks()। এছাড়াও, এখানে কিছু কিউ কমান্ড প্রয়োগ করতে হবে কারণ Cast কিউ MediaSession কিউয়ের সাথে পুরোপুরি মানানসই নয়।

Kotlin

class MyMediaCommandCallback : MediaCommandCallback() {
    override fun onSkipAd(requestData: RequestData?): Task<Void?> {
        // Skip your ad
        ...
        return Tasks.forResult(null)
    }
}

val mediaManager = CastReceiverContext.getInstance().getMediaManager()
mediaManager.setMediaCommandCallback(MyMediaCommandCallback())

Java

public class MyMediaCommandCallback extends MediaCommandCallback {
  @Override
  public Task onSkipAd(RequestData requestData) {
    // Skip your ad
    ...
    return Tasks.forResult(null);
  }
}

MediaManager mediaManager =
    CastReceiverContext.getInstance().getMediaManager();
mediaManager.setMediaCommandCallback(new MyMediaCommandCallback());

কাজ করে এমন মিডিয়া কমান্ড উল্লেখ করুন

আপনার Cast রিসিভারের মতো, আপনার Android TV অ্যাপে কোন কমান্ডগুলি কাজ করে তা নির্দিষ্ট করা উচিত, যাতে প্রেরকরা নির্দিষ্ট UI কন্ট্রোল চালু বা বন্ধ করতে পারেন। MediaSession-এর অংশ হিসেবে কমান্ডের জন্য, PlaybackStateCompat-এ কমান্ড নির্দিষ্ট করুন। অতিরিক্ত কমান্ড MediaStatusModifier-এ উল্লেখ করতে হবে।

Kotlin

// Set media session supported commands
val playbackState: PlaybackStateCompat = PlaybackStateCompat.Builder()
    .setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PAUSE)
    .setState(PlaybackStateCompat.STATE_PLAYING)
    .build()

mediaSession.setPlaybackState(playbackState)

// Set additional commands in MediaStatusModifier
val mediaManager = CastReceiverContext.getInstance().getMediaManager()
mediaManager.getMediaStatusModifier()
    .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT)

Java

// Set media session supported commands
PlaybackStateCompat playbackState =
    new PlaybackStateCompat.Builder()
        .setActions(PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PAUSE)
        .setState(PlaybackStateCompat.STATE_PLAYING)
        .build();

mediaSession.setPlaybackState(playbackState);

// Set additional commands in MediaStatusModifier
MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager();
mediaManager.getMediaStatusModifier()
            .setMediaCommandSupported(MediaStatus.COMMAND_QUEUE_NEXT);

কাজ করছে না এমন বোতাম লুকান

আপনার Android TV অ্যাপে শুধু বেসিক মিডিয়া কন্ট্রোল কাজ করলে, কিন্তু আপনার ওয়েব রিসিভার অ্যাপে আরও উন্নত কন্ট্রোল কাজ করলে, Android TV অ্যাপে কাস্ট করার সময় আপনার প্রেরক অ্যাপ সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করতে হবে। যেমন, আপনার Android TV অ্যাপে প্লেব্যাক রেট পরিবর্তন করার সুবিধা না থাকলে, কিন্তু আপনার ওয়েব রিসিভার অ্যাপে থাকলে, আপনাকে প্রতিটি প্ল্যাটফর্মে কাজ করে এমন অ্যাকশন সঠিকভাবে সেট করতে হবে এবং আপনার প্রেরক অ্যাপ যাতে UI সঠিকভাবে রেন্ডার করে তা নিশ্চিত করতে হবে।

MediaStatus পরিবর্তন করা হচ্ছে

ট্র্যাক, বিজ্ঞাপন, লাইভ ও সারির মতো উন্নত ফিচার কাজ করার জন্য, আপনার Android TV অ্যাপকে অতিরিক্ত তথ্য প্রদান করতে হবে যা MediaSession-এর মাধ্যমে নিশ্চিত করা যাবে না।

এটি অর্জন করার জন্য আমরা আপনাকে MediaStatusModifier ক্লাস প্রদান করি। MediaStatusModifier সবসময় MediaSession-এ কাজ করবে যা আপনি CastReceiverContext-এ সেট করেছেন।

তৈরি ও ব্রডকাস্ট করতে MediaStatus:

Kotlin

val mediaManager: MediaManager = castReceiverContext.getMediaManager()
val statusModifier: MediaStatusModifier = mediaManager.getMediaStatusModifier()

statusModifier
    .setLiveSeekableRange(seekableRange)
    .setAdBreakStatus(adBreakStatus)
    .setCustomData(customData)

mediaManager.broadcastMediaStatus()

Java

MediaManager mediaManager = castReceiverContext.getMediaManager();
MediaStatusModifier statusModifier = mediaManager.getMediaStatusModifier();

statusModifier
    .setLiveSeekableRange(seekableRange)
    .setAdBreakStatus(adBreakStatus)
    .setCustomData(customData);

mediaManager.broadcastMediaStatus();

আমাদের ক্লায়েন্ট লাইব্রেরি MediaSession থেকে বেস MediaStatus পাবে, আপনার Android TV অ্যাপ অতিরিক্ত স্ট্যাটাস নির্দিষ্ট করতে এবং MediaStatus মডিফায়ারের মাধ্যমে স্ট্যাটাস ওভাররাইড করতে পারবে।

কিছু স্টেট ও মেটাডেটা MediaSession এবং MediaStatusModifier, দুটিতেই সেট করা যেতে পারে। আমরা বিশেষভাবে সাজেস্ট করি যে আপনি শুধুমাত্র MediaSession-এ সেট করুন। আপনি এখনও মডিফায়ার ব্যবহার করে MediaSession-এ স্টেট ওভাররাইড করতে পারেন— এটি করার সাজেশন দেওয়া হয় না কারণ মডিফায়ারে স্ট্যাটাসের অগ্রাধিকার সবসময় MediaSession-এর দেওয়া ভ্যালুর চেয়ে বেশি হয়।

মনে রাখবেন: আপনি MediaStatusModifier পরিবর্তন বা আপডেট করলে তবেই আপনাকে broadcastMediaStatus() নম্বরে কল করতে হবে। MediaSession-এ করা পরিবর্তন অটোমেটিক ব্রডকাস্ট করা হয়।

পাঠানোর আগে MediaStatus ইন্টারসেপ্ট করা হচ্ছে

Web Receiver SDK-এর মতোই, পাঠানোর আগে আপনি যদি কিছু ফিনিশিং টাচ দিতে চান, তাহলে আপনি MediaStatus প্রসেস করার জন্য MediaStatusInterceptor নির্দিষ্ট করতে পারেন। আমরা একটি MediaStatusWriter পাস করি যাতে MediaStatus পাঠানোর আগে সেটি ম্যানিপুলেট করা যায়।

Kotlin

mediaManager.setMediaStatusInterceptor(object : MediaStatusInterceptor {
    override fun intercept(mediaStatusWriter: MediaStatusWriter) {
      // Perform customization.
        mediaStatusWriter.setCustomData(JSONObject("{data: \"my Hello\"}"))
    }
})

Java

mediaManager.setMediaStatusInterceptor(new MediaStatusInterceptor() {
    @Override
    public void intercept(MediaStatusWriter mediaStatusWriter) {
        // Perform customization.
        mediaStatusWriter.setCustomData(new JSONObject("{data: \"my Hello\"}"));
    }
});

ব্যবহারকারীর ক্রেডেনশিয়াল ম্যানেজ করা

আপনার Android TV অ্যাপ শুধুমাত্র নির্দিষ্ট ব্যবহারকারীদের অ্যাপ সেশন চালু করতে বা তাতে যোগ দিতে অনুমতি দিতে পারে। যেমন, প্রেরককে শুধুমাত্র তখনই লঞ্চ বা যোগ করার অনুমতি দিন যদি:

• প্রেরক অ্যাপটি ATV অ্যাপের মতো একই অ্যাকাউন্ট এবং প্রোফাইলে লগ-ইন করা আছে।
• প্রেরক অ্যাপ একই অ্যাকাউন্টে লগ-ইন করা আছে, তবে ATV অ্যাপের মতো আলাদা প্রোফাইল।

আপনার অ্যাপ একাধিক বা পরিচয় গোপন রাখা ব্যবহারকারীকে ম্যানেজ করতে পারলে, আপনি অতিরিক্ত যেকোনও ব্যবহারকারীকে ATV সেশনে যোগ দেওয়ার অনুমতি দিতে পারেন। ব্যবহারকারী ক্রেডেনশিয়াল প্রদান করলে, আপনার ATV অ্যাপকে তার ক্রেডেনশিয়াল ম্যানেজ করতে হবে যাতে তার অগ্রগতি এবং অন্যান্য ব্যবহারকারীর ডেটা সঠিকভাবে ট্র্যাক করা যায়।

আপনার প্রেরক অ্যাপ যখন আপনার Android TV অ্যাপ চালু করে বা তাতে যোগ দেয়, তখন আপনার প্রেরক অ্যাপকে এমন ক্রেডেনশিয়াল প্রদান করতে হবে যা সেশনে কে যোগ দিচ্ছে তা দেখায়।

কোনও প্রেরক আপনার Android TV অ্যাপ লঞ্চ করে যোগ দেওয়ার আগে, প্রেরকের ক্রেডেনশিয়াল অনুমোদিত কিনা তা দেখার জন্য আপনি লঞ্চ চেকার নির্দিষ্ট করতে পারেন। তা না হলে, Cast Connect SDK আপনার ওয়েব রিসিভার লঞ্চ করার আগের অবস্থায় ফিরে যায়।

প্রেরক অ্যাপ লঞ্চ ক্রেডেনশিয়াল ডেটা

প্রেরকের দিকে, সেশনে কে যোগ দিচ্ছেন তা বোঝাতে আপনি CredentialsData উল্লেখ করতে পারেন।

credentials হল একটি স্ট্রিং যা ব্যবহারকারী-নির্ধারিত হতে পারে, যতক্ষণ না আপনার ATV অ্যাপ এটি বুঝতে পারে। credentialsType নির্ধারণ করে যে কোন প্ল্যাটফর্ম থেকে CredentialsData আসছে অথবা এটি কাস্টম ভ্যালু হতে পারে। ডিফল্ট হিসেবে এটি সেই প্ল্যাটফর্মে সেট করা থাকে যেখান থেকে এটি পাঠানো হচ্ছে।

লঞ্চ বা যোগ দেওয়ার সময় CredentialsData শুধুমাত্র আপনার Android TV অ্যাপে পাস করা হয়। কানেক্ট থাকা অবস্থায় আপনি এটি আবার সেট করলে, এটি আপনার Android TV অ্যাপে পাস করা হবে না। কানেক্ট থাকা অবস্থায় আপনার প্রেরক প্রোফাইল পরিবর্তন করলে, আপনি সেশনে থাকতে পারেন অথবা নতুন প্রোফাইল সেশনের সাথে মানানসই নয় বলে মনে করলে SessionManager.endCurrentCastSession(boolean stopCasting) কল করতে পারেন।

প্রতিটি প্রেরকের জন্য CredentialsData CastReceiverContext-এ getSenders ব্যবহার করে ফিরিয়ে আনা যেতে পারে, যাতে SenderInfo পাওয়া যায়, getCastLaunchRequest() ব্যবহার করে CastLaunchRequest পাওয়া যায় এবং তারপর getCredentialsData()।

Android

play-services-cast-framework ভার্সন 19.0.0 বা তার পরের যেকোনও ভার্সন প্রয়োজন।

Kotlin

CastContext.getSharedInstance().setLaunchCredentialsData(
    CredentialsData.Builder()
        .setCredentials("{\"userId\": \"abc\"}")
        .build()
)

জাভা

CastContext.getSharedInstance().setLaunchCredentialsData(
    new CredentialsData.Builder()
        .setCredentials("{\"userId\": \"abc\"}")
        .build());

iOS

google-cast-sdk ভার্সন v4.8.6 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

বিকল্প সেট করার পরে যেকোনও সময় কল করা যেতে পারে: GCKCastContext.setSharedInstanceWith(options).

GCKCastContext.sharedInstance().setLaunch(
    GCKCredentialsData(credentials: "{\"userId\": \"abc\"}")

ওয়েব

Chromium ব্রাউজার ভার্সন M87 বা তার পরবর্তী ভার্সন প্রয়োজন।

বিকল্প সেট করার পরে যেকোনও সময় কল করা যেতে পারে: cast.framework.CastContext.getInstance().setOptions(options);.

let credentialsData =
    new chrome.cast.CredentialsData("{\"userId\": \"abc\"}");
cast.framework.CastContext.getInstance().setLaunchCredentialsData(credentialsData);

ATV লঞ্চ অনুরোধ চেকার প্রয়োগ করা

কোনও প্রেরক লঞ্চ বা যোগ দেওয়ার চেষ্টা করলে, CredentialsData আপনার Android TV অ্যাপে পাস করা হয়। আপনি LaunchRequestChecker প্রয়োগ করতে পারেন। এই অনুরোধ অনুমোদন বা বাতিল করতে।

অনুরোধ বাতিল করা হলে, ATV অ্যাপে নেটিভভাবে লঞ্চ করার পরিবর্তে ওয়েব রিসিভার লোড করা হয়। আপনার ATV যদি ব্যবহারকারীর লঞ্চ বা যোগ দেওয়ার অনুরোধ ম্যানেজ করতে না পারে, তাহলে আপনার অনুরোধ বাতিল করা উচিত। উদাহরণস্বরূপ, অনুরোধকারী ব্যবহারকারীর থেকে আলাদা কোনও ব্যবহারকারী ATV অ্যাপে লগ-ইন করে থাকলে এবং আপনার অ্যাপ ক্রেডেনশিয়াল পরিবর্তন করতে না পারলে অথবা বর্তমানে কোনও ব্যবহারকারী ATV অ্যাপে লগ-ইন করে না থাকলে এই সমস্যা হতে পারে।

অনুরোধের অনুমতি দেওয়া হলে, ATV অ্যাপ চালু হয়। ব্যবহারকারী ATV অ্যাপে লগ-ইন না করে থাকলে অথবা ব্যবহারকারীর তথ্য না মিললে, আপনার অ্যাপ লোড করার অনুরোধ পাঠাতে পারে কিনা তার উপর নির্ভর করে আপনি এই আচরণ কাস্টমাইজ করতে পারবেন। এই আচরণ LaunchRequestChecker-এ সম্পূর্ণরূপে কাস্টমাইজ করা যায়।

CastReceiverOptions.LaunchRequestChecker ইন্টারফেস প্রয়োগ করে একটি ক্লাস তৈরি করুন:

Kotlin

class MyLaunchRequestChecker : LaunchRequestChecker {
  override fun checkLaunchRequestSupported(launchRequest: CastLaunchRequest): Task {
    return Tasks.call {
      myCheckLaunchRequest(
           launchRequest
      )
    }
  }
}

private fun myCheckLaunchRequest(launchRequest: CastLaunchRequest): Boolean {
  val credentialsData = launchRequest.getCredentialsData()
     ?: return false // or true if you allow anonymous users to join.

  // The request comes from a mobile device, e.g. checking user match.
  return if (credentialsData.credentialsType == CredentialsData.CREDENTIALS_TYPE_ANDROID) {
     myCheckMobileCredentialsAllowed(credentialsData.getCredentials())
  } else false // Unrecognized credentials type.
}

Java

public class MyLaunchRequestChecker
    implements CastReceiverOptions.LaunchRequestChecker {
  @Override
  public Task checkLaunchRequestSupported(CastLaunchRequest launchRequest) {
    return Tasks.call(() -> myCheckLaunchRequest(launchRequest));
  }
}

private boolean myCheckLaunchRequest(CastLaunchRequest launchRequest) {
  CredentialsData credentialsData = launchRequest.getCredentialsData();
  if (credentialsData == null) {
    return false;  // or true if you allow anonymous users to join.
  }

  // The request comes from a mobile device, e.g. checking user match.
  if (credentialsData.getCredentialsType().equals(CredentialsData.CREDENTIALS_TYPE_ANDROID)) {
    return myCheckMobileCredentialsAllowed(credentialsData.getCredentials());
  }

  // Unrecognized credentials type.
  return false;
}

তারপর আপনার ReceiverOptionsProvider-এ এটি সেট করুন:

Kotlin

class MyReceiverOptionsProvider : ReceiverOptionsProvider {
  override fun getOptions(context: Context?): CastReceiverOptions {
    return CastReceiverOptions.Builder(context)
        ...
        .setLaunchRequestChecker(MyLaunchRequestChecker())
        .build()
  }
}

Java

public class MyReceiverOptionsProvider implements ReceiverOptionsProvider {
  @Override
  public CastReceiverOptions getOptions(Context context) {
    return new CastReceiverOptions.Builder(context)
        ...
        .setLaunchRequestChecker(new MyLaunchRequestChecker())
        .build();
  }
}

LaunchRequestChecker-এ true সমাধান করলে ATV অ্যাপ চালু হয় এবং false আপনার ওয়েব রিসিভার অ্যাপ চালু করে।

কাস্টম মেসেজ পাঠানো ও রিসিভ করা

Cast প্রোটোকল আপনাকে প্রেরক এবং আপনার রিসিভার অ্যাপ্লিকেশনের মধ্যে কাস্টম স্ট্রিং মেসেজ পাঠাতে দেয়। আপনার CastReceiverContext শুরু করার আগে, মেসেজ পাঠানোর জন্য আপনাকে অবশ্যই একটি নেমস্পেস (চ্যানেল) রেজিস্টার করতে হবে।

Android TV—কাস্টম নেমস্পেস নির্দিষ্ট করুন

সেট-আপ করার সময় আপনার CastReceiverOptions -এ কাজ করে এমন নেমস্পেস উল্লেখ করতে হবে:

Kotlin

class MyReceiverOptionsProvider : ReceiverOptionsProvider {
  override fun getOptions(context: Context?): CastReceiverOptions {
    return CastReceiverOptions.Builder(context)
        .setCustomNamespaces(
            Arrays.asList("urn:x-cast:com.example.cast.mynamespace")
        )
        .build()
  }
}

Java

public class MyReceiverOptionsProvider implements ReceiverOptionsProvider {
  @Override
  public CastReceiverOptions getOptions(Context context) {
    return new CastReceiverOptions.Builder(context)
        .setCustomNamespaces(
              Arrays.asList("urn:x-cast:com.example.cast.mynamespace"))
        .build();
  }
}

মনে রাখবেন: নেমস্পেস অবশ্যই urn:x-cast: প্রিফিক্স দিয়ে শুরু হতে হবে।

Android TV—মেসেজ পাঠানো

Kotlin

// If senderId is null, then the message is broadcasted to all senders.
CastReceiverContext.getInstance().sendMessage(
    "urn:x-cast:com.example.cast.mynamespace", senderId, customString)

Java

// If senderId is null, then the message is broadcasted to all senders.
CastReceiverContext.getInstance().sendMessage(
    "urn:x-cast:com.example.cast.mynamespace", senderId, customString);

Android TV—কাস্টম নেমস্পেস মেসেজ রিসিভ করুন

Kotlin

class MyCustomMessageListener : MessageReceivedListener {
    override fun onMessageReceived(
        namespace: String, senderId: String?, message: String ) {
        ...
    }
}

CastReceiverContext.getInstance().setMessageReceivedListener(
    "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());

Java

class MyCustomMessageListener implements CastReceiverContext.MessageReceivedListener {
  @Override
  public void onMessageReceived(
      String namespace, String senderId, String message) {
    ...
  }
}

CastReceiverContext.getInstance().setMessageReceivedListener(
    "urn:x-cast:com.example.cast.mynamespace", new MyCustomMessageListener());