GCKCastSession 클래스

GCKCastSession 클래스 참조

개요

수신 기기로 Cast 세션을 관리하는 클래스입니다.

세션은 GCKSessionManager에 의해 자동으로 생성되고 관리됩니다. 애플리케이션에서 start (GCKSession(Protected)) 또는 endWithAction: (GCKSession(Protected))와 같은 세션 수명 주기 메서드를 직접 호출하면 안 됩니다.

다음 이후:
3.0

GCKSession를 상속합니다.

인스턴스 메서드 요약

(instancetype) - initWithDevice:sessionID:sessionOptions:castOptions:
 지정된 전송 옵션으로 새 전송 세션을 생성합니다. 더보기...
 
(BOOL) - addChannel:
 세션에 채널을 등록합니다. 더보기...
 
(BOOL) - removeChannel:
 세션에서 이전에 등록된 채널을 삭제합니다. 더보기...
 
(void) - addDeviceStatusListener:
 이 객체의 리스너 목록에 GCKCastDeviceStatusListener를 추가합니다. 더보기...
 
(void) - removeDeviceStatusListener:
 이 객체의 리스너 목록에서 GCKCastDeviceStatusListener를 삭제합니다. 더보기...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 다중 영역 그룹에서 개별 기기의 볼륨을 설정합니다. 더보기...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 다중 영역 그룹에서 개별 기기의 음소거 상태를 설정합니다. 더보기...
 
(GCKRequest *) - requestMultizoneStatus
 멀티 영역 그룹에서 멀티 영역 상태를 요청합니다. 더보기...
 
(instancetype) - initWithDevice:traits:sessionID:
 기본 옵션을 사용하여 지정된 기기의 새 세션 객체를 초기화합니다. 더보기...
 
(instancetype) - initWithDevice:traits:sessionID:sessionOptions:
 지정된 기기의 새 세션 객체를 초기화합니다. 더보기...
 
(GCKRequest *) - setDeviceVolume:
 기기의 볼륨을 설정합니다. 더보기...
 
(GCKRequest *) - setDeviceMuted:
 기기의 음소거 상태를 설정합니다. 더보기...
 
(void) - start
 세션을 시작합니다. 더보기...
 
(void) - endWithAction:
 지정된 작업으로 세션을 종료합니다. 더보기...
 
(void) - notifyDidStartWithSessionID:
 세션이 시작되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidFailToStartWithError:
 세션 시작에 실패했음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidEndWithError:willTryToResume:
 프레임워크에 세션이 종료되었음을 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 업데이트된 기기 볼륨 및 음소거 상태가 기기에서 수신되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidReceiveDeviceStatus:
 업데이트된 상태가 기기에서 수신되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidSuspendWithReason:
 지원 중단되었습니다. 사용하지 마세요. 노옵스(no-ops)로 구현되었습니다. 더보기...
 
(void) - notifyDidResume
 지원 중단되었습니다. 사용하지 마세요. 노옵스(no-ops)로 구현되었습니다. 더보기...
 

속성 요약

GCKActiveInputStatus activeInputStatus
 기기의 현재 '활성 입력' 상태입니다. 더보기...
 
GCKStandbyStatus standbyStatus
 기기의 현재 '대기' 상태 더보기...
 
GCKApplicationMetadataapplicationMetadata
 수신 기기에서 현재 실행 중인 수신기 애플리케이션의 메타데이터(있는 경우)이고, 그렇지 않으면 nil입니다. 더보기...
 
GCKDevicedevice
 이 세션이 연결된 기기입니다. 더보기...
 
NSString * sessionID
 현재 세션 ID입니다(있는 경우). 더보기...
 
GCKSessionOptions * sessionOptions
 세션 옵션입니다(있는 경우). 더보기...
 
GCKConnectionState connectionState
 현재 세션 연결 상태입니다. 더보기...
 
BOOL suspended
 세션이 현재 정지되었는지 여부를 나타내는 플래그입니다. 더보기...
 
NSString * deviceStatusText
 현재 기기 상태 텍스트입니다. 더보기...
 
GCKSessionTraitstraits
 세션 특성입니다. 더보기...
 
float currentDeviceVolume
 현재 기기 볼륨으로, [0.0, 1.0] 범위입니다. 더보기...
 
BOOL currentDeviceMuted
 현재 기기 음소거 상태입니다. 더보기...
 
GCKRemoteMediaClientremoteMediaClient
 이 세션에서 미디어 재생을 제어하는 데 사용할 수 있는 GCKRemoteMediaClient 객체입니다. 더보기...
 
GCKMediaMetadatamediaMetadata
 현재 미디어 메타데이터입니다(있는 경우). 더보기...
 

메서드 세부정보

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions
castOptions: (GCKCastOptions *)  castOptions 

지정된 전송 옵션으로 새 전송 세션을 생성합니다.

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
sessionOptionsThe session options, if any; otherwise nil.
castOptionsThe Cast options.
다음 이후:
4.0
- (BOOL) addChannel: (GCKCastChannel *)  channel

세션에 채널을 등록합니다.

세션이 연결되고 수신기 애플리케이션이 채널의 네임스페이스를 지원하는 경우 채널이 자동으로 연결됩니다. 세션이 연결되지 않으면 세션이 시작될 때까지 채널은 연결 해제 상태로 유지됩니다.

Parameters
channelThe channel to register.
반환 값
채널이 성공적으로 등록되면 YES, 그러지 않으면 NO입니다.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

세션에서 이전에 등록된 채널을 삭제합니다.

Parameters
channelThe channel to unregister.
반환 값
채널 등록이 취소된 경우 YES, 등록 취소되지 않은 경우 NO입니다.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

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

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

