GCKMediaControlChannel 클래스

인스턴스 메서드 | 속성

GCKMediaControlChannel 클래스 참조

개요

미디어 컨트롤 작업을 위한 GCKCastChannel 서브클래스.

현재 활성화된 스트림 (재생, 일시중지, 탐색, 중지 등)에 적용되는 모든 작업은 유효한 (즉, nil이 아닌) 미디어 상태가 필요하거나 kGCKInvalidRequestID를 반환하고 요청을 전송하지 않습니다. 채널이 연결되면 미디어 상태가 자동으로 요청되고, 성공적인 로드 완료에 포함되며, 언제든지 업데이트할 수 있습니다. 미디어 상태도 언제든지 nil이 될 수 있습니다. 예를 들어 채널의 연결이 일시적으로 끊어지면 발생합니다. 이 채널을 사용할 때는 미디어 상태 변경을 mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p) 콜백을 통해 모니터링해야 하며, 미디어 상태가 nil이 아닌 경우에만 스트림에 작동하는 메서드를 호출해야 합니다.

요청이 성공적으로 시작되면 해당 메서드는 해당 요청에 할당된 요청 ID를 반환합니다. 요청이 시작되지 않으면 메서드는 kGCKInvalidRequestID를 반환하고 lastError 속성을 설정하여 실패 이유를 나타냅니다. 요청이 성공적으로 시작되었지만 최종적으로 실패하면 mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) 콜백이 호출되어 실패를 나타냅니다.

위임 프로토콜은 GCKMediaControlChannelDelegate을 참고하세요.

Deprecated:

GCKCastSession의 GCKRemoteMediaClient 속성을 사용하여 미디어 재생을 제어합니다.

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 기기와 메시지를 주고받을 수 없습니다. 더보기...

속성 요약
GCKMediaStatus *	mediaStatus
	현재 로드된 미디어의 미디어 상태입니다(있는 경우). 그렇지 않은 경우 nil입니다. 더보기...
NSTimeInterval	timeSinceLastMediaStatusUpdate
	마지막 미디어 상태 업데이트가 수신된 후 지난 시간입니다. 더보기...
GCKError *	lastError
	마지막 요청의 오류 세부정보(있는 경우) 또는 nil(마지막 요청이 성공한 경우) 더보기...
id< GCKMediaControlChannelDelegate >	delegate
	채널 상태 변경에 대한 알림을 수신하기 위한 대리자입니다. 더보기...
NSString *	protocolNamespace
	채널의 네임스페이스입니다. 더보기...
BOOL	isConnected
	이 채널이 현재 연결되어 있는지 여부를 나타내는 플래그입니다. 더보기...
GCKDeviceManager *	deviceManager
	채널이 등록된 기기 관리자입니다(있는 경우). 더보기...

메서드 세부정보

- (instancetype) init

지정된 초기화 메서드입니다.

GCKCastChannel를 구현합니다.

- (NSInteger) loadMedia:

(GCKMediaInformation *)

mediaInfo

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

Parameters

mediaInfo

An object describing the media item to load.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) loadMedia:		(GCKMediaInformation *)	mediaInfo
autoplay:		(BOOL)	autoplay

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

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) setActiveTrackIDs:

(NSArray< NSNumber * > *__nullable)

activeTrackIDs

활성 트랙을 설정합니다.

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

Parameters

activeTrackIDs

An array of integers specifying the active tracks.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID 활성 트랙이 빈 목록으로 설정되도록 nil 또는 빈 배열일 수 있습니다.

- (NSInteger) setTextTrackStyle:

(GCKMediaTextTrackStyle *__nullable)

textTrackStyle

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

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

Parameters

textTrackStyle

The 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

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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) stop

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

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

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) play

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

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

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) seekToTimeInterval:

(NSTimeInterval)

position

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

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

Parameters

position

The new position from the beginning of the stream.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) seekToTimeInterval:		(NSTimeInterval)	position
resumeState:		(GCKMediaControlChannelResumeState)	resumeState

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

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

