概要

レシーバーデバイスとのキャストセッションを管理するクラス。

セッションは GCKSessionManager によって自動的に作成、管理されます。アプリは、start (GCKSession(Protected)) や endAndStopCasting: (GCKSession(Protected)) などのセッションライフサイクルメソッドを直接呼び出さないようにします。

開始:: 3.0

GCKSession を継承します。

インスタンスメソッドの概要
(instancetype)	- initWithDevice:sessionID:castOptions:
	指定のイニシャライザ。その他...

(BOOL)	- addChannel:
	チャネルをセッションに登録します。その他...

(BOOL)	- removeChannel:
	以前に登録したチャンネルをセッションから削除します。その他...

(void)	- addDeviceStatusListener:
	このオブジェクトのリスナーのリストに GCKCastDeviceStatusListener を追加します。その他...

(void)	- removeDeviceStatusListener:
	このオブジェクトのリスナーのリストから GCKCastDeviceStatusListener を削除します。その他...

(GCKRequest *)	- setDeviceVolume:forMultizoneDevice:
	マルチゾーングループ内の個々のデバイスの音量を設定します。その他...

(GCKRequest *)	- setDeviceMuted:forMultizoneDevice:
	マルチゾーングループ内の個々のデバイスのミュート状態を設定します。その他...

(GCKRequest *)	- requestMultizoneStatus
	マルチゾーングループからマルチゾーンステータスをリクエストします。その他...

(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:
	サブクラスによって呼び出され、更新されたステータスをデバイスから受け取ったことをフレームワークに通知します。その他...

プロパティの概要
GCKActiveInputStatus	activeInputStatus
	デバイスの現在の「アクティブ入力」ステータス。その他...

GCKStandbyStatus	standbyStatus
	デバイスの現在の「スタンバイ」ステータス。その他...

GCKApplicationMetadata *	applicationMetadata
	受信デバイスで現在実行中の受信アプリのメタデータ（存在する場合）。それ以外の場合は `nil`。その他...

GCKDevice *	device
	このセッションが関連付けられているデバイス。その他...

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

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
sessionID:	(NSString *__nullable)	sessionID
castOptions:	(GCKCastOptions *)	castOptions

指定のイニシャライザ。

指定されたキャストオプションで新しいキャストセッションを構築します。

Parameters

device	The receiver device.
sessionID	The session ID, if resuming; otherwise `nil`.
castOptions	The Cast options.

- (BOOL) addChannel: (GCKCastChannel *) channel

チャネルをセッションに登録します。

セッションが接続され、受信側アプリケーションがチャネルの名前空間をサポートしている場合、チャネルは自動的に接続されます。セッションが接続されていない場合、セッションが開始されるまでチャンネルは切断状態のままになります。

Parameters

channel The channel to register.

戻り値: チャンネルが正常に登録された場合は YES、そうでない場合は NO。

- (BOOL) removeChannel: (GCKCastChannel *) channel

以前に登録したチャンネルをセッションから削除します。

Parameters

channel The channel to unregister.

戻り値: チャンネルの登録が正常に解除された場合は YES、そうでない場合は NO。

- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >) listener

このオブジェクトのリスナーのリストに GCKCastDeviceStatusListener を追加します。

Parameters

listener The listener to add.

- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >) listener

このオブジェクトのリスナーのリストから GCKCastDeviceStatusListener を削除します。

Parameters

listener The listener to remove.

- (GCKRequest *) setDeviceVolume:	(float)	volume
forMultizoneDevice:	(GCKMultizoneDevice *)	device

マルチゾーングループ内の個々のデバイスの音量を設定します。

これは非同期処理です。

Parameters

volume	The new volume, in the range [0.0, 1.0].
device	The multizone device.

戻り値: リクエストを追跡するための GCKRequest オブジェクト。

- (GCKRequest *) setDeviceMuted:	(BOOL)	muted
forMultizoneDevice:	(GCKMultizoneDevice *)	device

マルチゾーングループ内の個々のデバイスのミュート状態を設定します。

これは非同期処理です。

Parameters

muted	The new muted state.
device	The multizone device.

戻り値: リクエストを追跡するための GCKRequest オブジェクト。

- (GCKRequest *) requestMultizoneStatus

マルチゾーングループからマルチゾーンステータスをリクエストします。

これは非同期処理です。マルチゾーンステータスを受信すると、castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) デリゲートメソッドにメッセージが送信されます。

戻り値: リクエストを追跡するための GCKRequest オブジェクト。

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

- (GCKRequest *) setDeviceVolume: (float) volume

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

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

Parameters

volume The new volume.

戻り値: リクエストを追跡するための GCKRequest オブジェクト。

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

- (GCKRequest *) setDeviceMuted: (BOOL) muted

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

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

Parameters

muted The new mute state.

戻り値: リクエストを追跡するための GCKRequest オブジェクト。

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

- (void) start

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

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

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

- (void) endAndStopCasting: (BOOL) stopCasting

セッションを終了します。

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

Parameters

stopCasting Whether to stop casting content to the receiver.

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

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

指定した理由でセッションを一時停止します。

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

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

- (void) resume

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

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

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

- (void) notifyDidStartWithSessionID: (NSString *) sessionID

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

Parameters

sessionID The session's unique ID.

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

- (void) notifyDidFailToStartWithError: (NSError *) error

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

Parameters

error The error that occurred.

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

- (void) notifyDidResume

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

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

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

Parameters

reason The reason for the suspension.

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

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

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

Parameters

error The 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

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

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

Parameters

statusText The new status.

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

物件の詳細

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

デバイスの現在の「アクティブ入力」ステータス。

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

デバイスの現在の「スタンバイ」ステータス。

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

受信デバイスで現在実行中の受信アプリのメタデータ（存在する場合）。それ以外の場合は nil。

- (GCKDevice*) device

readnonatomicstronginherited

このセッションが関連付けられているデバイス。

- (NSString*) sessionID

readnonatomiccopyinherited

現在のセッション ID（ある場合）。

- (GCKConnectionState) connectionState

readnonatomicassigninherited

現在のセッションの接続状態。

- (BOOL) suspended

readnonatomicassigninherited

セッションが現在一時停止されているかどうかを示すフラグ。

- (NSString*) deviceStatusText

readnonatomiccopyinherited

現在のデバイスステータスのテキスト。

- (GCKSessionTraits*) traits

readnonatomiccopyinherited

セッショントレイト。

- (float) currentDeviceVolume

readnonatomicassigninherited

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

- (BOOL) currentDeviceMuted

readnonatomicassigninherited

デバイスの現在のミュート状態。

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstronginherited

このセッションでのメディア再生のコントロールに使用できる GCKRemoteMediaClient オブジェクト。

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

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstronginherited

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

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

GCKCastSession クラス コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

概要

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

プロパティの概要

メソッドの詳細

物件の詳細

GCKCastSession クラス

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