排队

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

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

创建和加载媒体队列项

媒体队列项在 Cast 框架中表示为 MediaQueueItem 实例。创建媒体队列项时，如果您将 Media Player 库与自适应内容搭配使用，则可以设置预加载时间，以便播放器在队列中前面的项播放完毕之前开始缓冲媒体队列项。将商品的自动播放属性设置为 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。您的应用可以了解队列的状态，包括当前加载（可能未播放）、正在加载或预加载的项。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 算法）、从队列中移除项以及重新排序队列中的项。