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