개요
Cast 수신기에서 미디어 재생을 제어하는 클래스입니다.
이 클래스는 지원 중단된 GCKMediaControlChannel와 동일한 기능을 제공하지만 래핑되지만 더 편리한 API를 사용합니다. 주요 차이점은 다음과 같습니다.
- 각 요청은 전용 대리자로 추적할 수 있는 GCKRequest 객체로 표시됩니다.
- GCKRemoteMediaClient는 단일 대리자가 아닌 여러 리스너를 지원합니다.
- Since
- 3.0
NSObject를 상속합니다.
속성 요약 | |
BOOL | connected |
이 객체가 세션에 연결되어 있는지를 나타내는 플래그입니다. 더보기... | |
GCKMediaStatus * | mediaStatus |
미디어 제어 채널에서 보고한 현재 미디어 상태입니다. 더보기... | |
NSTimeInterval | timeSinceLastMediaStatusUpdate |
마지막 미디어 상태 업데이트가 수신된 후 지난 시간입니다. 더보기... | |
id< GCKRemoteMediaClientAdInfoParserDelegate > | adInfoParserDelegate |
GCKMediaStatus 객체의 맞춤 데이터에서 광고 시점 정보를 추출할 수 있는 대리자 더보기... | |
메서드 세부정보
- (void) addListener: | (id< GCKRemoteMediaClientListener >) | listener |
이 객체의 리스너 목록에 리스너를 추가합니다.
- Parameters
-
listener The listener to add.
- (void) removeListener: | (id< GCKRemoteMediaClientListener >) | listener |
이 객체의 리스너 목록에서 리스너를 삭제합니다.
- Parameters
-
listener The listener to remove.
- (GCKRequest *) loadMedia: | (GCKMediaInformation *) | mediaInfo |
새 미디어 항목을 로드하고 재생을 시작합니다.
- Parameters
-
mediaInfo An object describing the media item to load.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
customData: | (id __nullable) | customData | |
새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position. customData Custom 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 *) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
activeTrackIDs: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs | |
새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position. activeTrackIDs An array of integers specifying the active tracks. May be nil
.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
activeTrackIDs: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs | |
customData: | (id __nullable) | customData | |
새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position. activeTrackIDs An array of integers specifying the active tracks. May be nil
.customData Custom 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 *) setActiveTrackIDs: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs |
활성 트랙을 설정합니다.
현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
activeTrackIDs An array of integers specifying the active tracks. May be empty or nil
to disable any currently active tracks.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) setTextTrackStyle: | (GCKMediaTextTrackStyle *__nullable) | textTrackStyle |
텍스트 트랙 스타일을 설정합니다.
현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
textTrackStyle The text track style. The style will not be changed if this is nil
.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) pause |
- (GCKRequest *) pauseWithCustomData: | (id __nullable) | customData |
현재 미디어 항목의 재생을 일시중지합니다.
현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
customData Custom 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 *) stopWithCustomData: | (id __nullable) | customData |
현재 미디어 항목의 재생을 중지합니다.
현재 로드 중인 큐는 삭제됩니다. 현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
customData Custom 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: | (id __nullable) | customData |
현재 미디어 항목의 재생을 시작하거나 다시 시작합니다.
항상 스트림 시작 부분에서 재생을 시작합니다. 현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
customData Custom 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 *) seekToTimeInterval: | (NSTimeInterval) | position |
현재 미디어 항목 내에서 새 위치를 찾습니다.
현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
position The new position from the beginning of the stream.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) seekToTimeInterval: | (NSTimeInterval) | position | |
resumeState: | (GCKMediaResumeState) | resumeState | |
현재 미디어 항목 내에서 새 위치를 찾습니다.
현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
position The new position interval from the beginning of the stream. resumeState The action to take after the seek operation has finished.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) seekToTimeInterval: | (NSTimeInterval) | position | |
resumeState: | (GCKMediaResumeState) | resumeState | |
customData: | (id __nullable) | customData | |
현재 미디어 항목 내에서 새 위치를 찾습니다.
현재 미디어 상태가 없으면 요청이 실패합니다.
- Parameters
-
position The new position from the beginning of the stream. resumeState The action to take after the seek operation has finished. customData Custom 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 *) queueLoadItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
startIndex: | (NSUInteger) | startIndex | |
repeatMode: | (GCKMediaRepeatMode) | repeatMode | |
미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to load. Must not be nil
or empty.startIndex The index of the item in the items array that should be played first. repeatMode The repeat mode for playing the queue.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) queueLoadItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
startIndex: | (NSUInteger) | startIndex | |
repeatMode: | (GCKMediaRepeatMode) | repeatMode | |
customData: | (id __nullable) | customData | |
미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to load. Must not be nil
or empty.startIndex The index of the item in the items array that should be played first. repeatMode The repeat mode for playing the queue. customData Custom 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 *) queueLoadItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
startIndex: | (NSUInteger) | startIndex | |
playPosition: | (NSTimeInterval) | playPosition | |
repeatMode: | (GCKMediaRepeatMode) | repeatMode | |
customData: | (id __nullable) | customData | |
미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to load. Must not be nil
or empty.startIndex The index of the item in the items array that should be played first. playPosition The 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. repeatMode The repeat mode for playing the queue. customData Custom 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 *) queueInsertItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
새 미디어 항목 목록을 대기열에 삽입합니다.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to insert. Must not be nil
or empty.beforeItemID The 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: | (id __nullable) | customData | |
새 미디어 항목 목록을 대기열에 삽입합니다.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to insert. Must not be nil
or empty.beforeItemID 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. customData Custom 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
-
item The item to insert. beforeItemID The 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
-
item The item to insert. beforeItemID The 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: | (id __nullable) | customData | |
단일 항목을 대기열에 삽입하고 현재 항목으로 만드는 편의 메서드입니다.
- Parameters
-
item The item to insert. beforeItemID The 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. playPosition The 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. customData Custom 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 |
- (GCKRequest *) queueUpdateItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
customData: | (id __nullable) | customData | |
큐를 업데이트합니다.
- Parameters
-
queueItems The list of updated items. customData Custom 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
-
itemIDs An array of media item IDs identifying the items to remove. Must not be nil
or empty.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) queueRemoveItemsWithIDs: | (NSArray< NSNumber * > *) | itemIDs | |
customData: | (id __nullable) | customData | |
현재 재생목록에서 미디어 항목 목록을 삭제합니다.
따라서 현재 재생목록이 비어 있으면 현재 미디어 세션이 종료됩니다.
- Parameters
-
itemIDs An array of media item IDs identifying the items to remove. Must not be nil
or empty.customData Custom 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
-
itemID The ID of the item to remove.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) queueReorderItemsWithIDs: | (NSArray< NSNumber * > *) | queueItemIDs | |
insertBeforeItemWithID: | (NSUInteger) | beforeItemID | |
큐의 미디어 항목 목록을 재정렬합니다.
- Parameters
-
queueItemIDs An array of media item IDs identifying the items to reorder. Must not be nil
or empty.beforeItemID 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 appended at the end of the queue.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) queueReorderItemsWithIDs: | (NSArray< NSNumber * > *) | queueItemIDs | |
insertBeforeItemWithID: | (NSUInteger) | beforeItemID | |
customData: | (id __nullable) | customData | |
대기열의 미디어 항목 목록을 재정렬합니다.
- Parameters
-
queueItemIDs An array of media item IDs identifying the items to reorder. Must not be nil
or empty.beforeItemID The 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. customData Custom 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
-
itemID The ID of the item to move. beforeItemID The 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
-
itemID The ID of the item to jump to.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) queueJumpToItemWithID: | (NSUInteger) | itemID | |
customData: | (id __nullable) | customData | |
큐에서 지정된 ID가 있는 항목으로 이동합니다.
- Parameters
-
itemID The ID of the item to jump to. customData Custom 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: | (id __nullable) | customData | |
큐에서 지정된 ID가 있는 항목으로 이동합니다.
- Parameters
-
itemID The ID of the item to jump to. playPosition The 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. customData Custom 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 |
- (GCKRequest *) setStreamVolume: | (float) | volume |
스트림 볼륨을 설정합니다.
현재 미디어 세션이 없으면 요청이 실패합니다.
- Parameters
-
volume The new volume, in the range [0.0 - 1.0].
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) setStreamVolume: | (float) | volume | |
customData: | (id __nullable) | customData | |
스트림 볼륨을 설정합니다.
현재 미디어 세션이 없으면 요청이 실패합니다.
- Parameters
-
volume The new volume, in the range [0.0 - 1.0]. customData Custom 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
-
muted Whether the stream should be muted or unmuted.
- 반환 값
- 이 요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) setStreamMuted: | (BOOL) | muted | |
customData: | (id __nullable) | customData | |
스트림을 음소거할지 여부를 설정합니다.
현재 미디어 세션이 없으면 요청이 실패합니다.
- Parameters
-
muted Whether the stream should be muted or unmuted. customData Custom 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을 반환합니다.
- (void) notifyDidStartMediaSession |
미디어 세션이 시작될 때마다, 즉 원격 미디어에 새 미디어가 성공적으로 로드된 직후에 서브클래스에서 호출합니다.
GCKRemoteMediaClient(Protected) 카테고리에서 제공합니다.
- (void) notifyDidUpdateMediaStatus |
클라이언트의 mediaStatus 객체가 변경될 때마다 서브클래스가 호출합니다.
GCKRemoteMediaClient(Protected) 카테고리에서 제공합니다.
- (void) notifyDidUpdateQueue |
클라이언트에서 관리하는 미디어 큐가 변경될 때마다 서브클래스에서 호출합니다.
GCKRemoteMediaClient(Protected) 카테고리에서 제공합니다.
- (void) notifyDidUpdatePreloadStatus |
클라이언트의 mediaStatus에 대한 GCKMediaStatus::preloadedItemID가 변경될 때마다 서브클래스에서 호출됩니다.
GCKRemoteMediaClient(Protected) 카테고리에서 제공합니다.
- (void) notifyDidUpdateMetadata |
메타데이터가 변경될 때마다 서브클래스에서 호출합니다.
GCKRemoteMediaClient(Protected) 카테고리에서 제공합니다.
부동산 세부정보
|
readnonatomicassign |
이 객체가 세션에 연결되어 있는지를 나타내는 플래그입니다.
|
readnonatomicstrong |
미디어 제어 채널에서 보고한 현재 미디어 상태입니다.
|
readnonatomicassign |
마지막 미디어 상태 업데이트가 수신된 후 지난 시간입니다.
현재 상태 요청이 진행 중인 경우 0이 됩니다.
|
readwritenonatomicweak |
GCKMediaStatus 객체의 맞춤 데이터에서 광고 시점 정보를 추출할 수 있는 대리자
- Deprecated:
- 대신 GCKAdBreakStatus를 사용하세요.