GCKRemoteMediaClient 클래스

이 객체의 리스너 목록에 리스너를 추가합니다.

추가된 리스너는 약하게 유지되므로 예기치 않은 할당 해제를 방지하기 위해 유지되어야 합니다.

Parameters

listener

The listener to add.

이 객체의 리스너 목록에서 리스너를 제거합니다.

Parameters

listener

The listener to remove.

요청 데이터가 있는 미디어 항목 또는 미디어 항목의 큐를 로드하고 재생을 시작합니다.

Parameters

requestData

Describes the media load request.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

다음 이후:

4.4.1

기본 옵션을 사용하여 새 미디어 항목을 로드하고 재생합니다.

대신 loadMediaWithLoadRequestData:를 사용하는 것이 좋습니다. 이는 추가 옵션이 있는 단일 항목 또는 큐의 로드를 지원하는 고급 로드 명령어입니다.

Parameters

mediaInfo

Describes the media item to load.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

지정된 옵션으로 새 미디어 항목을 로드하고 재생을 시작합니다.

대신 loadMediaWithLoadRequestData:를 사용하는 것이 좋습니다. 이는 추가 옵션이 있는 단일 항목 또는 큐의 로드를 지원하는 고급 로드 명령어입니다.

Parameters

mediaInfo	Describes the media item to load.
options	The load options for this request.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

다음 이후:

4.0

새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.

Parameters

mediaInfo	Describes the media item to load.
autoplay	Whether playback should start immediately.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.

Parameters

mediaInfo	Describes the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.

Parameters

mediaInfo	Describes 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 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.

Parameters

mediaInfo	Describes 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 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

새 미디어 항목을 로드하고 선택적으로 재생을 시작합니다.

Parameters

mediaInfo	Describes 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 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

현재 미디어 세션의 재생 속도를 설정합니다.

Parameters

playbackRate

The new playback rate.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

다음 이후:

4.0

현재 미디어 세션의 재생 속도를 설정합니다.

Parameters

playbackRate	The new playback rate, which must be between GCKMediaLoadOptions::kGCKMediaMinPlaybackRate and GCKMediaLoadOptions::kGCKMediaMaxPlaybackRate.
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 객체입니다.

다음 이후:

4.0

활성 트랙을 설정합니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

Parameters

activeTrackIDs

An array of integers specifying the active tracks. May be empty or nil to disable any currently active tracks.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

텍스트 트랙 스타일을 설정합니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

Parameters

textTrackStyle

The text track style. The style will not be changed if this is nil.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

현재 미디어 항목의 재생을 일시중지합니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

현재 미디어 항목의 재생을 일시중지합니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

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 객체입니다.

현재 미디어 항목의 재생을 중지합니다.

현재 로드되어 있는 큐는 삭제됩니다. 현재 미디어 상태가 없으면 요청이 실패합니다.

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 객체입니다.

현재 미디어 항목의 재생을 시작하거나 다시 시작합니다.

재생은 항상 스트림 시작 부분부터 시작됩니다. 현재 미디어 상태가 없으면 요청이 실패합니다.

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 객체입니다.

다음 이후:

4.3

현재 미디어 항목 내에서 새 위치를 찾습니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

Parameters

options

The seek options for the request.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

다음 이후:

4.0

현재 미디어 항목 내에서 새 위치를 찾습니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

Parameters

position

The new position from the beginning of the stream.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

Deprecated:

DiscoverWithOptions:.를 사용합니다.

현재 미디어 항목 내에서 새 위치를 찾습니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

Parameters

position	The new position interval from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

Deprecated:

DiscoverWithOptions:.를 사용합니다.

현재 미디어 항목 내에서 새 위치를 찾습니다.

현재 미디어 상태가 없으면 요청이 실패합니다.

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 객체입니다.

Deprecated:

DiscoverWithOptions:.를 사용합니다.

큐의 항목 ID 목록을 요청합니다.

결과는 대리자 콜백 GCKRemoteMediaClientDelegate::remoteMediaClient:didReceivedQueueItemIDs:에 전달됩니다.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

다음 이후:

4.1

지정된 항목 ID가 있는 큐 항목에 대한 전체 정보를 요청합니다.

결과는 대리자 콜백 GCKRemoteMediaClientDelegate::remoteMediaClient:did수신QueueItems:에 전달됩니다.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

다음 이후:

4.1

미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.

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 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.

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 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.

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 객체입니다.

Deprecated:

loadMediaWithLoadRequestData:.

미디어 항목의 새 큐를 로드하고 선택적으로 재생을 시작합니다.

대신 loadMediaWithLoadRequestData:를 사용하는 것이 좋습니다. 이는 추가 옵션이 있는 단일 항목 또는 큐의 로드를 지원하는 고급 로드 명령어입니다.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be nil or empty.
options	The load options used to load the queue items, as defined by GCKMediaQueueLoadOptions

다음 이후:

4.3.1

새 미디어 항목 목록을 대기열에 삽입합니다.

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 객체입니다.

새 미디어 항목 목록을 대기열에 삽입합니다.

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 객체입니다.

큐에 항목 하나를 삽입하는 편의 메서드입니다.

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 객체입니다.

큐에 항목 하나를 삽입하여 현재 항목으로 만드는 편의 메서드입니다.

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 객체입니다.

큐에 항목 하나를 삽입하여 현재 항목으로 만드는 편의 메서드입니다.

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 객체입니다.

큐를 업데이트합니다.

Parameters

queueItems

The list of updated items.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

큐를 업데이트합니다.

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 객체입니다.

대기열에서 미디어 항목 목록을 삭제합니다.

