此页面由 Cloud Translation API 翻译。

排队

Cast 框架提供的队列类支持创建 MediaQueueItem 实例列表（可根据视频或音频流等 MediaInfo 实例构建），从而在接收设备上依序播放。您可以对这个内容项队列执行修改、重新排序和更新等操作。

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

创建和加载媒体队列项

媒体队列项在 Cast 框架中表示为 MediaQueueItem 实例。创建媒体队列项时，如果您使用的是包含自适应内容的媒体播放器库，则可以设置预加载时间，以便播放器在队列中前面的项播放完毕之前，开始缓冲媒体队列项。将项的 autoplay 属性设置为 true 即可允许接收方自动播放相应内容。例如，您可以使用构建器模式创建媒体队列项，如下所示：

Kotlin

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

Java

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，请使用以下代码：

Kotlin

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
}

Java

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

媒体轨道

加入意图