GCKMediaControlChannel 類別

GCKMediaControlChannel 類別參考資料

總覽

媒體控製作業的 GCKCastChannel 子類別。

任何適用於目前進行中串流 (播放、暫停、跳轉、停止等) 的作業都需要有效的媒體狀態 (也就是非空值),否則會傳回「kGCKInvalidRequestID」,且不會傳送要求。當頻道連線成功時,系統會自動要求媒體狀態,而且該請求會包含成功完成的重組,而且可隨時更新。媒體狀態也可能隨時為「零」,例如在頻道暫時中斷連線時。使用這個管道時,應透過 mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p) 回呼監控媒體狀態變更,且只有在非媒體狀態的情況下,才會呼叫對串流採取行動的方法。

如果要求成功啟動,相應的方法會傳回指派給該要求的要求 ID。如果要求無法啟動,這個方法會傳回 kGCKInvalidRequestID,並設定 lastError 屬性來表示失敗的原因。如果要求成功啟動但最終失敗,系統會叫用 mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) 回呼,以指出失敗。

如要瞭解委派通訊協定,請參閱 GCKMediaControlChannelDelegate

Deprecated:
使用 GCKCastSessionGCKRemoteMediaClient 屬性控制媒體播放。

其沿用 GCKCastChannel

執行個體方法摘要

(instancetype) - init
 指定初始化器。更多...
 
(NSInteger) - loadMedia:
 載入並開始播放新的媒體項目。更多...
 
(NSInteger) - loadMedia:autoplay:
 載入並可選擇開始播放新的媒體項目。更多...
 
(NSInteger) - loadMedia:autoplay:playPosition:
 載入並可選擇開始播放新的媒體項目。更多...
 
(NSInteger) - loadMedia:autoplay:playPosition:customData:
 載入並可選擇開始播放新的媒體項目。更多...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:
 載入並可選擇開始播放新的媒體項目。更多...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:customData:
 載入並可選擇開始播放新的媒體項目。更多...
 
(NSInteger) - setActiveTrackIDs:
 設定使用中的音軌。更多...
 
(NSInteger) - setTextTrackStyle:
 設定文字軌樣式。更多...
 
(NSInteger) - pause
 暫停播放目前媒體項目。更多...
 
(NSInteger) - pauseWithCustomData:
 暫停播放目前媒體項目。更多...
 
(NSInteger) - stop
 停止播放目前媒體項目。更多...
 
(NSInteger) - stopWithCustomData:
 停止播放目前媒體項目。更多...
 
(NSInteger) - play
 開始播放 (或繼續) 播放目前媒體項目。更多...
 
(NSInteger) - playWithCustomData:
 開始播放 (或繼續) 播放目前媒體項目。更多...
 
(NSInteger) - seekToTimeInterval:
 尋找目前媒體項目中的新位置。更多...
 
(NSInteger) - seekToTimeInterval:resumeState:
 尋找目前媒體項目中的新位置。更多...
 
(NSInteger) - seekToTimeInterval:resumeState:customData:
 尋找目前媒體項目中的新位置。更多...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:
 載入並選擇性地開始播放新媒體項目佇列。更多...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:customData:
 載入並選擇性地開始播放新媒體項目佇列。更多...
 
(NSInteger) - queueLoadItems:startIndex:playPosition:repeatMode:customData:
 載入並選擇性地開始播放新媒體項目佇列。更多...
 
(NSInteger) - queueInsertItems:beforeItemWithID:
 在佇列中插入新的媒體項目清單。更多...
 
(NSInteger) - queueInsertItems:beforeItemWithID:customData:
 在佇列中插入新的媒體項目清單。更多...
 
(NSInteger) - queueInsertItem:beforeItemWithID:
 將單一項目插入佇列的便利方法。更多...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:
 一種簡易方法,可將單一項目插入佇列中,使其成為目前項目。更多...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
 一種簡易方法,可將單一項目插入佇列中,使其成為目前項目。更多...
 
(NSInteger) - queueUpdateItems:
 更新佇列。更多...
 
(NSInteger) - queueUpdateItems:customData:
 更新佇列。更多...
 
(NSInteger) - queueRemoveItemsWithIDs:
 從佇列中移除媒體項目清單。更多...
 
