类:QueueLoadRequestData

构造函数

QueueLoadRequestData

new QueueLoadRequestData(items)

参数

items

非 null cast.framework.messages.QueueItem 数组

队列项列表。商品的 itemId 字段应为空,否则请求将失败并显示 INVALID_PARAMS 错误。对该元素进行排序(第一个元素会最先播放)。

值不能为 null。

扩展
cast.framework.messages.RequestData

属性

currentTime

(数字或未定义)

开始播放要播放的第一项的秒数(从内容开头开始)。 如果提供,则此值将优先于在 QueueItem 级别提供的 startTime 值,但仅在项第一次播放时才会。这是为了涵盖用户投射本地播放的项的常见情况,因此 currentTime 不会像 QueueItem startTime 那样永久应用于项。避免必须动态重置 startTime(如果手机已进入休眠状态,可能无法进行重置)。

customData

(非 null 对象或未定义)

此请求的应用特定数据。它使发送方和接收方能够轻松扩展媒体协议,而不必为自定义消息使用新的命名空间。

继承来源
cast.framework.messages.RequestData#customData

items

非 null 非 null cast.framework.messages.QueueItem 数组

队列项的数组。对元素进行排序(第一个元素会最先播放)。

mediaSessionId

(数字或未定义)

请求所适用的媒体会话的 ID。

继承来源
cast.framework.messages.RequestData#mediaSessionId

repeatMode

cast.framework.messages.RepeatMode 或 undefined)

播放所有项时队列的行为。

requestId

number

请求的 ID,用于关联请求/响应。

继承来源
cast.framework.messages.RequestData#requestId

sequenceNumber

(数字或未定义)

用于同步所有队列命令的数字。 如果为队列命令提供了此序列号,SDK 将验证队列的最新序列号是否与请求匹配。当前序列号作为传出队列已更改消息的一部分提供。

继承来源
cast.framework.messages.RequestData#sequenceNumber

startIndex

(数字或未定义)

items 数组中必须是第一个 currentItem(首先播放的项)的项的索引。请注意,这是数组的索引(从 0 开始),而不是 itemId(因为在创建队列之前才知道该索引)。如果 repeatMode 为 REPEAT_OFF,则播放将在数组中的最后一项内容播放时结束(不会播放 startIndex 之前的元素)。 这对于连续场景(用户已在使用发送器应用但中间却决定投放)可能会非常有用。这样一来,发送方应用就不需要在本地和远程队列位置之间映射,也不需要保存一个额外的 QUEUE_UPDATE 请求。