cast.
媒体事件队列 INSERT 请求数据。
构造函数
QueueInsertRequestData
new QueueInsertRequestData(items)
参数 |
|
|---|---|
|
items |
非 null cast.framework.messages.QueueItem 数组 队列项列表。商品的 itemId 字段应为空，否则请求将失败并显示 INVALID_PARAMS 错误。对该元素进行排序（第一个元素会最先播放）。 值不能为 null。 |
属性
currentItemId
（数字或未定义）
插入后当前媒体内容的 ID（如果未提供，则 currentItem 值将与插入前相同）。
currentItemIndex
（数字或未定义）
新的当前媒体项的索引（相对于 items 数组，从 0 开始）。对于插入的项，我们使用索引（类似于 QUEUE_LOAD 中的 startIndex）而不是 currentItemId，因为 itemId 在项插入之前是未知的。如果未提供，则 currentItem 值将与插入之前相同（除非提供了 currentItemId）。 此参数可让原子操作成为插入和播放项目的常见用例。
currentTime
（数字或未定义）
从内容开始播放到当前项播放的秒数。如果提供，则此值将优先于在 QueueItem 级别提供的 startTime 值，但仅在项第一次播放时才会。这是为了涵盖用户跳转到某个项的中间这一常见情况，因此 currentTime 不会像 QueueItem startTime 那样永久应用于该项。避免必须动态重置 startTime（如果手机已进入休眠状态，可能无法进行重置）。
customData
（非 null 对象或未定义）
此请求的应用特定数据。它使发送方和接收方能够轻松扩展媒体协议，而不必为自定义消息使用新的命名空间。
insertBefore
（数字或未定义）
紧挨着插入列表的商品 ID。 如果未找到或未提供 ID，列表会附加到现有列表的末尾。
items
非 null 非 null cast.framework.messages.QueueItem 数组
队列项列表。商品的 itemId 字段应为空。对该元素进行了排序（第一个元素会最先播放）。
mediaSessionId
（数字或未定义）
请求所适用的媒体会话的 ID。
requestId
number
请求的 ID，用于关联请求/响应。
sequenceNumber
（数字或未定义）
用于同步所有队列命令的数字。 如果为队列命令提供了此序列号，SDK 将验证队列的最新序列号是否与请求匹配。当前序列号作为传出队列已更改消息的一部分提供。