الوضع في قائمة الانتظار

يختلف نموذج قائمة المحتوى التالي في البثّ عن ذلك في MediaSession. لا تتيح مكتبة Cast Connect قراءة قائمة المحتوى التالي التي يوفّرها MediaSession.

التعامل مع معلومات قائمة المحتوى التالي وتحميلها

يتم تحميل قائمة الانتظار بالطريقة نفسها التي يتم بها تحميل العناصر الفردية (عن طريق بدء النشاط لغرض معيّن). عليك استخدام مكتبة البرامج لتحليل الغرض إلى MediaLoadRequestData. يتضمّن الحقل MediaQueueData معلومات قائمة المحتوى التالي المطلوب تحميلها.

كوتلين

fun handleCastLoad(requestData: MediaLoadRequestData?) {
  if (requestData.getQueueData()) {
    // If MediaQueueData is specified, this is a queue load request.
    myPlayer.load(
          requestData.getQueueData().getItems().get(0))

    // Set media status.
    castReceiverContext.getMediaManager()
        .setDataFromLoad(requestData) // This clears all status overrides.
                                      // The queue information is updated with
                                      // the MediaQueueData in the request.
        ...

    mediaSession.setPlaybackState(...)
  }
}

Java

private void handleCastLoad(MediaLoadRequestData requestData) {
  if (requestData.getQueueData()) {
    // If MediaQueueData is specified, this is a queue load request.
    myPlayer.load(
        requestData.getQueueData().getItems().get(0));

    // Set media status.
    castReceiverContext.getMediaManager()
        .setDataFromLoad(requestData) // This clears all status overrides.
                                      // The queue information is updated with
                                      // the MediaQueueData in the request.
        ...;

    mediaSession.setPlaybackState(...);
  }
}

تغيير قائمة المحتوى التالي

عند إجراء تغييرات على قائمة المحتوى التالي (مثلاً من queueInsert())، يمكنك استخدام MediaQueueManager لتعديل قائمة المحتوى التالي. إذا كنت تنشئ عناصر جديدة في قائمة الانتظار، احرص على ضبط معرّف السلعة من خلال طلب البيانات setItemId() في أداة الإنشاء باستخدام MediaQueueManager.autoGenerateItemId() لإنشاء معرّف السلعة. سبق أن تم ضبط معرّفات السلع الخاصة بالعناصر في قائمة الانتظار التي تم تحميلها عبر setDataFromLoad().

كوتلين

val mediaManager: MediaManager = castReceiverContext.getMediaManager()

val mediaQueueManager = mediaManager.getMediaQueueManager()

mediaQueueManager.getQueueItems().add( /* position= */index, mediaQueueItem)

mediaManager.broadcastMediaStatus()

Java

MediaManager mediaManager = castReceiverContext.getMediaManager();

MediaQueueManager mediaQueueManager = mediaManager.getMediaQueueManager();

mediaQueueManager.getQueueItems().add(/* position= */ index, mediaQueueItem);

mediaManager.broadcastMediaStatus();

وتتعامل تطبيقات Android TV أيضًا مع onQueueUpdate() معاودة الاتصال لإتاحة الانتقال إلى عناصر قائمة المحتوى التالي وتخطّي التالي/السابق:

كوتلين

class MyMediaCommandCallback : MediaCommandCallback() {
    override fun onQueueUpdate(
        queueUpdateRequestData: QueueUpdateRequestData ): Task {
        ...
        var newItemId = MediaQueueItem.INVALID_ITEM_ID
        if (queueUpdateRequestData.getJump() != null) {
            newItemId = myGetRelativeItemId(queueUpdateRequestData.getJump())
        } else if (queueUpdateRequestData.getCurrentItemId() != null) {
            newItemId = queueUpdateRequestData.getCurrentItemId()
        }
        if (newItemId != MediaQueueItem.INVALID_ITEM_ID) {
            castReceiverContext.getMediaManager().getMediaQueueManager()
                .setCurrentItemId(newItemId)
            castReceiverContext.getMediaManager().broadcastMediaStatus()
        }
    }
}

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

Java

public class MyMediaCommandCallback extends MediaCommandCallback {
  @Override
  public Task onQueueUpdate(
      QueueUpdateRequestData queueUpdateRequestData) {
    ...
    int newItemId = MediaQueueItem.INVALID_ITEM_ID;
    if (queueUpdateRequestData.getJump() != null) {
      newItemId = myGetRelativeItemId(queueUpdateRequestData.getJump());
    } else if (queueUpdateRequestData.getCurrentItemId() != null) {
      newItemId = queueUpdateRequestData.getCurrentItemId();
    }

    if (newItemId != MediaQueueItem.INVALID_ITEM_ID) {
      castReceiverContext.getMediaManager().getMediaQueueManager()
          .setCurrentItemId(newItemId);
      castReceiverContext.getMediaManager().broadcastMediaStatus();
    }
}

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

التعامل مع التحكم في النقل المتعلق بقائمة الانتظار

يمكنك أيضًا تنفيذ عمليات استدعاء التحكم في النقل المرتبطة بقائمة الانتظار، مثل onSkipToNext() أو onSkipToPrevious() أو onSkipToQueueItem().

كوتلين

class MyMediaSessionCallback : MediaSessionCompat.Callback() {
  override fun onSkipToNext() {
    // Skip to next item in queue
    ...
  }

  override fun onSkipToPrevious() {
    // Skip to previous item in queue
    ...
  }

  override fun onSkipToQueueItem(pos: Long) {
    // Skip to specified queue item
    ...
  }
    ...
}

mediaSession.setCallback(MyMediaSessionCallback())

Java

public class MyMediaSessionCallback extends MediaSessionCompat.Callback {
  @Override
  public void onSkipToNext() {
    // Skip to next item in queue
    ...
  }

  @Override
  public void onSkipToPrevious() {
    // Skip to previous item in queue
    ...
  }

  @Override
  public void onSkipToQueueItem (long pos) {
    // Skip to specified queue item
    ...
  }
  ...
}

mediaSession.setCallback(new MyMediaSessionCallback());