Parameters

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

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) seekToTimeInterval:		(NSTimeInterval)	position
resumeState:		(GCKMediaControlChannelResumeState)	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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queueUpdateItems:

(NSArray< GCKMediaQueueItem * > *)

queueItems

큐를 업데이트합니다.

Parameters

queueItems

The list of updated items.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queueRemoveItemsWithIDs:

(NSArray< NSNumber * > *)

itemIDs

현재 재생목록에서 미디어 항목 목록을 삭제합니다.

따라서 현재 재생목록이 비어 있으면 현재 미디어 세션이 종료됩니다.

Parameters

itemIDs

An 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

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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queueRemoveItemWithID:

(NSUInteger)

itemID

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

Parameters

itemID

The ID of the item to remove.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queueJumpToItemWithID:

(NSUInteger)

itemID

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

Parameters

itemID

The ID of the item to jump to.

반환 값

이 요청의 요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) 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.

반환 값

이 요청의 요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queueNextItem

현재 재생목록의 다음 항목으로 이동합니다.

반환 값

이 요청의 요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queuePreviousItem

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

반환 값

이 요청의 요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) queueSetRepeatMode:

(GCKMediaRepeatMode)

repeatMode

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

Parameters

repeatMode

The new repeat mode.

반환 값

이 요청의 요청 ID입니다. 메시지를 보낼 수 없거나 잘못된 매개변수가 있는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) setStreamVolume:

(float)

volume

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

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

Parameters

volume

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

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) setStreamMuted:

(BOOL)

muted

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

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

Parameters

muted

Whether the stream should be muted or unmuted.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) 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.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSInteger) requestStatus

수신기에서 업데이트된 미디어 상태 정보를 요청합니다.

반환 값

요청 ID 또는 메시지를 보낼 수 없는 경우 kGCKInvalidRequestID

- (NSTimeInterval) approximateStreamPosition

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

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

- (BOOL) cancelRequestWithID:

(NSInteger)

requestID

진행 중인 요청을 취소합니다.

요청을 취소해도 요청이 실행되지는 않습니다. 다만 호출 애플리케이션이 더 이상 요청 결과에 관심이 없음을 나타내기 때문에 요청 추적과 관련된 모든 상태가 삭제됩니다.

Parameters

requestID

The ID of the request to cancel.

반환 값

요청이 취소된 경우 YES, 해당 ID로 추적 중인 요청이 없는 경우 NO입니다.

- (instancetype) initWithNamespace:

(NSString *)

protocolNamespace

지정된 초기화 메서드입니다.

지정된 네임스페이스로 새 GCKCastChannel를 구성합니다.

Parameters

protocolNamespace

The namespace.

GCKGenericChannel에 구현되었습니다.

- (void) didReceiveTextMessage:

(NSString *)

message

이 채널에서 문자 메시지를 받으면 호출됩니다.

기본 구현은 노옵스(no-ops)입니다.

Parameters

message

The message.

- (BOOL) sendTextMessage:

(NSString *)

message

이 채널에 문자 메시지를 보냅니다.

Parameters

message

The message.

반환 값

성공 시 YES, 채널을 보낼 수 없거나 현재 전송 버퍼가 가득 찼기 때문에 메시지를 보낼 수 없는 경우 NO입니다.

Deprecated:

자세한 오류 정보를 제공하는 sendTextMessage:error:를 사용합니다.

- (BOOL) sendTextMessage:		(NSString *)	message
error:		(GCKError *__nullable *__nullable)	error

이 채널에 문자 메시지를 보냅니다.

Parameters

message	The message.
error	A 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 기기와 메시지를 주고받을 수 있습니다.

기본 구현은 노옵스(no-ops)입니다.

- (void) didDisconnect

채널이 연결 해제되었을 때 호출되어 더 이상 이 채널을 통해 Cast 기기와 메시지를 주고받을 수 없습니다.

기본 구현은 노옵스(no-ops)입니다.

부동산 세부정보

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