GCKRemoteMediaClient 類別

GCKRemoteMediaClient 類別參考資料

總覽

用於控制投放接收端媒體播放作業的類別。

這個物件的例項可做為 GCKSession::remoteMediaClient 屬性使用。

開始時間
3.0

繼承 NSObject。

執行個體方法摘要

(void) - addListener:
 將事件監聽器新增至此物件的事件監聽器清單。更多...
 
(void) - removeListener:
 從此物件的事件監聽器清單中移除事件監聽器。更多...
 
(GCKRequest *) - loadMediaWithLoadRequestData:
 載入及開始播放含有要求資料的媒體項目或媒體項目佇列。更多...
 
(GCKRequest *) - loadMedia:
 使用預設選項載入及開始播放新媒體項目。更多...
 
(GCKRequest *) - loadMedia:withOptions:
 使用指定選項載入及開始播放新媒體項目。更多...
 
(GCKRequest *) - loadMedia:autoplay:
 載入及選擇性開始播放新的媒體項目。更多...
 
(GCKRequest *) - loadMedia:autoplay:playPosition:
 載入及選擇性開始播放新的媒體項目。更多...
 
(GCKRequest *) - loadMedia:autoplay:playPosition:customData:
 載入及選擇性開始播放新的媒體項目。更多...
 
(GCKRequest *) - loadMedia:autoplay:playPosition:activeTrackIDs:
 載入及選擇性開始播放新的媒體項目。更多...
 
(GCKRequest *) - loadMedia:autoplay:playPosition:activeTrackIDs:customData:
 載入及選擇性開始播放新的媒體項目。更多...
 
(GCKRequest *) - setPlaybackRate:
 設定目前媒體工作階段的播放速率。更多...
 
(GCKRequest *) - setPlaybackRate:customData:
 設定目前媒體工作階段的播放速率。更多...
 
(GCKRequest *) - setActiveTrackIDs:
 設定使用中的測試群組。更多...
 
(GCKRequest *) - setTextTrackStyle:
 設定文字追蹤樣式。更多...
 
(GCKRequest *) - pause
 暫停播放目前媒體項目。更多...
 
(GCKRequest *) - pauseWithCustomData:
 暫停播放目前媒體項目。更多...
 
(GCKRequest *) - stop
 停止播放目前媒體項目。更多...
 
(GCKRequest *) - stopWithCustomData:
 停止播放目前媒體項目。更多...
 
(GCKRequest *) - play
 開始 (或繼續) 播放目前媒體項目。更多...
 
(GCKRequest *) - playWithCustomData:
 開始 (或繼續) 播放目前媒體項目。更多...
 
(GCKRequest *) - skipAd
 傳送要略過廣告的請求。更多...
 
(GCKRequest *) - seekWithOptions:
 跳轉至目前媒體項目中的新位置。更多...
 
(GCKRequest *) - seekToTimeInterval:
 跳轉至目前媒體項目中的新位置。更多...
 
(GCKRequest *) - seekToTimeInterval:resumeState:
 跳轉至目前媒體項目中的新位置。更多...
 
(GCKRequest *) - seekToTimeInterval:resumeState:customData:
 跳轉至目前媒體項目中的新位置。更多...
 
(GCKRequest *) - queueFetchItemIDs
 要求佇列的項目 ID 清單。更多...
 
(GCKRequest *) - queueFetchItemsForIDs:
 要求具有指定項目 ID 的佇列項目完整資訊。更多...
 
(GCKRequest *) - queueLoadItems:startIndex:repeatMode:
 載入及選擇性開始播放新的媒體項目佇列。更多...
 
(GCKRequest *) - queueLoadItems:startIndex:repeatMode:customData:
 載入及選擇性開始播放新的媒體項目佇列。更多...
 
(GCKRequest *) - queueLoadItems:startIndex:playPosition:repeatMode:customData:
 載入及選擇性開始播放新的媒體項目佇列。更多...
 
(GCKRequest *) - queueLoadItems:withOptions:
 載入及選擇性開始播放新的媒體項目佇列。更多...
 