(NSInteger) - queueRemoveItemsWithIDs:customData:
 從佇列中移除媒體項目清單。更多...
 
(NSInteger) - queueRemoveItemWithID:
 可移除佇列單一項目的便利方法。更多...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:
 重新排序佇列中的媒體項目清單。更多...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
 重新排序佇列中的媒體項目清單。更多...
 
(NSInteger) - queueMoveItemWithID:beforeItemWithID:
 方便在佇列中移動單一項目的便利方法。更多...
 
(NSInteger) - queueJumpToItemWithID:
 跳至佇列中具有指定 ID 的項目。更多...
 
(NSInteger) - queueJumpToItemWithID:customData:
 跳至佇列中具有指定 ID 的項目。更多...
 
(NSInteger) - queueJumpToItemWithID:playPosition:customData:
 跳至佇列中具有指定 ID 的項目。更多...
 
(NSInteger) - queueNextItem
 移至佇列中的下一個項目。更多...
 
(NSInteger) - queuePreviousItem
 移至佇列中的上一個項目。更多...
 
(NSInteger) - queueSetRepeatMode:
 設定佇列的重複模式。更多...
 
(NSInteger) - setStreamVolume:
 設定串流音量。更多...
 
(NSInteger) - setStreamVolume:customData:
 設定串流音量。更多...
 
(NSInteger) - setStreamMuted:
 設定是否忽略串流。更多...
 
(NSInteger) - setStreamMuted:customData:
 設定是否忽略串流。更多...
 
(NSInteger) - requestStatus
 向接收端要求更新媒體狀態資訊。更多...
 
(NSTimeInterval) - approximateStreamPosition
 傳回從上一次接收的串流資訊和系統更新後經過的間隔時間計算而得的約略串流位置。更多...
 
(BOOL) - cancelRequestWithID:
 取消進行中的要求。更多...
 
(instancetype) - initWithNamespace:
 指定初始化器。更多...
 
(void) - didReceiveTextMessage:
 收到這個頻道的簡訊時呼叫。更多...
 
(BOOL) - sendTextMessage:
 在這個頻道傳送訊息。更多...
 
(BOOL) - sendTextMessage:error:
 在這個頻道傳送訊息。更多...
 
(NSInteger) - generateRequestID
 產生新訊息的要求 ID。更多...
 
(NSNumber *__nullable) - generateRequestNumber
 generateRequestID 的結果納入 NSNumber 的便利方法。更多...
 
(void) - didConnect
 連上這個通道後呼叫,表示現在可以透過此管道與 Cast 裝置交換訊息。更多...
 
(void) - didDisconnect
 在這個管道中斷連線後傳送,表示訊息無法再透過此管道與 Cast 裝置交換。更多...
 

屬性摘要

GCKMediaStatusmediaStatus
 目前載入媒體的媒體狀態 (如果有的話);否則為 nil更多...
 
NSTimeInterval timeSinceLastMediaStatusUpdate
 上次收到媒體狀態更新後經過的時間。更多...
 
GCKErrorlastError
 最後一個要求的錯誤詳細資料 (如果有的話);如果要求成功,則傳回 nil更多...
 
id< GCKMediaControlChannelDelegatedelegate
 接收頻道狀態變更通知的委任。更多...
 
NSString * protocolNamespace
 頻道的命名空間。更多...
 
BOOL isConnected
 此標記指出此頻道是否已連結。更多...
 
GCKDeviceManagerdeviceManager
 註冊這個頻道的裝置管理員 (如果有的話)。更多...
 

方法說明

- (instancetype) init

指定初始化器。

實作 GCKCastChannel

- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo

載入並開始播放新的媒體項目。

Parameters
mediaInfoAn object describing the media item to load.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay 

載入並可選擇開始播放新的媒體項目。

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition 

載入並可選擇開始播放新的媒體項目。

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

載入並可選擇開始播放新的媒體項目。

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs 

載入並可選擇開始播放新的媒體項目。

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn array of integers specifying the active tracks. May be nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  customData 

載入並可選擇開始播放新的媒體項目。

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn array of integers specifying the active tracks. May be nil.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs

設定使用中的音軌。

