GCKMediaQueueItem 類別

GCKMediaQueueItem 類別參考資料

總覽

代表媒體佇列項目的類別。

這個物件的例項無法變更。

這個類別用於傳送者應用程式與接收器應用程式之間的雙向通訊。傳送者會建構這些函式,以便在接收端應用程式中載入或插入媒體項目清單。接收端的 GCKMediaStatus 也包含以這個類別例項表示的項目清單。

載入後,即使多次載入相同的媒體,接收器仍會為每個 GCKMediaQueueItem 指派專屬項目 ID。

繼承 NSObject。實作 <NS copy>。

執行個體方法摘要

(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

與這個項目相關聯的自訂資料 (如果有的話)。