<GCKMediaQueue 委派> 通訊協定(&T)
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
接收 GCKMediaQueue 非同步通知的委派通訊協定。
- 開始時間
- 4.3.4
繼承 <NSObjectNSObject>。
有一或多項變更即將排入佇列時呼叫。
- Parameters
-
在佇列完全重新載入時呼叫。
請將先前存取的任何佇列項目視為無效。
- Parameters
-
| - (void) mediaQueue: |
|
(GCKMediaQueue *) |
queue |
| didInsertItemsInRange: |
|
(NSRange) |
range |
|
|
| |
|
optional |
在連續範圍的佇列項目插入佇列時呼叫。
- Parameters
-
| queue | The queue. |
| range | The range indicating the starting index and count of items inserted. |
| - (void) mediaQueue: |
|
(GCKMediaQueue *) |
queue |
| didUpdateItemsAtIndexes: |
|
(NSArray< NSNumber * > *) |
indexes |
|
|
| |
|
optional |
當佇列中的一或多個佇列項目有所更新時，會呼叫此方法。
這包括先前存取但無法使用但無法存取的項目已擷取到快取中，以及從快取中清除先前快取項目的情況。
- Parameters
-
| queue | The queue. |
| indexes | The ordered list of indexes of the items that have been updated. |
| - (void) mediaQueue: |
|
(GCKMediaQueue *) |
queue |
| didRemoveItemsAtIndexes: |
|
(NSArray< NSNumber * > *) |
indexes |
|
|
| |
|
optional |
當一或多個佇列項目從佇列中移除時，會呼叫此方法。
- Parameters
-
| queue | The queue. |
| indexes | The ordered list of indexes of the items that have been removed. |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003eGCKMediaQueueDelegate\u003c/code\u003e protocol enables receiving asynchronous notifications from a \u003ccode\u003eGCKMediaQueue\u003c/code\u003e, informing about changes like insertions, removals, and updates.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to handle queue changes, including \u003ccode\u003emediaQueueWillChange:\u003c/code\u003e, \u003ccode\u003emediaQueueDidReloadItems:\u003c/code\u003e, \u003ccode\u003emediaQueue:didInsertItemsInRange:\u003c/code\u003e, \u003ccode\u003emediaQueue:didUpdateItemsAtIndexes:\u003c/code\u003e, \u003ccode\u003emediaQueue:didRemoveItemsAtIndexes:\u003c/code\u003e, and \u003ccode\u003emediaQueueDidChange:\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThese methods are optional and offer insights into queue modifications, such as when items are added, updated, or removed, or when the entire queue is reloaded.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can implement these methods to respond to queue events and update their application's state accordingly, ensuring synchronization with the media queue.\u003c/p\u003e\n"]]],["The `GCKMediaQueueDelegate` protocol provides methods for asynchronous notifications about changes to a media queue. Key actions include: notifying when changes are imminent (`mediaQueueWillChange:`), when the queue is reloaded (`mediaQueueDidReloadItems:`), when items are inserted (`mediaQueue:didInsertItemsInRange:`), updated (`mediaQueue:didUpdateItemsAtIndexes:`), or removed (`mediaQueue:didRemoveItemsAtIndexes:`), and when changes are completed (`mediaQueueDidChange:`). Each method provides the affected queue and relevant details like ranges or indexes.\n"],null,["# <GCKMediaQueueDelegate> Protocol\n\n[Instance Methods](#pub-methods) \n\\\u003cGCKMediaQueueDelegate\\\u003e Protocol Reference \n\nOverview\n--------\n\nThe delegate protocol for receiving asynchronous notifications from a [GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue \"A data model representation of a media queue of arbitrary length. \").\n\nSince\n: 4.3.4\n\nInherits \\\u003cNSObjectNSObject\\\u003e.\n\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Instance Method Summary ----------------------- ||\n| (void) | - [mediaQueueWillChange:](/cast/docs/reference/ios/protocol_g_c_k_media_queue_delegate-p#a67d1e8d507009c2358055878f0734beb) |\n| | Called when one or more changes are about to be made to the queue. [More...](#a67d1e8d507009c2358055878f0734beb) |\n| ||\n| (void) | - [mediaQueueDidReloadItems:](/cast/docs/reference/ios/protocol_g_c_k_media_queue_delegate-p#a47da208fd18f9c9e8d77b9b9820008e0) |\n| | Called when the queue has been entirely reloaded. [More...](#a47da208fd18f9c9e8d77b9b9820008e0) |\n| ||\n| (void) | - [mediaQueue:didInsertItemsInRange:](/cast/docs/reference/ios/protocol_g_c_k_media_queue_delegate-p#a999c9cff6813cc3e3217b56783d9923f) |\n| | Called when a contiguous range of queue items ahve been inserted into the queue. [More...](#a999c9cff6813cc3e3217b56783d9923f) |\n| ||\n| (void) | - [mediaQueue:didUpdateItemsAtIndexes:](/cast/docs/reference/ios/protocol_g_c_k_media_queue_delegate-p#a1b1e5914235108690d76c49d2c12fab3) |\n| | Called when one or more queue items have been updated in the queue. [More...](#a1b1e5914235108690d76c49d2c12fab3) |\n| ||\n| (void) | - [mediaQueue:didRemoveItemsAtIndexes:](/cast/docs/reference/ios/protocol_g_c_k_media_queue_delegate-p#ae1d7987e73d3adbbc87efb1115775e88) |\n| | Called when one or more queue items have been removed from the queue. [More...](#ae1d7987e73d3adbbc87efb1115775e88) |\n| ||\n| (void) | - [mediaQueueDidChange:](/cast/docs/reference/ios/protocol_g_c_k_media_queue_delegate-p#a167626bc840e79933b16480962362e1c) |\n| | Called after one or more queue changes have been made to the queue. [More...](#a167626bc840e79933b16480962362e1c) |\n| ||\n\nMethod Detail\n-------------\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| |--------------------------------|---|----------------------------------------------------------------------------|---------|---| | - (void) mediaQueueWillChange: | | ([GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue) \\*) | *queue* | | | optional |\n\nCalled when one or more changes are about to be made to the queue.\n\nParameters\n:\n\n |-------|------------|\n | queue | The queue. |\n\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| |------------------------------------|---|----------------------------------------------------------------------------|---------|---| | - (void) mediaQueueDidReloadItems: | | ([GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue) \\*) | *queue* | | | optional |\n\nCalled when the queue has been entirely reloaded.\n\nAny previously accessed queue items should be considered invalid.\n\nParameters\n:\n\n |-------|------------|\n | queue | The queue. |\n\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| |------------------------|---|----------------------------------------------------------------------------|---------| | - (void) mediaQueue: | | ([GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue) \\*) | *queue* | | didInsertItemsInRange: | | (NSRange) | *range* | | | | | | | optional |\n\nCalled when a contiguous range of queue items ahve been inserted into the queue.\n\nParameters\n:\n\n |-------|----------------------------------------------------------------------|\n | queue | The queue. |\n | range | The range indicating the starting index and count of items inserted. |\n\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| |--------------------------|---|----------------------------------------------------------------------------|-----------| | - (void) mediaQueue: | | ([GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue) \\*) | *queue* | | didUpdateItemsAtIndexes: | | (NSArray\\\u003c NSNumber \\* \\\u003e \\*) | *indexes* | | | | | | | optional |\n\nCalled when one or more queue items have been updated in the queue.\n\nThis includes the case where previously accessed but unavailable items have been retrieved and placed in the cache, and the case where previously cached items have been flushed from the cache.\n\nParameters\n:\n\n |---------|------------------------------------------------------------------|\n | queue | The queue. |\n | indexes | The ordered list of indexes of the items that have been updated. |\n\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| |--------------------------|---|----------------------------------------------------------------------------|-----------| | - (void) mediaQueue: | | ([GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue) \\*) | *queue* | | didRemoveItemsAtIndexes: | | (NSArray\\\u003c NSNumber \\* \\\u003e \\*) | *indexes* | | | | | | | optional |\n\nCalled when one or more queue items have been removed from the queue.\n\nParameters\n:\n\n |---------|------------------------------------------------------------------|\n | queue | The queue. |\n | indexes | The ordered list of indexes of the items that have been removed. |\n\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| |-------------------------------|---|----------------------------------------------------------------------------|---------|---| | - (void) mediaQueueDidChange: | | ([GCKMediaQueue](/cast/docs/reference/ios/interface_g_c_k_media_queue) \\*) | *queue* | | | optional |\n\nCalled after one or more queue changes have been made to the queue."]]