Parameters
listenerThe listener to add.
- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

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

Parameters
listenerThe listener to remove.
- (GCKRequest *) setDeviceVolume: (float)  volume
forMultizoneDevice: (GCKMultizoneDevice *)  device 

다중 영역 그룹에서 개별 기기의 볼륨을 설정합니다.

이는 비동기 작업입니다.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
반환 값
요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

다중 영역 그룹에서 개별 기기의 음소거 상태를 설정합니다.

이는 비동기 작업입니다.

Parameters
mutedThe new muted state.
deviceThe multizone device.
반환 값
요청을 추적하는 GCKRequest 객체입니다.
- (GCKRequest *) requestMultizoneStatus

멀티 영역 그룹에서 멀티 영역 상태를 요청합니다.

이는 비동기 작업입니다. 멀티 영역 상태가 수신되면 castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) 위임 메서드에 메시지가 전송됩니다.

반환 값
요청을 추적하는 GCKRequest 객체입니다.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID 

기본 옵션을 사용하여 지정된 기기의 새 세션 객체를 초기화합니다.

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

지정된 기기의 새 세션 객체를 초기화합니다.

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
sessionOptionsThe session options, if any; otherwise nil.
다음 이후:
4.0
- (GCKRequest *) setDeviceVolume: (float)  volume

기기의 볼륨을 설정합니다.

이는 비동기 작업입니다. 기본 구현은 GCKErrorCodeUnsupportedFeature 오류와 함께 요청에 실패하는 노옵스(no-ops)입니다.

Parameters
volumeThe new volume.
반환 값
요청을 추적하는 GCKRequest 객체입니다.
다음 이후:
3.4. 이전 프레임워크 버전에서는 이 메서드가 void를 반환했습니다.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

기기의 음소거 상태를 설정합니다.

이는 비동기 작업입니다. 기본 구현은 GCKErrorCodeUnsupportedFeature 오류와 함께 요청에 실패하는 노옵스(no-ops)입니다.

Parameters
mutedThe new mute state.
반환 값
요청을 추적하는 GCKRequest 객체입니다.
다음 이후:
3.4. 이전 프레임워크 버전에서는 이 메서드가 void를 반환했습니다.
- (void) start

세션을 시작합니다.

이는 비동기 작업입니다. 서브클래스에서 재정의해야 합니다.

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

- (void) endWithAction: (GCKSessionEndAction action

지정된 작업으로 세션을 종료합니다.

이는 비동기 작업입니다. 서브클래스에서 재정의해야 합니다.

Parameters
actionThe action to take when ending the session; see GCKSessionEndAction for more details.

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

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

세션이 시작되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다.

Parameters
sessionIDThe session's unique ID.

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

- (void) notifyDidFailToStartWithError: (GCKError *)  error

세션 시작에 실패했음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다.

Parameters
errorThe error that occurred.

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

- (void) notifyDidEndWithError: (nullable NSError *)  error
willTryToResume: (BOOL)  willTryToResume 

프레임워크에 세션이 종료되었음을 알리기 위해 서브클래스에서 호출합니다.

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.
willTryToResumeWhether the session will try to resume itself automatically.

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

- (void) notifyDidReceiveDeviceVolume: (float)  volume
muted: (BOOL)  muted 

업데이트된 기기 볼륨 및 음소거 상태가 기기에서 수신되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다.

Parameters
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

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

- (void) notifyDidReceiveDeviceStatus: (nullable NSString *)  statusText

업데이트된 상태가 기기에서 수신되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다.

Parameters
statusTextThe new status.

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

지원 중단되었습니다. 사용하지 마세요. 노옵스(no-ops)로 구현되었습니다.

Deprecated:
전화를 걸지 마세요.

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

- (void) notifyDidResume

지원 중단되었습니다. 사용하지 마세요. 노옵스(no-ops)로 구현되었습니다.

Deprecated:
전화를 걸지 마세요.

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

부동산 세부정보

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

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

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

기기의 현재 '대기' 상태

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

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

- (GCKDevice*) device
readnonatomicstronginherited

이 세션이 연결된 기기입니다.

- (NSString*) sessionID
readnonatomiccopyinherited

현재 세션 ID입니다(있는 경우).

- (GCKSessionOptions*) sessionOptions
readnonatomicstronginherited

세션 옵션입니다(있는 경우).

다음 이후:
4.0
- (GCKConnectionState) connectionState
readnonatomicassigninherited

현재 세션 연결 상태입니다.

- (BOOL) suspended
readnonatomicassigninherited

세션이 현재 정지되었는지 여부를 나타내는 플래그입니다.

Deprecated:
GCKSession은(는) 더 이상 정지 상태를 지원하지 않습니다. 필요한 경우 이 기능을 서브클래스로 이동합니다.
- (NSString*) deviceStatusText
readnonatomiccopyinherited

현재 기기 상태 텍스트입니다.

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

세션 특성입니다.

- (float) currentDeviceVolume
readnonatomicassigninherited

현재 기기 볼륨으로, [0.0, 1.0] 범위입니다.

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

현재 기기 음소거 상태입니다.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

이 세션에서 미디어 재생을 제어하는 데 사용할 수 있는 GCKRemoteMediaClient 객체입니다.

세션이 시작되기 전 또는 세션이 GCKRemoteMediaClient API를 지원하지 않는 경우 nil입니다. GCKRemoteMediaClient 인터페이스를 제공하는 서브클래스는 getter 메서드를 재정의해야 합니다.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstronginherited

현재 미디어 메타데이터입니다(있는 경우).

세션이 미디어 네임스페이스를 지원하지 않거나 현재 수신기에 로드된 미디어가 없는 경우 nil입니다.