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