(GCKRequest *) - queueInsertItems:beforeItemWithID:
 將新媒體項目清單插入佇列。更多...
 
(GCKRequest *) - queueInsertItems:beforeItemWithID:customData:
 將新媒體項目清單插入佇列。更多...
 
(GCKRequest *) - queueInsertItem:beforeItemWithID:
 將單一項目插入佇列的便利方法。更多...
 
(GCKRequest *) - queueInsertAndPlayItem:beforeItemWithID:
 便利的方法,可將單一項目插入佇列,並將其設為目前項目。更多...
 
(GCKRequest *) - queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
 便利的方法,可將單一項目插入佇列,並將其設為目前項目。更多...
 
(GCKRequest *) - queueUpdateItems:
 更新佇列。更多...
 
(GCKRequest *) - queueUpdateItems:customData:
 更新佇列。更多...
 
(GCKRequest *) - queueRemoveItemsWithIDs:
 從佇列中移除媒體項目清單。更多...
 
(GCKRequest *) - queueRemoveItemsWithIDs:customData:
 從佇列中移除媒體項目清單。更多...
 
(GCKRequest *) - queueRemoveItemWithID:
 可輕鬆從佇列中移除單一項目的方法。更多...
 
(GCKRequest *) - queueReorderItemsWithIDs:insertBeforeItemWithID:
 重新排序佇列中的媒體項目清單。更多...
 
(GCKRequest *) - queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
 重新排序佇列中的媒體項目清單。更多...
 
(GCKRequest *) - queueMoveItemWithID:beforeItemWithID:
 可移動佇列中的單一項目簡易的方法。更多...
 
(GCKRequest *) - queueJumpToItemWithID:
 跳到佇列中具有指定 ID 的項目。更多...
 
(GCKRequest *) - queueJumpToItemWithID:customData:
 跳到佇列中具有指定 ID 的項目。更多...
 
(GCKRequest *) - queueJumpToItemWithID:playPosition:customData:
 跳到佇列中具有指定 ID 的項目。更多...
 
(GCKRequest *) - queueNextItem
 移至佇列中的下一個項目。更多...
 
(GCKRequest *) - queuePreviousItem
 移至佇列中的上一個項目。更多...
 
(GCKRequest *) - queueSetRepeatMode:
 設定佇列重複模式。更多...
 
(GCKRequest *) - setStreamVolume:
 設定串流音量。更多...
 
(GCKRequest *) - setStreamVolume:customData:
 設定串流音量。更多...
 
(GCKRequest *) - setStreamMuted:
 設定是否將直播設為靜音。更多...
 
(GCKRequest *) - setStreamMuted:customData:
 設定是否將直播設為靜音。更多...
 
(GCKRequest *) - requestStatus
 要求接收者提供最新的媒體狀態資訊。更多...
 
(NSTimeInterval) - approximateStreamPosition
 傳回概略的串流位置,計算依據為最近一次接收的串流資訊,以及更新後經過的實際時間。更多...
 
(NSTimeInterval) - approximateLiveSeekableRangeStart
 傳回可搜尋範圍的概略起始位置,計算依據為最近一次收到的串流資訊,以及自該更新起經過的實際時間。更多...
 
(NSTimeInterval) - approximateLiveSeekableRangeEnd
 根據上次收到的串流資訊,以及自該更新起經過的實際時間,傳回可搜尋範圍的約略結束位置。更多...
 
(void) - notifyDidStartMediaSession
 每當媒體工作階段開始時,再由子類別呼叫,也就是在遠端播放器成功載入新媒體之後。更多...
 
(void) - notifyDidUpdateMediaStatus
 當用戶端的 mediaStatus 物件變更時,由子類別呼叫。更多...
 
(void) - notifyDidUpdateQueue
 當用戶端管理的媒體佇列有所變更時,子類別即可呼叫該類別。更多...
 
(void) - notifyDidUpdatePreloadStatus
 當用戶端 GCKMediaStatusGCKMediaStatus::preloadedItemID 變更時,子類別就呼叫了子類別。更多...
 
