개요

Cast 기기용 컨트롤러입니다.

이 클래스는 Cast 기기에서 실행되는 애플리케이션 간에 메시지를 전송하고 수신하거나 애플리케이션을 실행하고 종료할 수 있습니다.

GCKDeviceManager 인스턴스는 Cast 기기 연결이 설정되어 있거나 생성 또는 해제 중인 경우에 범위 내에 있어야 합니다. connect (GCKDeviceManager)와의 연결이 시작되기 전이나 deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p), deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) 대리자 콜백이 호출된 후에는 객체를 해제해도 안전합니다.

Deprecated:: GCKSessionManager 및 GCKCastSession를 사용하여 Cast 수신기와 상호작용합니다.

NSObject를 상속합니다.

인스턴스 메서드 요약
(instancetype)	- initWithDevice:clientPackageName:
	지정된 기기로 새 GCKDeviceManager를 구성합니다. 더보기...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	지정된 초기화 메서드입니다. 더보기...

(void)	- connect
	기기에 연결합니다. 더보기...

(void)	- disconnect
	기기에서 연결 해제합니다. 더보기...

(void)	- disconnectWithLeave:
	기기에서 연결 해제합니다. 더보기...

(BOOL)	- addChannel:
	특정 네임스페이스에서 이 기기에 대한 메시지를 주고받을 수 있는 채널을 추가합니다. 더보기...

(BOOL)	- removeChannel:
	이전에 추가한 채널을 삭제합니다. 더보기...

(NSInteger)	- launchApplication:
	애플리케이션을 실행합니다. 더보기...

(NSInteger)	- launchApplication:withLaunchOptions:
	지정된 시작 옵션을 사용하여 애플리케이션을 실행합니다. 더보기...

(NSInteger)	- launchApplication:relaunchIfRunning:
	애플리케이션을 실행하고, 이미 실행 중인 경우 다시 실행합니다. 더보기...

(NSInteger)	- joinApplication:
	애플리케이션에 참여합니다. 더보기...

(NSInteger)	- joinApplication:sessionID:
	특정 애플리케이션 세션 ID로 애플리케이션을 조인합니다. 더보기...

(BOOL)	- leaveApplication
	현재 애플리케이션에서 나갑니다. 더보기...

(NSInteger)	- stopApplication
	실행 중인 애플리케이션을 중지합니다. 더보기...

(NSInteger)	- stopApplicationWithSessionID:
	지정된 애플리케이션 세션 ID로 애플리케이션을 중지합니다. 더보기...

(NSInteger)	- setVolume:
	시스템 볼륨을 설정합니다. 더보기...

(NSInteger)	- setMuted:
	숨기기를 사용 또는 사용 중지합니다. 더보기...

(NSInteger)	- requestDeviceStatus
	기기의 현재 상태를 요청합니다. 더보기...

속성 요약
BOOL	ignoreAppStateNotifications
	이 객체가 앱 상태 알림을 수신 대기할지 여부입니다. 더보기...

GCKConnectionState	connectionState
	기기 관리자의 현재 연결 상태입니다. 더보기...

GCKConnectionState	applicationConnectionState
	기기 관리자의 현재 애플리케이션 연결 상태입니다. 더보기...

BOOL	isConnected
	기기 관리자가 기기 연결을 설정한 경우 true입니다. 더보기...

BOOL	isConnectedToApp
	기기 관리자가 기기의 애플리케이션과 연결을 설정한 경우 true입니다. 더보기...

BOOL	isReconnecting
	잠재적으로 일시적인 이벤트로 인해 기기 관리자의 연결이 끊어지면 true입니다 (예: 앱이 백그라운드 상태이거나 다시 연결하여 네트워크 오류를 해결할 수 있음). 더보기...

NSTimeInterval	reconnectTimeout
	소켓이 연결 해제되고 일시적인 오류가 발생할 경우 이 시간 동안 재연결을 시도합니다. 더보기...

GCKDevice *	device
	이 GCKDeviceManager에서 제어하는 기기입니다. 더보기...

id< GCKDeviceManagerDelegate >	delegate
	GCKDeviceManager에서 알림을 받기 위한 위임입니다. 더보기...

float	deviceVolume
	알려진 경우 [0.0, 1.0] 범위의 기기의 현재 볼륨, 그렇지 않은 경우 0입니다. 더보기...

