GCKMediaQueueItem 类

GCKMediaQueueItem 类参考

概览

表示媒体队列项的类。

此对象的实例不可变。

此类用于发送器应用和接收器应用之间的双向通信。发送方构建媒体项,以在接收方应用中加载或插入媒体项列表。来自接收器的 GCKMediaStatus 还包含表示为此类的实例的项列表。

加载后,接收器会为每个 GCKMediaQueueItem 分配一个唯一的项 ID,即使多次加载相同的媒体也是如此。

继承 NSObject。实现 <NSCopy>。

实例方法摘要

(instancetype) - initWithMediaInformation:autoplay:startTime:preloadTime:activeTrackIDs:customData:
 使用给定属性构造新的 GCKMediaQueueItem更多...
 
(instancetype) - initWithMediaInformation:autoplay:startTime:playbackDuration:preloadTime:activeTrackIDs:customData:
 指定的初始化程序。更多...
 
(void) - clearItemID
 清除(取消分配)项 ID。更多...
 
(instancetype) - mediaQueueItemModifiedWithBlock:
 返回经指定代码块修改的此 GCKMediaQueueItem 的副本。更多...
 

属性摘要

GCKMediaInformationmediaInformation
 与此项关联的媒体信息。更多...
 
GCKMediaQueueItemID itemID
 内容 ID,如果未分配,则为 kGCKMediaQueueInvalidItemID更多...
 
BOOL autoplay
 项成为队列中的当前项时是否自动开始播放。更多...
 
NSTimeInterval startTime
 项的开始时间(以秒为单位)。更多...
 
NSTimeInterval playbackDuration
 商品的播放时长(以秒为单位),如果应使用数据流的实际时长,则为 INFINITY更多...
 
NSTimeInterval preloadTime
 距离上一项内容结束多长时间(以秒为单位)之后接收方应开始预加载此项内容。更多...
 
NSArray< NSNumber * > * activeTrackIDs
 此项的有效轨道 ID。更多...
 
id customData
 与此商品关联的自定义数据(如果有)。更多...
 

方法详细信息

- (instancetype) initWithMediaInformation: (GCKMediaInformation *)  mediaInformation
autoplay: (BOOL)  autoplay
startTime: (NSTimeInterval)  startTime
preloadTime: (NSTimeInterval)  preloadTime
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

使用给定属性构造新的 GCKMediaQueueItem

如需了解详情,请参阅相应属性的文档。

Parameters
mediaInformationThe media information for the item.
autoplayThe autoplay state for this item.
startTimeThe start time of the item, in seconds. May be kGCKInvalidTimeInterval if this item refers to a live stream or if the default start time should be used.
preloadTimeThe preload time for the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time.
activeTrackIDsThe active track IDs for the item. May be nil.
customDataAny custom data to associate with the item. May be nil.
- (instancetype) initWithMediaInformation: (GCKMediaInformation *)  mediaInformation
autoplay: (BOOL)  autoplay
startTime: (NSTimeInterval)  startTime
playbackDuration: (NSTimeInterval)  playbackDuration
preloadTime: (NSTimeInterval)  preloadTime
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

指定的初始化程序。

使用给定属性构造新的 GCKMediaQueueItem。如需了解详情,请参阅相应属性的文档。

Parameters
mediaInformationThe media information for the item.
autoplayThe autoplay state for this item.
startTimeThe start time of the item, in seconds. May be kGCKInvalidTimeInterval if this item refers to a live stream or if the default start time should be used.
playbackDurationThe playback duration of the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time.
preloadTimeThe preload time for the item, in seconds.
activeTrackIDsThe active track IDs for the item. May be nil.
customDataAny custom data to associate with the item. May be nil.
- (void) clearItemID

清除(取消分配)项 ID。

应调用该方法以便重复使用现有实例,例如将其添加回队列中。

- (instancetype) mediaQueueItemModifiedWithBlock: (void(^)(GCKMediaQueueItemBuilder *builder))  block

返回经指定代码块修改的此 GCKMediaQueueItem 的副本。

Parameters
blockA block that receives a GCKMediaQueueItemBuilder which can be used to modify attributes of the copy. It is not necessary to call the builder's build (GCKMediaQueueItemBuilder) method within the block, as this method will do that automatically when the block completes.
返回
此内容的已修改副本。

房源详情

- (GCKMediaInformation*) mediaInformation
readnonatomicstrong

与此项关联的媒体信息。

- (GCKMediaQueueItemID) itemID
readnonatomicassign

内容 ID,如果未分配,则为 kGCKMediaQueueInvalidItemID

- (BOOL) autoplay
readnonatomicassign

项成为队列中的当前项时是否自动开始播放。

如果为 NO,则队列会在到达此项时暂停。默认值为 YES。使用此项在 GCKMediaLoadRequestData 中加载媒体队列时,只有当 GCKMediaLoadRequestData 中的 autoplay 为 nil 时,第一项中的此属性才会生效。

- (NSTimeInterval) startTime
readnonatomicassign

项的开始时间(以秒为单位)。

默认值为 kGCKInvalidTimeInterval,表示未设置开始时间。

- (NSTimeInterval) playbackDuration
readnonatomicassign

商品的播放时长(以秒为单位),如果应使用数据流的实际时长,则为 INFINITY

- (NSTimeInterval) preloadTime
readnonatomicassign

距离上一项内容结束多长时间(以秒为单位)之后接收方应开始预加载此项内容。

默认值为 kGCKInvalidTimeInterval,表示未设置预加载时间。

- (NSArray<NSNumber *>*) activeTrackIDs
readnonatomicstrong

此项的有效轨道 ID。

- (id) customData
readnonatomicstrong

与此商品关联的自定义数据(如果有)。