如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
activeTrackIDsAn array of integers specifying the active tracks.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID。可能是 nil 或空白陣列,將使用中的音軌設為空白清單。
- (NSInteger) setTextTrackStyle: (GCKMediaTextTrackStyle *__nullable)  textTrackStyle

設定文字軌樣式。

如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) pause

暫停播放目前媒體項目。

如果沒有任何目前的媒體狀態,請求就會失敗。

傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) pauseWithCustomData: (id __nullable)  customData

暫停播放目前媒體項目。

如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) stop

停止播放目前媒體項目。

如果沒有任何目前的媒體狀態,請求就會失敗。如果目前載入的是佇列,則會遭到移除。

傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) stopWithCustomData: (id __nullable)  customData

停止播放目前媒體項目。

如果沒有任何目前的媒體狀態,請求就會失敗。如果目前載入的是佇列,則會遭到移除。

Parameters
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) play

開始播放 (或繼續) 播放目前媒體項目。

串流一次一律會開始播放。如果沒有任何目前的媒體狀態,請求就會失敗。

傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) playWithCustomData: (id __nullable)  customData

開始播放 (或繼續) 播放目前媒體項目。

串流一次一律會開始播放。如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position

尋找目前媒體項目中的新位置。

如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
positionThe new position from the beginning of the stream.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState 

尋找目前媒體項目中的新位置。

如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
positionThe new position interval from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState
customData: (id __nullable)  customData 

尋找目前媒體項目中的新位置。

如果沒有任何目前的媒體狀態,請求就會失敗。

Parameters
positionThe new position from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode 

載入並選擇性地開始播放新媒體項目佇列。

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

載入並選擇性地開始播放新媒體項目佇列。

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
playPosition: (NSTimeInterval)  playPosition
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

載入並選擇性地開始播放新媒體項目佇列。

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
playPositionThe initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
repeatModeThe repeat mode for playing the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID 

在佇列中插入新的媒體項目清單。

Parameters
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDThe ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID
customData: (id __nullable)  customData 

在佇列中插入新的媒體項目清單。

Parameters
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueInsertItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

將單一項目插入佇列的便利方法。

Parameters
itemThe item to insert.
beforeItemIDThe ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

一種簡易方法,可將單一項目插入佇列中,使其成為目前項目。

Parameters
itemThe item to insert.
beforeItemIDThe ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

一種簡易方法,可將單一項目插入佇列中,使其成為目前項目。

Parameters
itemThe item to insert.
beforeItemIDThe ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
playPositionThe initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems

更新佇列。

Parameters
queueItemsThe list of updated items.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
customData: (id __nullable)  customData 

更新佇列。

Parameters
queueItemsThe list of updated items.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

從佇列中移除媒體項目清單。

如果佇列中沒有任何內容,目前的媒體工作階段就會終止。

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs
customData: (id __nullable)  customData 

從佇列中移除媒體項目清單。

如果佇列中沒有任何內容,目前的媒體工作階段就會終止。

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueRemoveItemWithID: (NSUInteger)  itemID

可移除佇列單一項目的便利方法。

Parameters
itemIDThe ID of the item to remove.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID 

重新排序佇列中的媒體項目清單。

Parameters
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be appended at the end of the queue.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID
customData: (id __nullable)  customData 

重新排序佇列中的媒體項目清單。

Parameters
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDThe ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be moved to the end of the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueMoveItemWithID: (NSUInteger)  itemID
beforeItemWithID: (NSUInteger)  beforeItemID 

方便在佇列中移動單一項目的便利方法。

Parameters
itemIDThe ID of the item to move.
beforeItemIDThe ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the item will be moved to the end of the queue.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID

跳至佇列中具有指定 ID 的項目。

Parameters
itemIDThe ID of the item to jump to.
傳回
這個要求的請求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
customData: (id __nullable)  customData 

跳至佇列中具有指定 ID 的項目。

Parameters
itemIDThe ID of the item to jump to.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

跳至佇列中具有指定 ID 的項目。

Parameters
itemIDThe ID of the item to jump to.
playPositionThe initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
這個要求的請求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) queueNextItem

移至佇列中的下一個項目。

傳回
這個要求的請求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) queuePreviousItem

移至佇列中的上一個項目。

傳回
這個要求的請求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode repeatMode

設定佇列的重複模式。