BOOL	deviceMuted
	기기의 현재 음소거 상태입니다(알려진 경우). 그렇지 않은 경우 `NO`입니다. 더보기...

GCKActiveInputStatus	activeInputStatus
	기기의 현재 '활성 입력' 상태입니다. 더보기...

GCKStandbyStatus	standbyStatus
	기기의 현재 '대기' 상태입니다. 더보기...

NSString *	applicationSessionID
	현재 연결된 수신기 애플리케이션의 애플리케이션 세션 ID입니다(있는 경우). 그렇지 않은 경우 `nil`입니다. 더보기...

GCKApplicationMetadata *	applicationMetadata
	현재 수신기에서 실행 중인 수신기 애플리케이션의 메타데이터입니다(있는 경우). 그렇지 않은 경우 `nil`입니다. 더보기...

NSString *	applicationStatusText
	현재 실행 중인 수신기 애플리케이션에서 가장 최근에 보고된 상태 텍스트입니다(있는 경우). 그렇지 않으면 `nil`입니다. 더보기...

메서드 세부정보

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

지정된 기기로 새 GCKDeviceManager를 구성합니다.

객체가 앱 상태 알림을 수신 대기하고, 앱이 백그라운드로 전환되면 자동으로 기기 연결을 끊고, 앱이 포그라운드로 돌아올 때 기기에 다시 연결을 시도합니다.

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName
ignoreAppStateNotifications:	(BOOL)	ignoreAppStateNotifications

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

지정된 기기를 제어하기 위한 새 GCKDeviceManager를 구성합니다.

ignoreAppStateNotifications이 NO이면 객체가 앱 상태 변경을 수신 대기하고 앱이 백그라운드로 전환될 때 기기에서 자동으로 연결 해제되고 앱이 포그라운드로 돌아올 때 기기에 다시 연결을 시도합니다.

ignoreAppStateNotifications가 YES이면 객체는 이러한 알림을 리슨하지 않으며 연결 수명 주기를 관리하는 것은 앱의 책임입니다. 일반적으로 백그라운드 iOS 앱은 무기한으로 실행될 수 없으며 결국 활성 네트워크 연결은 운영체제에서 종료됩니다.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

기기에 연결합니다.

- (void) disconnect

기기에서 연결 해제합니다.

이는 명시적인 연결 해제입니다.

connect가 호출된 후 이 객체가 소유자에서 해제되기 전에 특정 연결 해제 메서드 중 하나를 반드시 호출해야 합니다.

- (void) disconnectWithLeave: (BOOL) leaveApplication

기기에서 연결 해제합니다.

connect가 호출된 후 이 객체가 소유자에서 해제되기 전에 특정 연결 해제 메서드 중 하나를 반드시 호출해야 합니다.

Parameters

leaveApplication YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel: (GCKCastChannel *) channel

특정 네임스페이스에서 이 기기에 대한 메시지를 주고받을 수 있는 채널을 추가합니다.

Parameters

channel The channel.

반환 값: 채널이 추가된 경우 YES, 해당 네임스페이스에 이미 연결된 채널이 있어 채널이 추가되지 않은 경우 NO입니다.

- (BOOL) removeChannel: (GCKCastChannel *) channel

이전에 추가한 채널을 삭제합니다.

Parameters

channel The channel.

반환 값: 채널이 삭제된 경우 YES, 해당 채널이 이전에 연결되지 않아 삭제되지 않은 경우 NO입니다.

- (NSInteger) launchApplication: (NSString *) applicationID

애플리케이션을 실행합니다.

Parameters

applicationID The application ID.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	(GCKLaunchOptions *__nullable)	launchOptions

지정된 시작 옵션을 사용하여 애플리케이션을 실행합니다.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil`, defaults will be used.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

애플리케이션을 실행하고, 이미 실행 중인 경우 다시 실행합니다.

Deprecated:: 대신 launchApplication:withLaunchOptions:를 사용하세요.

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES`, relaunches the application if it is already running instead of joining the running application.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) joinApplication: (NSString *__nullable) applicationID

애플리케이션에 참여합니다.

Parameters

applicationID The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

특정 애플리케이션 세션 ID로 애플리케이션을 조인합니다.

