總覽
這個類別代表媒體佇列項目。
這個物件的執行個體無法變更。
此類別用於傳送者應用程式與接收器應用程式之間的雙向通訊。傳送者可建構，以在接收器應用程式中載入或插入媒體項目清單。接收器中的 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 副本。更多... | |
屬性摘要 | |
| GCKMediaInformation * | mediaInformation |
| 與這個項目相關聯的媒體資訊。更多... | |
| NSUInteger | 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: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs | |
| customData: | (id __nullable) | customData | |
使用指定屬性建構新的 GCKMediaQueueItem。
如需詳細資訊，請參閱對應屬性的說明文件。
- Parameters
-
mediaInformation The media information for the item. autoplay The autoplay state for this item. startTime The 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. preloadTime The preload time for the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time. activeTrackIDs The active track IDs for the item. May be nil.customData Any 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
-
mediaInformation The media information for the item. autoplay The autoplay state for this item. startTime The 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. playbackDuration The playback duration of the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time. preloadTime The preload time for the item, in seconds. activeTrackIDs The active track IDs for the item. May be nil.customData Any custom data to associate with the item. May be nil.
| - (void) clearItemID |
清除 (取消指派) 項目 ID。
您應該呼叫此方法，才能重複使用現有的執行個體，例如將其新增至佇列。
| - (instancetype) mediaQueueItemModifiedWithBlock: | (void(^)(GCKMediaQueueItemBuilder *builder)) | block |
傳回經過指定區塊修改的這個 GCKMediaQueueItem 副本。
- Parameters
-
block A 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.
- 傳回
- 這個項目的修改副本。
資源詳細資料
|
readnonatomicstrong |
與這個項目相關聯的媒體資訊。
|
readnonatomicassign |
項目 ID；如果尚未指派，則為 kGCKMediaQueueInvalidItemID。
|
readnonatomicassign |
當項目成為佇列中目前的項目時，是否會自動開始播放。
如果為 NO，當佇列到達此項目時就會暫停。預設值為 YES。
|
readnonatomicassign |
項目的開始時間，以秒為單位。
預設值為 kGCKInvalidTimeInterval，表示尚未設定任何開始時間。
|
readnonatomicassign |
項目的播放持續時間 (以秒為單位)，如為串流的實際時間長度，則為 INFINITY。
|
readnonatomicassign |
原項在前一個項目結束前經過多久 (以秒計) 開始預先載入這個項目。
預設值為 kGCKInvalidTimeInterval，表示尚未設定預先載入時間。
|
readnonatomicstrong |
這個項目的有效音軌 ID。
|
readnonatomicstrong |
與這個項目相關聯的自訂資料 (如果有的話)。