Parameters
repeatModeThe new repeat mode.
傳回
這個要求的請求 ID;如果訊息無法傳送,或有任何參數無效,則為 kGCKInvalidRequestID
- (NSInteger) setStreamVolume: (float)  volume

設定串流音量。

如果沒有目前的媒體工作階段,要求會失敗。

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) setStreamVolume: (float)  volume
customData: (id __nullable)  customData 

設定串流音量。

如果沒有目前的媒體工作階段,要求會失敗。

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) setStreamMuted: (BOOL)  muted

設定是否忽略串流。

如果沒有目前的媒體工作階段,要求會失敗。

Parameters
mutedWhether the stream should be muted or unmuted.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) setStreamMuted: (BOOL)  muted
customData: (id __nullable)  customData 

設定是否忽略串流。

如果沒有目前的媒體工作階段,要求會失敗。

Parameters
mutedWhether the stream should be muted or unmuted.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSInteger) requestStatus

向接收端要求更新媒體狀態資訊。

傳回
要求 ID;如果無法傳送訊息,則為 kGCKInvalidRequestID
- (NSTimeInterval) approximateStreamPosition

傳回從上一次接收的串流資訊和系統更新後經過的間隔時間計算而得的約略串流位置。

如果頻道未連線或目前未載入任何媒體,則傳回 0。

- (BOOL) cancelRequestWithID: (NSInteger)  requestID

取消進行中的要求。

取消要求並不會阻止系統執行要求,只是表示呼叫應用程式已不再對要求結果感興趣,因此將清除與要求追蹤相關的任何狀態。

Parameters
requestIDThe ID of the request to cancel.
傳回
:如果要求已取消,則傳回 YES;如果沒有使用指定 ID 追蹤要求,則為 NO
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

指定初始化器。

使用指定的命名空間建構新的 GCKCastChannel

Parameters
protocolNamespaceThe namespace.

已在 GCKGenericChannel 中實作。

- (void) didReceiveTextMessage: (NSString *)  message

收到這個頻道的簡訊時呼叫。

預設實作為免人工管理。

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

在這個頻道傳送訊息。

Parameters
messageThe message.
傳回
YES 代表成功,如果無法傳送訊息,則為 NO (因為頻道未連線,或是傳送緩衝區過短)。
Deprecated:
使用 sendTextMessage:error:,提供詳細的錯誤資訊。
- (BOOL) sendTextMessage: (NSString *)  message
error: (GCKError *__nullable *__nullable)  error 

在這個頻道傳送訊息。

Parameters
messageThe message.
errorA pointer at which to store the error result. May be nil.
傳回
YES:成功。如果無法傳送訊息,請NO
- (NSInteger) generateRequestID

產生新訊息的要求 ID。

傳回
產生的 ID;如果目前未連結頻道,則為 kGCKInvalidRequestID
- (NSNumber * __nullable) generateRequestNumber

generateRequestID 的結果納入 NSNumber 的便利方法。

傳回
產生的 ID;如果目前未連結頻道,則為 nil
- (void) didConnect

連上這個通道後呼叫,表示現在可以透過此管道與 Cast 裝置交換訊息。

預設實作為免人工管理。

- (void) didDisconnect

在這個管道中斷連線後傳送,表示訊息無法再透過此管道與 Cast 裝置交換。

預設實作為免人工管理。

資源詳細資料

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

目前載入媒體的媒體狀態 (如果有的話);否則為 nil

- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

上次收到媒體狀態更新後經過的時間。

如果目前正在處理某項狀態要求,這會顯示為 0。

- (GCKError*) lastError
readnonatomiccopy

最後一個要求的錯誤詳細資料 (如果有的話);如果要求成功,則傳回 nil

- (id<GCKMediaControlChannelDelegate>) delegate
readwritenonatomicweak

接收頻道狀態變更通知的委任。

- (NSString*) protocolNamespace
readnonatomiccopyinherited

頻道的命名空間。

- (BOOL) isConnected
readnonatomicassigninherited

此標記指出此頻道是否已連結。

- (GCKDeviceManager*) deviceManager
readnonatomicweakinherited

註冊這個頻道的裝置管理員 (如果有的話)。

Deprecated:
如果這個管道並未註冊已淘汰的 GCKDeviceManager 類別,就會是 nil