GCKSession 클래스

GCKSession 클래스 참조

개요

수신 기기와의 세션을 나타내는 추상 기본 클래스입니다.

서브클래스는 start (GCKSession(Protected))endWithAction: (GCKSession(Protected)) 메서드를 구현해야 하며, 적절한 알림 메서드 (예: notifyDidStartWithSessionID: (GCKSession(Protected)))를 호출하여 세션 상태의 상응하는 변경사항을 나타내야 합니다. 기기에서 setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession), remoteMediaClient 등의 작업을 지원하면 서브클래스로도 구현할 수 있습니다.

세션은 GCKSessionManager의 세션 메서드를 사용하여 생성되고 제어되며, 이 메서드는 적절한 GCKDeviceProvider를 사용하여 세션을 만든 후 이 GCKSession 객체에 세션 요청을 위임합니다.

다음 이후:
3.0

NSObject를 상속합니다.

GCKCastSession에서 상속됩니다.

인스턴스 메서드 요약

(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)로 구현되었습니다. 더보기...
 

속성 요약

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
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) 카테고리별로 제공됩니다.

부동산 세부정보

- (GCKDevice*) device
readnonatomicstrong

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

- (NSString*) sessionID
readnonatomiccopy

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

- (GCKSessionOptions*) sessionOptions
readnonatomicstrong

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

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

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

- (BOOL) suspended
readnonatomicassign

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

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

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

- (GCKSessionTraits*) traits
readnonatomiccopy

세션 특성입니다.

- (float) currentDeviceVolume
readnonatomicassign

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

- (BOOL) currentDeviceMuted
readnonatomicassign

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

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstrong

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

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

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstrong

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

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