그 결과 대기열이 비어 있게 되면 현재 미디어 세션이 종료됩니다.

Parameters

itemIDs

An array of media item IDs identifying the items to remove. Must not be nil or empty.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

대기열에서 미디어 항목 목록을 삭제합니다.

그 결과 대기열이 비어 있게 되면 현재 미디어 세션이 종료됩니다.

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 객체입니다.

큐에서 단일 항목을 제거하는 편의 메서드입니다.

Parameters

itemID

The ID of the item to remove.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

대기열의 미디어 항목 목록을 재정렬합니다.

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 객체입니다.

대기열의 미디어 항목 목록을 재정렬합니다.

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 객체입니다.

큐에서 단일 항목을 이동하는 편의 메서드입니다.

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 객체입니다.

대기열에서 지정된 ID가 있는 항목으로 이동합니다.

Parameters

itemID

The ID of the item to jump to.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

대기열에서 지정된 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 객체입니다.

대기열에서 지정된 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 객체입니다.

대기열의 이전 항목으로 이동합니다.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

큐 반복 모드를 설정합니다.

Parameters

repeatMode

The new repeat mode.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

스트림 볼륨을 설정합니다.

현재 미디어 세션이 없으면 요청이 실패합니다.

Parameters

volume

The new volume, in the range [0.0 - 1.0].

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

스트림 볼륨을 설정합니다.

현재 미디어 세션이 없으면 요청이 실패합니다.

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 객체입니다.

스트림을 음소거할지 여부를 설정합니다.

현재 미디어 세션이 없으면 요청이 실패합니다.

Parameters

muted

Whether the stream should be muted or unmuted.

반환 값

이 요청을 추적하기 위한 GCKRequest 객체입니다.

스트림을 음소거할지 여부를 설정합니다.

현재 미디어 세션이 없으면 요청이 실패합니다.

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 객체입니다.

마지막으로 수신된 스트림 정보와 업데이트 이후 경과된 실제 경과 시간을 사용하여 계산된 대략적인 스트림 위치를 반환합니다.

채널이 연결되지 않았거나 현재 로드된 미디어가 없는 경우 0을 반환합니다.

마지막으로 수신된 스트림 정보와 업데이트 이후 경과된 실제 경과 시간을 사용하여 계산된 탐색 가능한 범위의 대략적인 시작 위치를 반환합니다.

채널이 연결되지 않았거나 현재 로드된 미디어가 없는 경우 0을 반환합니다. 스트림이 실시간 스트림이 아니거나 검색 가능한 범위가 없으면 kGCKInvalidTimeInterval를 반환합니다.

다음 이후:

4.4.1

마지막으로 수신된 스트림 정보와 업데이트 이후 경과된 실제 경과 시간을 사용하여 계산된 탐색 가능한 범위의 대략적인 종료 위치를 반환합니다.

채널이 연결되지 않았거나 현재 로드된 미디어가 없는 경우 0을 반환합니다. 스트림이 실시간 스트림이 아니거나 검색 가능한 범위가 없으면 kGCKInvalidTimeInterval를 반환합니다.

다음 이후:

4.4.1

미디어 세션이 시작될 때마다, 즉 새 미디어가 원격 플레이어에서 성공적으로 로드된 직후 서브클래스에 의해 호출됩니다.

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

클라이언트의 mediaStatus 객체가 변경될 때마다 서브클래스에서 호출합니다.

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

클라이언트에서 관리하는 미디어 큐가 변경될 때마다 서브클래스에서 호출합니다.

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

클라이언트 GCKMediaStatus의 GCKMediaStatus::preloadedItemID가 변경될 때마다 서브클래스에서 호출합니다.

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

메타데이터가 변경될 때마다 서브클래스에서 호출합니다.

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

미디어 큐 항목 ID 목록이 수신될 때마다 서브클래스에서 호출합니다.

Parameters

itemIDs

The list of queue item IDs.

다음 이후:

4.1

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

큐 항목의 인접한 시퀀스가 큐에 삽입될 때마다 서브클래스에서 호출합니다.

Parameters

itemIDs	The list of queue item IDs identifying the items that were inserted.
beforeItemID	The 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) 카테고리별로 제공됩니다.

기존 큐 항목이 큐에서 업데이트될 때마다 서브클래스에서 호출합니다.

Parameters

itemIDs

The list of queue item IDs identifying the items that were updated.

다음 이후:

4.1

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

큐 항목의 인접한 시퀀스가 큐에서 삭제될 때마다 서브클래스에서 호출합니다.

Parameters

itemIDs

The list of queue item IDs identifying the items that were removed.

다음 이후:

4.1

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

큐 항목이 수신될 때마다 서브클래스에서 호출합니다.

Parameters

items

The list of queue items.

다음 이후:

4.1

GCKRemoteMediaClient(Protected) 카테고리별로 제공됩니다.

이 객체가 세션에 연결되어 있는지 여부를 나타내는 플래그입니다.

미디어 제어 채널에서 보고된 현재 미디어 상태입니다.

미디어 대기열

다음 이후:

4.3.4

미디어 상태 업데이트가 마지막으로 수신된 후 경과된 시간입니다.

미디어 상태가 아직 수신되지 않은 경우 이 값은 NAN이 됩니다.

이 클라이언트가 실시간 스트림을 재생 중인지 여부를 나타내는 플래그입니다.

다음 이후:

4.4.1

GCKMediaStatus 객체의 맞춤 데이터에서 광고 시점 정보를 추출할 수 있는 대리자입니다.

Deprecated:

대신 GCKAdBreakStatus를 사용하세요.