수신기에서 주어진 세션 ID가 더 이상 활성 상태가 아니면 요청이 실패합니다.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (BOOL) leaveApplication

현재 애플리케이션에서 나갑니다.

반환 값: 메시지를 보낼 수 없는 경우 NO.

- (NSInteger) stopApplication

실행 중인 애플리케이션을 중지합니다.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

지정된 애플리케이션 세션 ID로 애플리케이션을 중지합니다.

수신기에서 주어진 세션 ID가 더 이상 활성 상태가 아니면 요청이 실패합니다.

Parameters

sessionID The application session ID, which may not be nil.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) setVolume: (float) volume

시스템 볼륨을 설정합니다.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) setMuted: (BOOL) muted

숨기기를 사용 설정 또는 중지합니다.

Parameters

muted Whether audio should be muted or unmuted.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

- (NSInteger) requestDeviceStatus

기기의 현재 상태를 요청합니다.

이렇게 하면 업데이트된 상태 정보가 수신되면 모든 대리자 상태 업데이트 콜백이 호출됩니다.

반환 값: 요청 ID 또는 요청을 보낼 수 없는 경우 kGCKInvalidRequestID입니다.

부동산 세부정보

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

이 객체가 앱 상태 알림을 수신 대기할지 여부입니다.

이 플래그는 초기화 프로그램에 지정할 수 있습니다. 기본값은 NO입니다.

- (GCKConnectionState) connectionState

readnonatomicassign

기기 관리자의 현재 연결 상태입니다.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

기기 관리자의 현재 애플리케이션 연결 상태입니다.

- (BOOL) isConnected

readnonatomicassign

기기 관리자가 기기 연결을 설정한 경우 true입니다.

Deprecated:: connectionState를 사용합니다.

- (BOOL) isConnectedToApp

readnonatomicassign

기기 관리자가 기기의 애플리케이션과 연결을 설정한 경우 true입니다.

Deprecated:: applicationConnectionState를 사용합니다.

- (BOOL) isReconnecting

readnonatomicassign

잠재적으로 일시적인 이벤트로 인해 기기 관리자의 연결이 끊어지면 true입니다 (예: 앱이 백그라운드 상태이거나 다시 연결하여 네트워크 오류를 해결할 수 있음).

일시적인 일시 후에 기기 관리자가 다시 연결하는 동안에는 연결 해제/연결 콜백이 호출되지 않지만 속성이 항상 실제 현재 상태를 반영하며 관찰 가능합니다.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

소켓이 연결 해제되고 일시적인 오류가 발생할 경우 이 시간 동안 재연결을 시도합니다.

기본 제한 시간은 15초입니다.

- (GCKDevice*) device

readnonatomicassign

이 GCKDeviceManager에서 제어하는 기기입니다.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

GCKDeviceManager에서 알림을 받기 위한 위임입니다.

- (float) deviceVolume

readnonatomicassign

알려진 경우 [0.0, 1.0] 범위의 기기의 현재 볼륨, 그렇지 않은 경우 0입니다.

- (BOOL) deviceMuted

readnonatomicassign

기기의 현재 음소거 상태입니다(알려진 경우). 그렇지 않은 경우 NO입니다.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

기기의 현재 '활성 입력' 상태입니다.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

기기의 현재 '대기' 상태입니다.

- (NSString*) applicationSessionID

readnonatomiccopy

현재 연결된 수신기 애플리케이션의 애플리케이션 세션 ID입니다(있는 경우). 그렇지 않은 경우 nil입니다.

수신기 애플리케이션이 실행될 때마다 (동일한 애플리케이션이 다시 실행될 때 포함) 새 고유 세션 ID가 생성되며, 수신기 애플리케이션이 실행되는 동안 계속 유효합니다.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

현재 수신기에서 실행 중인 수신기 애플리케이션의 메타데이터입니다(있는 경우). 그렇지 않은 경우 nil입니다.

- (NSString*) applicationStatusText

readnonatomiccopy

현재 실행 중인 수신기 애플리케이션에서 가장 최근에 보고된 상태 텍스트입니다(있는 경우). 그렇지 않으면 nil입니다.

GCKDeviceManager 클래스

개요

인스턴스 메서드 요약

속성 요약

메서드 세부정보

부동산 세부정보