排队

Cast 框架提供了支持创建 MediaQueueItem 实例列表的队列类，这些实例可以从 MediaInfo 实例（例如视频或音频串流）构建，以便在接收器上顺序播放。此内容项队列可进行修改、重新排序、更新等操作。

只要队列中至少有一个当前处于活动状态（正在播放或暂停）的内容，接收器 SDK 就会维护队列并响应对队列的操作。发件人可以加入会话并将内容添加到队列中。接收器会为队列项维护一个会话，直到最后一个项完成播放、发送器停止播放并终止会话，或者发送器在接收器上加载新队列为止。默认情况下，接收器不会维护有关已终止队列的任何信息。队列中的最后一项内容播放完毕后，媒体会话结束，队列消失。

创建和加载媒体队列项

媒体队列项在 Cast 框架中表示为 MediaQueueItem 实例。创建媒体队列项时，如果您将媒体播放器库与自适应内容搭配使用，则可以设置预加载时间，以便播放器可以在队列中排在该项前面的项播放完毕之前开始缓冲该媒体队列项。将内容的 autoplay 属性设置为 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() 方法 - 如果已预加载下一个项，则返回预加载的项 ID。
• getLoadingItemId() 方法 - 返回接收器上当前正在加载（但在队列中处于非活动状态）的项的项 ID。
• getCurrentItemId() 方法 - 返回在媒体状态发生变化时队列中处于活动状态（可能未播放）的内容的 ID。
• getQueueItems()（已废弃，请改用 MediaQueue）方法 - 将 MediaQueueItem 实例列表作为不可修改的列表返回。

您的应用还可以使用 MediaQueue 类获取项列表。该类是媒体队列的稀疏数据模型。它会将项 ID 列表保留在队列中，该列表会自动与接收器同步。MediaQueue 不会保留所有 MediaQueueItem，因为队列很长时，它会占用太多内存。而是会按需提取内容，并保留最近访问过的内容的 LruCache。您可以使用以下方法访问媒体队列：

• getItemIds() 方法 - 按顺序返回所有商品 ID 的列表。
• getItemAtIndex() 方法 - 返回给定索引处的缓存项。如果未缓存该项，MediaQueue 将返回 null 并安排提取该项。提取内容时，系统会调用 MediaQueue.Callback#itemsUpdatedAtIndexes()，再次使用相同 ID 调用 getItemAtIndex() 将返回该内容。
• 当用户将队列界面滚动到顶部或底部，并且您的应用想要从云端提取更多内容时，请使用 fetchMoteItemsRelativeToIndex()。

将这些方法与其他媒体状态方法结合使用，可告知应用队列的状态和队列中的项。除了接收器中的媒体状态更新之外，您的应用还可以通过实现 RemoteMediaClient.Callback 和 MediaQueue.Callback 来监听队列的更改。

此外，Cast SDK 还提供了两个实用程序类，用于创建用于队列的界面。

• 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 算法）、从队列中移除项，以及重新排列队列中的项。