概要

受信デバイスとのセッションを表す抽象基本クラス。

サブクラスは、start (GCKSession(Protected)) メソッドと endWithAction: (GCKSession(Protected)) メソッドを実装し、適切な Notifier メソッド（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:
	非推奨。使用不可。NoOps として実装。詳細...

(void)	- notifyDidResume
	非推奨。使用不可。NoOps として実装。詳細...

プロパティの概要
GCKDevice *	device
	このセッションが関連付けられているデバイス。その他

NSString *	sessionID
	現在のセッション ID（ある場合）。その他

GCKSessionOptions *	sessionOptions
	セッションオプション（ある場合）。その他

GCKConnectionState	connectionState
	現在のセッション接続状態。その他

BOOL	suspended
	セッションが現在停止中かどうかを示すフラグ。その他

NSString *	deviceStatusText
	現在のデバイスのステータステキスト。その他

GCKSessionTraits *	traits
	セッショントレイト。その他

float	currentDeviceVolume
	デバイスの現在の音量（0.0 ～ 1.0 の範囲）。その他

BOOL	currentDeviceMuted
	デバイスの現在のミュート状態。その他

GCKRemoteMediaClient *	remoteMediaClient
	このセッションでメディアの再生を制御するために使用できる GCKRemoteMediaClient オブジェクト。その他

GCKMediaMetadata *	mediaMetadata
	現在のメディアメタデータ（ある場合）。その他

メソッドの詳細

- (instancetype) initWithDevice:	(GCKDevice *)	device
traits:	(nullable GCKSessionTraits *)	traits
sessionID:	(nullable NSString *)	sessionID

デフォルトのオプションを使用して、指定されたデバイスの新しいセッションオブジェクトを初期化します。

Parameters

device	The device.
traits	The session traits.
sessionID	The 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

device	The device.
traits	The session traits.
sessionID	The 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.
sessionOptions	The session options, if any; otherwise `nil`.

開始:: 4.0

- (GCKRequest *) setDeviceVolume: (float) volume

デバイスの音量を設定します。

これは非同期処理です。デフォルトの実装は、GCKErrorCodeSupportedFeature エラーでリクエストが失敗する no-op です。

Parameters

volume The new volume.

戻り値: リクエストをトラッキングするための GCKRequest オブジェクト。

開始:: 3.4: 以前のフレームワークバージョンでは、このメソッドは void を返していました。

- (GCKRequest *) setDeviceMuted: (BOOL) muted

デバイスのミュート状態を設定します。

これは非同期処理です。デフォルトの実装は、GCKErrorCodeSupportedFeature エラーでリクエストが失敗する no-op です。

Parameters

muted The new mute state.

戻り値: リクエストをトラッキングするための GCKRequest オブジェクト。

開始:: 3.4: 以前のフレームワークバージョンでは、このメソッドは void を返していました。

- (void) start

セッションを開始します。

これは非同期処理です。サブクラスでオーバーライドする必要があります。

カテゴリ GCKSession(Protected) から提供されます。

- (void) endWithAction: (GCKSessionEndAction) action

指定されたアクションでセッションを終了します。

これは非同期処理です。サブクラスでオーバーライドする必要があります。

Parameters

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

カテゴリ GCKSession(Protected) から提供されます。

- (void) notifyDidStartWithSessionID: (NSString *) sessionID

セッションが開始されたことをフレームワークに通知するためにサブクラスによって呼び出されます。

Parameters

sessionID The session's unique ID.

カテゴリ GCKSession(Protected) から提供されます。

- (void) notifyDidFailToStartWithError: (GCKError *) error

セッションが開始されなかったことをフレームワークに通知するためにサブクラスによって呼び出されます。

Parameters

error The error that occurred.

カテゴリ GCKSession(Protected) から提供されます。

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

セッションが終了したことをフレームワークに通知するためにサブクラスによって呼び出されます。

Parameters

error	The error that caused the session to end, if any. Should be `nil` if the session was ended intentionally.
willTryToResume	Whether the session will try to resume itself automatically.

カテゴリ GCKSession(Protected) から提供されます。

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

デバイスの音量とミュート状態の更新がデバイスから受信したことをフレームワークに通知するために、サブクラスによって呼び出されます。

Parameters

volume	The device's current volume. Must be in the range [0, 1.0];
muted	The device's current mute state.

カテゴリ GCKSession(Protected) から提供されます。

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

更新されたステータスがデバイスから受信されたことをフレームワークに通知するために、サブクラスによって呼び出されます。

Parameters

statusText The new status.

カテゴリ GCKSession(Protected) から提供されます。

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

非推奨。使用不可（NoOps）として実装。

Deprecated:: 発信しないでください。

カテゴリ GCKSession(Protected) から提供されます。

- (void) notifyDidResume

非推奨。使用不可（NoOps）として実装。

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 オブジェクト。

セッション開始前 nil の場合、またはセッションが GCKRemoteMediaClient API をサポートしていない場合。GCKRemoteMediaClient インターフェースを提供するサブクラスは、ゲッターメソッドをオーバーライドする必要があります。

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstrong

現在のメディアメタデータ（ある場合）。

セッションがメディア名前空間をサポートしていない場合、またはレシーバにメディアが読み込まれていない場合は、nil になります。

GCKSession クラス

概要

インスタンス メソッドの概要

プロパティの概要

メソッドの詳細

宿泊施設の詳細

インスタンスメソッドの概要