(void) - notifyDidUpdateMetadata
 每當中繼資料變更時,再由子類別呼叫。更多...
 
(void) - notifyDidReceiveQueueItemIDs:
 每當收到媒體佇列項目 ID 清單時,再由子類別呼叫。更多...
 
(void) - notifyDidInsertQueueItemsWithIDs:beforeItemWithID:
 在佇列中插入連續的佇列項目序列時,可由子類別呼叫。更多...
 
(void) - notifyDidUpdateQueueItemsWithIDs:
 每當佇列中現有的佇列項目更新時,再由子類別呼叫。更多...
 
(void) - notifyDidRemoveQueueItemsWithIDs:
 每當從佇列中移除連續的佇列項目序列時,再由子類別呼叫。更多...
 
(void) - notifyDidReceiveQueueItems:
 在收到佇列項目時由子類別呼叫。更多...
 

資源摘要

BOOL connected
 指出此物件是否已連線至工作階段的旗標。更多...
 
GCKMediaStatusmediaStatus
 目前的媒體狀態 (由媒體控制管道回報)。更多...
 
GCKMediaQueuemediaQueue
 媒體待播清單。更多...
 
NSTimeInterval timeSinceLastMediaStatusUpdate
 自上次收到媒體狀態更新後經過的時間。更多...
 
BOOL playingLiveStream
 以標記表示用戶端是否正在播放直播。更多...
 
id
< GCKRemoteMediaClientAdInfoParserDelegate
adInfoParserDelegate
 委派項目可從 GCKMediaStatus 物件中的自訂資料擷取廣告插播資訊。更多...
 

方法詳細資料

- (void) addListener: (id< GCKRemoteMediaClientListener >)  listener

將事件監聽器新增至此物件的事件監聽器清單。

新增的事件監聽器未妥善保留,應保留,以免發生意外交易。

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKRemoteMediaClientListener >)  listener

從此物件的事件監聽器清單中移除事件監聽器。

Parameters
listenerThe listener to remove.
- (GCKRequest *) loadMediaWithLoadRequestData: (GCKMediaLoadRequestData *)  requestData

載入及開始播放含有要求資料的媒體項目或媒體項目佇列。

Parameters
requestDataDescribes the media load request.
傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.4.1
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo

使用預設選項載入及開始播放新媒體項目。

建議您改用 loadMediaWithLoadRequestData:,這是支援載入單一項目的進階載入指令,或含有其他選項的佇列。

Parameters
mediaInfoDescribes the media item to load.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo
withOptions: (GCKMediaLoadOptions *)  options 

使用指定選項載入及開始播放新媒體項目。

建議您改用 loadMediaWithLoadRequestData:,這是支援載入單一項目的進階載入指令,或含有其他選項的佇列。

Parameters
mediaInfoDescribes the media item to load.
optionsThe load options for this request.
傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.0
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay 

載入及選擇性開始播放新的媒體項目。

Parameters
mediaInfoDescribes the media item to load.
autoplayWhether playback should start immediately.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition 

載入及選擇性開始播放新的媒體項目。

Parameters
mediaInfoDescribes the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
customData: (nullable id)  customData 

載入及選擇性開始播放新的媒體項目。

Parameters
mediaInfoDescribes 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs 

載入及選擇性開始播放新的媒體項目。

Parameters
mediaInfoDescribes 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

載入及選擇性開始播放新的媒體項目。

Parameters
mediaInfoDescribes 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) setPlaybackRate: (float)  playbackRate

設定目前媒體工作階段的播放速率。

Parameters
playbackRateThe new playback rate.
傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.0
- (GCKRequest *) setPlaybackRate: (float)  playbackRate
customData: (nullable id)  customData 

設定目前媒體工作階段的播放速率。

Parameters
playbackRateThe new playback rate, which must be between GCKMediaLoadOptions::kGCKMediaMinPlaybackRate and GCKMediaLoadOptions::kGCKMediaMaxPlaybackRate.
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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.0
- (GCKRequest *) setActiveTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs

