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

يختلف نموذج قائمة المحتوى التالي في البثّ عن ذلك النموذج في 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());