GCKSession 클래스

GCKSession 클래스 참조

개요

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

서브클래스는 start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)), resume (GCKSession(Protected)) 메서드를 구현해야 하며 적절한 알리미 메서드 (예: notifyDidStartWithSessionID: (GCKSession(Protected)))를 호출하여 세션 상태의 상응하는 변경사항을 표시해야 합니다. 기기에서 이러한 작업을 지원하는 경우 서브클래스도 setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession), remoteMediaClient를 구현할 수 있습니다.

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

Since
3.0

NSObject를 상속합니다.

GCKCastSession에서 상속되었습니다.

인스턴스 메서드 요약

(instancetype) - initWithDevice:traits:sessionID:
 지정된 기기의 새 세션 객체를 초기화합니다. 더보기...
 
(GCKRequest *) - setDeviceVolume:
 기기의 볼륨을 설정합니다. 더보기...
 
(GCKRequest *) - setDeviceMuted:
 기기의 음소거 상태를 설정합니다. 더보기...
 
(void) - start
 세션을 시작합니다. 더보기...
 
(void) - endAndStopCasting:
 세션을 종료합니다. 더보기...
 
(void) - suspendWithReason:
 지정된 이유로 세션을 정지합니다. 더보기...
 
(void) - resume
 세션을 재개합니다. 더보기...
 
(void) - notifyDidStartWithSessionID:
 서브클래스가 호출하여 세션이 시작되었음을 프레임워크에 알립니다. 더보기...
 
(void) - notifyDidFailToStartWithError:
 세션 시작에 실패했음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidResume
 서브클래스에 의해 호출되어 프레임워크에 세션이 재개되었음을 알립니다. 더보기...
 
(void) - notifyDidSuspendWithReason:
 서브클래스에 의해 호출되어 프레임워크에 세션이 정지되었음을 알립니다. 더보기...
 
(void) - notifyDidEndWithError:
 프레임워크에 의해 호출되어 프레임워크에 세션 종료를 알립니다. 더보기...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 업데이트된 기기 볼륨과 음소거 상태가 기기에서 수신되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 
(void) - notifyDidReceiveDeviceStatus:
 업데이트된 상태가 기기에서 수신되었음을 프레임워크에 알리기 위해 서브클래스에서 호출합니다. 더보기...
 

속성 요약

GCKDevicedevice
 이 세션이 연결된 기기입니다. 더보기...
 
NSString * sessionID
 현재 세션 ID입니다(있는 경우). 더보기...
 
GCKConnectionState connectionState
 현재 세션 연결 상태입니다. 더보기...
 
BOOL suspended
 세션이 현재 정지되었는지 나타내는 플래그입니다. 더보기...
 
NSString * deviceStatusText
 현재 기기 상태 텍스트입니다. 더보기...
 
GCKSessionTraitstraits
 세션의 특성. 더보기...
 
float currentDeviceVolume
 현재 기기 볼륨 범위([0.0, 1.0])입니다. 더보기...
 
BOOL currentDeviceMuted
 현재 기기의 음소거 상태입니다. 더보기...
 
GCKRemoteMediaClientremoteMediaClient
 이 세션에서 미디어 재생을 제어하는 데 사용할 수 있는 GCKRemoteMediaClient 객체입니다. 더보기...
 
GCKMediaMetadatamediaMetadata
 현재 미디어 메타데이터(있는 경우)입니다. 더보기...
 

메서드 세부정보

- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (GCKSessionTraits *)  traits
sessionID: (NSString *__nullable)  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.
- (GCKRequest *) setDeviceVolume: (float)  volume

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

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

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

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

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

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

세션을 시작합니다.

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

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) endAndStopCasting: (BOOL)  stopCasting

세션을 종료합니다.

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

Parameters
stopCastingWhether to stop casting content to the receiver.

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

지정된 이유로 세션을 정지합니다.

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

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) resume

세션을 재개합니다.

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

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

서브클래스가 호출하여 세션이 시작되었음을 프레임워크에 알립니다.

Parameters
sessionIDThe session's unique ID.

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) notifyDidFailToStartWithError: (NSError *)  error

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

Parameters
errorThe error that occurred.

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) notifyDidResume

서브클래스에 의해 호출되어 프레임워크에 세션이 재개되었음을 알립니다.

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

서브클래스에 의해 호출되어 프레임워크에 세션이 정지되었음을 알립니다.

Parameters
reasonThe reason for the suspension.

GCKSession(Protected) 카테고리에서 제공합니다.

- (void) notifyDidEndWithError: (NSError *__nullable)  error

프레임워크에 의해 호출되어 프레임워크에 세션 종료를 알립니다.

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.

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: (NSString *__nullable)  statusText

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

Parameters
statusTextThe new status.

GCKSession(Protected) 카테고리에서 제공합니다.

부동산 세부정보

- (GCKDevice*) device
readnonatomicstrong

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

- (NSString*) sessionID
readnonatomiccopy

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

- (GCKConnectionState) connectionState
readnonatomicassign

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

- (BOOL) suspended
readnonatomicassign

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

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