cast. 框架。 消息。 QueueLoadRequestData
媒体事件队列 LOAD 请求数据。
构造函数
QueueLoadRequestData
新 QueueLoadRequestData(items)
参数 |
|
---|---|
items |
非 null cast.framework.messages.QueueItem 数组 队列项列表。商品的 itemId 字段应为空,否则请求将会失败,并显示 INVALID_PARAMS 错误。它已排序(第一个元素将首先播放)。 值不能为 null。 |
属性
currentTime
(数字或未定义)
从第一项内容开始播放的秒数(从开始播放第一项内容算起)。如果提供,则此值将优先于在 QueueItem 级别提供的 startTime 值,但仅第一次播放相应项。这涵盖用户投射本地播放的内容的具体情况,因此 currentTime 不会像 QueueItem startTime 一样永久应用于该内容。它不必动态重置 startTime(如果手机已休眠,则可能无法重置)。
自定义数据
(非 null 对象或未定义)
此请求的应用专用数据。它可让发送者和接收者轻松扩展媒体协议,而无需使用新的命名空间和自定义消息。
items
非 null cast.framework.messages.QueueItem 的数组
队列项的数组。已排序(第一个元素将首先播放)。
mediaSessionId
(数字或未定义)
请求应用到的媒体会话的 ID。
重复模式
(cast.framework.messages.RepeatMode 或未定义)
播放完所有内容后队列的行为。
requestId
number
请求的 ID,用于关联请求/响应。
序列号
(数字或未定义)
用于同步所有队列命令的数字。 如果为队列命令提供了此 SDK,SDK 将验证队列的最新序列号是否与请求相匹配。当前序列号作为外发队列更改消息的一部分提供。
startIndex
(数字或未定义)
items 数组中项目的索引,必须是第一个 currentItem(即将首先播放的项目)。请注意,这是数组的索引(从 0 开始),而不是 itemId(因为在创建队列之前不知道 itemId)。如果 repeatMode 为 REPEAT_OFF,则在播放数组中的最后一项时播放将会结束(startIndex 之前的元素将不会播放)。 对于用户已经在使用发送者应用,并在中间决定投屏的后续场景,这非常有用。这样,发送器应用无需在本地和远程队列位置之间映射,也无需保存一个额外的 QUEUE_UPDATE 请求。