總覽

任意長度的媒體佇列的資料模型表示法。

此類別可做為 UITableViewDataSource 實作的基礎，用於驅動媒體佇列 UI。

GCKMediaQueue 會監聽 GCKSessionManager 事件，並在投放工作階段開始時自動附加至 GCKRemoteMediaClient。它會監聽 GCKRemoteMediaClient 的佇列變更通知，並據此更新內部資料模型。同樣地，它會使用 GCKRemoteMediaClient 隨選擷取佇列資訊。

這個模型會維護整個佇列的佇列項目 ID 清單，並在附加至投放工作階段時自動擷取清單。也會維護 GCKMediaQueueItems 的 LRU 快取 (可設定大小)，此快取由佇列項目 ID 索引鍵。

itemAtIndex: (GCKMediaQueue) 方法可用來擷取指定索引的佇列項目。如果 GCKMediaQueueItem 目前不在快取中，系統會發出非同步要求，以便從接收器擷取該項目，並且最終會在收到要求的項目時通知委派。

如果在極短時間內多次呼叫這個方法，要求的項目 ID 會在內部批次處理，減少發出的網路要求數量。由於接收端一次可擷取的佇列項目數量上限，因此 GCKMediaQueue 會保留最後 N 個項目 ID 的滾動式視窗。因此在短時間內要求大量項目時，實際上只會擷取最後 N 個項目。這種行為可有效管理應用程式 UI 中非常長的佇列，使用者可迅速且/或經常捲動畫面。

GCKMediaQueue 不會提供任何直接修改佇列的方法，因為這類變更涉及對接收器 (透過 GCKRemoteMediaClient 上的方法) 的非同步網路要求，而這可能會失敗並發生錯誤。GCKMediaQueue 必須確保佇列中的表示法在接收器中一致，因此如果對資料模型進行本機變更，而該模型尚未在接收器上修訂，可能會導致 UI 行為不正確。

如需委派通訊協定，請參閱 GCKMediaQueueDelegate。

開始時間: 4.3.4

繼承 NSObject。

執行個體方法摘要
(instancetype)	- init

(instancetype)	- initWithRemoteMediaClient:
	使用預設快取大小和預設擷取數量上限來初始化新的 GCKMediaQueue。更多...

(instancetype)	- initWithRemoteMediaClient:cacheSize:
	使用指定的快取大小和預設擷取數量上限來初始化新的 GCKMediaQueue。更多...

(instancetype)	- initWithRemoteMediaClient:cacheSize:maxFetchCount:
	使用指定的快取大小和指定的擷取數量上限來初始化新的 GCKMediaQueue。更多...

(void)	- addDelegate:
	將委派作業新增至這個物件的委派清單。更多...

(void)	- removeDelegate:
	從這個物件的委派清單移除委派對象。更多...

(nullable GCKMediaQueueItem *)	- itemAtIndex:
	傳回佇列中特定索引的媒體佇列項目；如果目前不在快取中，則排列從接收器擷取的項目。更多...

(nullable GCKMediaQueueItem *)	- itemAtIndex:fetchIfNeeded:
	傳回佇列中特定索引的媒體佇列項目；如果目前不在快取中，則選擇性地安排從接收器擷取項目。更多...

(GCKMediaQueueItemID)	- itemIDAtIndex:
	傳回佇列中指定索引的項目項目 ID。更多...

(NSInteger)	- indexOfItemWithID:
	查詢佇列中佇列項目的索引。更多...

(void)	- reload
	重新載入佇列。更多...

(void)	- clear
	清除佇列，移除所有元素並清除快取。更多...

資源摘要
NSUInteger	itemCount
	佇列中目前的項目數量。更多...

NSUInteger	cacheSize
	快取大小。更多...

NSUInteger	cachedItemCount
	目前在快取中的佇列項目數量。更多...

方法詳細資料

- (instancetype) initWithRemoteMediaClient: (GCKRemoteMediaClient *) remoteMediaClient

使用預設快取大小和預設擷取數量上限來初始化新的 GCKMediaQueue。

- (instancetype) initWithRemoteMediaClient:	(GCKRemoteMediaClient *)	remoteMediaClient
cacheSize:	(NSUInteger)	cacheSize

使用指定的快取大小和預設擷取數量上限來初始化新的 GCKMediaQueue。

Parameters

cacheSize The cache size. Must be nonzero.

- (instancetype) initWithRemoteMediaClient:	(GCKRemoteMediaClient *)	remoteMediaClient
cacheSize:	(NSUInteger)	cacheSize
maxFetchCount:	(NSUInteger)	maxFetchCount

使用指定的快取大小和指定的擷取數量上限來初始化新的 GCKMediaQueue。

Parameters

cacheSize	The cache size. Must be nonzero.
maxFetchCount	The maxiumum fetch count with minimum being 1.

- (void) addDelegate: (id< GCKMediaQueueDelegate >) delegate

將委派作業新增至這個物件的委派清單。

Parameters

delegate The delegate to add. The delegate will be retained until removeDelegate: is called.

- (void) removeDelegate: (id< GCKMediaQueueDelegate >) delegate

從這個物件的委派清單移除委派對象。

Parameters

delegate The delegate to remove.

- (nullable GCKMediaQueueItem *) itemAtIndex: (NSUInteger) index

傳回佇列中特定索引的媒體佇列項目；如果目前不在快取中，則排列從接收器擷取的項目。

Parameters

index The index of the item to fetch.

傳回: 指定索引中的項目；如果項目目前不在快取中，但將以非同步方式擷取，則該項目為 nil。

- (nullable GCKMediaQueueItem *) itemAtIndex:	(NSUInteger)	index
fetchIfNeeded:	(BOOL)	fetch

傳回佇列中特定索引的媒體佇列項目；如果目前不在快取中，則選擇性地安排從接收器擷取項目。

Parameters

index	The index of the item to fetch.
fetch	Whether the item should be fetched from the receiver if it is not currently in the cache.

傳回: 指定索引的項目；如果項目目前不在快取中，則為 nil。

- (GCKMediaQueueItemID) itemIDAtIndex: (NSUInteger) index

傳回佇列中指定索引的項目項目 ID。

傳回: 指定索引的項目 ID；如果索引無效，則為 kGCKMediaQueueInvalidItemID。

- (NSInteger) indexOfItemWithID: (GCKMediaQueueItemID) itemID

查詢佇列中佇列項目的索引。

Parameters

itemID The queue item ID.

傳回: 佇列中項目的索引 (也就是基數位置)；如果佇列中沒有該項目，則為 NSNotFound。

- (void) reload

重新載入佇列。

系統會清除快取，並從接收者重新擷取項目 ID 清單。

- (void) clear

清除佇列，移除所有元素並清除快取。

資源詳情

- (NSUInteger) itemCount

readnonatomicassign

佇列中目前的項目數量。

- (NSUInteger) cacheSize

readnonatomicassign

快取大小。

- (NSUInteger) cachedItemCount

readnonatomicassign

目前在快取中的佇列項目數量。

GCKMediaQueue 類別

總覽

執行個體方法摘要

資源摘要

方法詳細資料

資源詳情