設定使用中的測試群組。

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

Parameters
activeTrackIDsAn array of integers specifying the active tracks. May be empty or nil to disable any currently active tracks.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) setTextTrackStyle: (nullable GCKMediaTextTrackStyle *)  textTrackStyle

設定文字追蹤樣式。

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

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) pause

暫停播放目前媒體項目。

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

傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) pauseWithCustomData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) stop

停止播放目前媒體項目。

如果目前已載入佇列,系統會將其移除。如果沒有目前的媒體狀態,要求就會失敗。

傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) stopWithCustomData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) play

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

一律會從直播開始時開始播放。如果沒有目前的媒體狀態,要求就會失敗。

傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) playWithCustomData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) skipAd

傳送要略過廣告的請求。

傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.3
- (GCKRequest *) seekWithOptions: (GCKMediaSeekOptions *)  options

跳轉至目前媒體項目中的新位置。

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

Parameters
optionsThe seek options for the request.
傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.0
- (GCKRequest *) seekToTimeInterval: (NSTimeInterval)  position

跳轉至目前媒體項目中的新位置。

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

Parameters
positionThe new position from the beginning of the stream.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 SeeWithOptions:
- (GCKRequest *) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaResumeState)  resumeState 

跳轉至目前媒體項目中的新位置。

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

Parameters
positionThe new position interval from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 SeeWithOptions:
- (GCKRequest *) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaResumeState)  resumeState
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 SeeWithOptions:
- (GCKRequest *) queueFetchItemIDs

要求佇列的項目 ID 清單。

結果會傳遞至委派回呼 GCKRemoteMediaClient 委派::remoteMediaClient:didReceiveQueueItemIDs:.

傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.1
- (GCKRequest *) queueFetchItemsForIDs: (NSArray< NSNumber * > *)  queueItemIDs

要求具有指定項目 ID 的佇列項目完整資訊。

結果會傳遞至委派回呼 GCKRemoteMediaClient 委派::remoteMediaClient:didReceiveQueueItems:.

傳回
用於追蹤這項要求的 GCKRequest 物件。
開始時間
4.1
- (GCKRequest *) 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
playPosition: (NSTimeInterval)  playPosition
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
Deprecated:
使用 loadMediaWithLoadRequestData:.
- (GCKRequest *) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
withOptions: (GCKMediaQueueLoadOptions *)  options 

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

建議您改用 loadMediaWithLoadRequestData:,這是支援載入單一項目的進階載入指令,或含有其他選項的佇列。

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
optionsThe load options used to load the queue items, as defined by GCKMediaQueueLoadOptions
開始時間
4.3.1
- (GCKRequest *) 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID
playPosition: (NSTimeInterval)  playPosition
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems

更新佇列。

Parameters
queueItemsThe list of updated items.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

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

如果佇列因此變為空白,系統就會終止目前的媒體工作階段。

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueRemoveItemWithID: (NSUInteger)  itemID

可輕鬆從佇列中移除單一項目的方法。

Parameters
itemIDThe ID of the item to remove.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) 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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueJumpToItemWithID: (NSUInteger)  itemID

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

Parameters
itemIDThe ID of the item to jump to.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueJumpToItemWithID: (NSUInteger)  itemID
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueJumpToItemWithID: (NSUInteger)  itemID
playPosition: (NSTimeInterval)  playPosition
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueNextItem

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

傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queuePreviousItem

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

傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) queueSetRepeatMode: (GCKMediaRepeatMode repeatMode

設定佇列重複模式。

Parameters
repeatModeThe new repeat mode.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) setStreamVolume: (float)  volume

設定串流音量。

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

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) setStreamVolume: (float)  volume
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) setStreamMuted: (BOOL)  muted

設定是否將直播設為靜音。

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

Parameters
mutedWhether the stream should be muted or unmuted.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) setStreamMuted: (BOOL)  muted
customData: (nullable id)  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.
傳回
用於追蹤這項要求的 GCKRequest 物件。
- (GCKRequest *) requestStatus

