GCKMediaQueueItem 类

GCKMediaQueueItem 类参考文档

概览

表示媒体队列项的类。

此对象的实例不可变。

此类用于发送者应用和接收者应用之间的双向通信。发送者构造这些媒体对象以在接收器应用中加载或插入媒体项列表。接收器中的 GCKMediaStatus 还包含表示为此类实例的项目列表。

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

继承 NSObject。实现 <NSDuplicate>。

实例方法摘要

(instancetype) - initWithMediaInformation:autoplay:startTime:preloadTime:activeTrackIDs:customData:
 使用指定属性构造新的 GCKMediaQueueItem更多...
 
(instancetype) - initWithMediaInformation:autoplay:startTime:playbackDuration:preloadTime:activeTrackIDs:customData:
 指定的初始化程序。更多...
 
(void) - clearItemID
 清除(取消分配)内容 ID。更多...
 
(instancetype) - mediaQueueItemModifiedWithBlock:
 返回此 GCKMediaQueueItem 的副本,该副本已根据给定的块进行修改。更多...
 

属性摘要

GCKMediaInformationmediaInformation
 与此项关联的媒体信息。更多...
 
NSUInteger itemID
 商品 ID;如果尚未分配 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: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  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: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  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

与此项关联的媒体信息。

- (NSUInteger) itemID
readnonatomicassign

商品 ID;如果尚未分配 ID,则为 kGCKMediaQueueInvalidItemID

- (BOOL) autoplay
readnonatomicassign

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

如果为 NO,队列会在到达此项时暂停。默认值为 YES

- (NSTimeInterval) startTime
readnonatomicassign

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

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

- (NSTimeInterval) playbackDuration
readnonatomicassign

内容的播放时长(以秒为单位)或 INFINITY(如果应使用视频流的实际时长)。

- (NSTimeInterval) preloadTime
readnonatomicassign

距离接收端应开始预加载此项还有多长时间(以秒为单位)结束。

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

- (NSArray<NSNumber *>*) activeTrackIDs
readnonatomicstrong

此项目的有效轨道 ID。

- (id) customData
readnonatomicstrong

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