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