要求接收者提供最新的媒體狀態資訊。

傳回
用於追蹤這項要求的 GCKRequest 物件。
- (NSTimeInterval) approximateStreamPosition

傳回概略的串流位置,計算依據為最近一次接收的串流資訊,以及更新後經過的實際時間。

如果頻道未連結,或目前未載入任何媒體,系統會傳回 0。

- (NSTimeInterval) approximateLiveSeekableRangeStart

傳回可搜尋範圍的概略起始位置,計算依據為最近一次收到的串流資訊,以及自該更新起經過的實際時間。

如果頻道未連結,或目前未載入任何媒體,系統會傳回 0。如果串流並非直播,或沒有可搜尋的範圍,系統會傳回 kGCKInvalidTimeInterval

開始時間
4.4.1
- (NSTimeInterval) approximateLiveSeekableRangeEnd

根據上次收到的串流資訊,以及自該更新起經過的實際時間,傳回可搜尋範圍的約略結束位置。

如果頻道未連結,或目前未載入任何媒體,系統會傳回 0。如果串流並非直播,或沒有可搜尋的範圍,系統會傳回 kGCKInvalidTimeInterval

開始時間
4.4.1
- (void) notifyDidStartMediaSession

每當媒體工作階段開始時,再由子類別呼叫,也就是在遠端播放器成功載入新媒體之後。

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidUpdateMediaStatus

當用戶端的 mediaStatus 物件變更時,由子類別呼叫。

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidUpdateQueue

當用戶端管理的媒體佇列有所變更時,子類別即可呼叫該類別。

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidUpdatePreloadStatus

當用戶端 GCKMediaStatusGCKMediaStatus::preloadedItemID 變更時,子類別就呼叫了子類別。

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidUpdateMetadata

每當中繼資料變更時,再由子類別呼叫。

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidReceiveQueueItemIDs: (NSArray< NSNumber * > *)  itemIDs

每當收到媒體佇列項目 ID 清單時,再由子類別呼叫。

Parameters
itemIDsThe list of queue item IDs.
開始時間
4.1

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidInsertQueueItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs
beforeItemWithID: (GCKMediaQueueItemID beforeItemID 

在佇列中插入連續的佇列項目序列時,可由子類別呼叫。

Parameters
itemIDsThe list of queue item IDs identifying the items that were inserted.
beforeItemIDThe ID of the queue item in front of which the new items were inserted, or kGCKInvalidQueueItemID if the items were appended to the end of the queue.
開始時間
4.1

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidUpdateQueueItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

每當佇列中現有的佇列項目更新時,再由子類別呼叫。

Parameters
itemIDsThe list of queue item IDs identifying the items that were updated.
開始時間
4.1

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidRemoveQueueItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

每當從佇列中移除連續的佇列項目序列時,再由子類別呼叫。

Parameters
itemIDsThe list of queue item IDs identifying the items that were removed.
開始時間
4.1

由「GCKRemoteMediaClient(Protected)」類別提供。

- (void) notifyDidReceiveQueueItems: (NSArray< GCKMediaQueueItem * > *)  items

在收到佇列項目時由子類別呼叫。

Parameters
itemsThe list of queue items.
開始時間
4.1

由「GCKRemoteMediaClient(Protected)」類別提供。

資源詳情

- (BOOL) connected
readnonatomicassign

指出此物件是否已連線至工作階段的旗標。

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

目前的媒體狀態 (由媒體控制管道回報)。

- (GCKMediaQueue*) mediaQueue
readnonatomicstrong

媒體待播清單。

開始時間
4.3.4
- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

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

如果尚未收到媒體狀態,這個值會是 NAN。

- (BOOL) playingLiveStream
readnonatomicassign

以標記表示用戶端是否正在播放直播。

開始時間
4.4.1
- (id<GCKRemoteMediaClientAdInfoParserDelegate>) adInfoParserDelegate
readwritenonatomicweak

委派項目可從 GCKMediaStatus 物件中的自訂資料擷取廣告插播資訊。

Deprecated:
請改用 GCKAdBreakStatus