排程

Cast 架構提供佇列類別，支援建立 MediaQueueItem 執行個體清單，這些執行個體可從 MediaInfo 執行個體 (例如影片或音訊串流) 建構，在接收器上依序播放。你可以編輯、重新排序、更新這個內容項目佇列，以及執行其他操作。

只要佇列中至少有一個項目處於使用中狀態 (播放或暫停)，接收器 SDK 就會維護佇列，並回應佇列中的作業。傳送者可以加入工作階段，並將項目加入待播清單。接收器會為佇列項目維持工作階段，直到最後一個項目播放完畢、傳送者停止播放並終止工作階段，或是傳送者在接收器上載入新佇列為止。根據預設，接收器不會保留任何有關終止佇列的資訊。待播清單中的最後一個項目播放完畢後，媒體工作階段就會結束，待播清單也會消失。

建立及載入媒體佇列項目

在 Cast 架構中，媒體佇列項目會以 MediaQueueItem 執行個體表示。建立媒體佇列項目時，如果使用媒體播放器程式庫搭配自適應內容，您可以設定預先載入時間，讓播放器在佇列中前一個項目播放完畢前，開始緩衝處理媒體佇列項目。將項目的自動播放屬性設為 true，接收器就能自動播放該項目。舉例來說，您可以使用建立工具模式建立媒體佇列項目，如下所示：

val queueItem: MediaQueueItem = MediaQueueItem.Builder(mediaInfo)
    .setAutoplay(true)
    .setPreloadTime(20.0)
    .build()

MediaQueueItem queueItem = new MediaQueueItem.Builder(mediaInfo)
  .setAutoplay(true)
  .setPreloadTime(20)
  .build();

使用 RemoteMediaClient 的適當 queueLoad 方法，在佇列中載入媒體佇列項目陣列。

接收媒體佇列狀態更新

接收器載入媒體佇列項目時，會為該項目指派專屬 ID，這個 ID 在工作階段期間 (以及佇列的生命週期) 都不會變更。應用程式可以瞭解佇列的狀態，包括目前載入 (可能未播放)、載入或預先載入的項目。MediaStatus 類別提供下列狀態資訊：

• getPreloadedItemId() method - If the next item has been preloaded, returns the preloaded item ID.
• getLoadingItemId() 方法 - 傳回接收器上目前正在載入 (但未在佇列中啟用) 的項目 ID。
• getCurrentItemId() 方法 - 傳回媒體狀態變更時，佇列中處於有效狀態的項目 ID (可能未播放)。
• getQueueItems() (已淘汰，請改用 MediaQueue) 方法 - 以不可修改的清單形式，傳回 MediaQueueItem 執行個體清單。

應用程式也可以使用 MediaQueue 類別取得項目清單。這個類別是媒體佇列的稀疏資料模型。這個類別會保留佇列中的項目 ID 清單，並自動與接收器同步。MediaQueue 不會保留所有 MediaQueueItem，因為佇列過長時會佔用過多記憶體。而是會視需要擷取項目，並保留最近存取項目的 LruCache。你可以使用下列方法存取媒體佇列：

• getItemIds() 方法 - 依序傳回所有項目 ID 的清單。
• getItemAtIndex() 方法 - 傳回指定索引處的快取項目。如果項目未快取，MediaQueue 會傳回 null，並排定擷取項目的時間。系統擷取項目時，會呼叫 MediaQueue.Callback#itemsUpdatedAtIndexes()，再次使用相同 ID 呼叫 getItemAtIndex() 會傳回該項目。
• 當使用者將佇列 UI 捲動至頂端或底部，且應用程式想從雲端擷取更多項目時，就會使用 fetchMoteItemsRelativeToIndex()。

請搭配其他媒體狀態方法使用這些方法，向應用程式回報佇列狀態和佇列中的項目。除了接收器傳送的媒體狀態更新之外，應用程式也可以實作 RemoteMediaClient.Callback 和 MediaQueue.Callback，監聽佇列的變更。

此外，Cast SDK 提供兩個公用程式類別，可建立佇列 UI。

• MediaQueueRecyclerViewAdapter， 用於備份 RecyclerView 的資料
• MediaQueueListAdapter，備份 ListAdapter 的資料。

舉例來說，如要使用 MediaQueueRecyclerViewAdapter 建立 RecyclerView：

class MyRecyclerViewAdapter(mediaQueue: MediaQueue?) :
    MediaQueueRecyclerViewAdapter<MyViewHolder?>(mediaQueue) {
    override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
        val item = getItem(position)

        // Update the view using `item`.
        ...
    }
}

class MyViewHolder : RecyclerView.ViewHolder {
    // Implement your own ViewHolder.
    ...
}

fun someMethod() {
    val adapter = MyRecyclerViewAdapter(
        mCastSession.remoteMediaClient.getMediaQueue())
    val recyclerView =
        activity.findViewById(R.id.my_recycler_view_id) as RecyclerView
    recyclerView.adapter = adapter
}

public class MyRecyclerViewAdapter extends MediaQueueRecyclerViewAdapter<MyViewHolder> {
    public MyRecyclerViewAdapter(MediaQueue mediaQueue) {
        super(mediaQueue);
    }

    @Override
    public void onBindViewHolder(MyViewHolder holder, int position) {
      MediaQueueItem item = getItem(position);

      // Update the view using `item`.
      ...
    }
}

public class MyViewHolder implements RecyclerView.ViewHolder {
  // Implement your own ViewHolder.
  ...
}

public void someMethod() {
    RecyclerView.Adapter adapter = new MyRecyclerViewAdapter(
        mCastSession.getRemoteMediaClient().getMediaQueue());
    RecyclerView recyclerView =
        (RecyclerView) getActivity().findViewById(R.id.my_recycler_view_id);
    recyclerView.setAdapter(adapter);
}

編輯佇列

如要對佇列中的項目執行作業，請使用 RemoteMediaClient 類別的佇列方法。這些方法可將項目陣列載入新佇列、將項目插入現有佇列、更新佇列中項目的屬性、讓項目在佇列中向前或向後跳轉、設定佇列本身的屬性 (例如變更選取下一個項目的 repeatMode 演算法)、從佇列中移除項目，以及重新排序佇列中的項目。