概要
セッションを管理するクラス。
メソッド startSessionWithDevice: (GCKSessionManager) は、指定された GCKDevice を使用して新しいセッションを作成するために使用されます。セッション マネージャーは、そのデバイスタイプの GCKDeviceProvider を使用して新しい GCKSession オブジェクトを構築し、すべてのセッション リクエストをそのオブジェクトに委任します。
GCKSessionManager は、一時停止したセッションの自動再開を処理します（つまり、アプリがバックグラウンドに移動したとき、アプリがクラッシュしたとき、またはユーザーがアプリを強制終了したときに終了したセッションを再開します）。アプリケーションが再開または再起動すると、セッション マネージャーは、一時停止されたセッションのデバイスのデバイス プロバイダがそのデバイスを再度検出するまで短時間待機します。検出された場合、そのデバイスへの再接続とセッションの再確立が自動的に試行されます。
アプリケーションがターゲットとセレクタを指定せずに GCKUICastButton を作成した場合、ユーザーがボタンをタップするとデフォルトのキャスト ダイアログが表示され、ユーザーがデバイスを選択または切断すると、セッションが自動的に開始または停止します。ただし、アプリが独自のデバイス選択/制御ダイアログ UI を提供している場合は、GCKSessionManager を直接使用してセッションを作成し、制御する必要があります。
アプリケーションが GCKSessionManager を使用してセッションを制御するかどうかにかかわらず、GCKSessionManagerListener をアタッチしてセッション イベントの通知を受け取ることができます。また、KVO を使用して connectionState プロパティをモニタリングし、現在のセッション ライフサイクル状態を追跡することもできます。
- 発足
- 3.0
NSObject を継承します。
インスタンス メソッドの概要 | |
| (instancetype) | - init |
| デフォルトのイニシャライザは使用できません。詳細... | |
| (BOOL) | - startSessionWithDevice: |
| 指定されたデバイスで新しいセッションを開始します。詳細... | |
| (BOOL) | - suspendSessionWithReason: |
| 現在のセッションを一時停止します。詳細... | |
| (BOOL) | - endSession |
| 現在のセッションを終了します。詳細... | |
| (BOOL) | - endSessionAndStopCasting: |
| 現在のセッションを終了します。必要に応じて、キャストを停止します。詳細... | |
| (BOOL) | - hasConnectedSession |
| セッションが現在このセッション マネージャーによって管理されており、現在接続されているかどうかをテストします。詳細... | |
| (BOOL) | - hasConnectedCastSession |
| キャスト セッションが現在このセッション マネージャーによって管理されており、現在接続されているかどうかをテストします。詳細... | |
| (void) | - addListener: |
| 通知を受け取るためのリスナーを追加します。詳細... | |
| (void) | - removeListener: |
| addListener: で以前に追加されたリスナーを削除します。詳細... | |
プロパティの概要 | |
| GCKSession * | currentSession |
| 現在のセッション（存在する場合）。詳細... | |
| GCKCastSession * | currentCastSession |
| 現在のキャスト セッション（存在する場合）。詳細... | |
| GCKConnectionState | connectionState |
| 現在のセッション接続状態。詳細... | |
メソッドの詳細
| - (instancetype) init |
デフォルトのイニシャライザは使用できません。
| - (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
指定されたデバイスで新しいセッションを開始します。
これは非同期オペレーションです。
- Parameters
-
device The device to use for this session.
- 戻り値 オペレーションが正常に開始された場合は
YES、現在セッションが確立されている場合またはオペレーションを開始できなかった場合はNO。
| - (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
現在のセッションを一時停止します。
これは非同期オペレーションです。
- Parameters
-
reason The reason for the suspension.
- 戻り値 オペレーションが正常に開始された場合は
YES、現在確立されているセッションがない場合やオペレーションを開始できなかった場合はNO。
| - (BOOL) endSession |
現在のセッションを終了します。
これは非同期オペレーションです。
- 戻り値 オペレーションが正常に開始された場合は
YES、現在確立されているセッションがない場合やオペレーションを開始できなかった場合はNO。
| - (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
現在のセッションを終了します。必要に応じて、キャストを停止します。
これは非同期オペレーションです。
- Parameters
-
stopCasting Whether casting of content on the receiver should be stopped when the session is ended.
- 戻り値 オペレーションが正常に開始された場合は
YES、現在確立されているセッションがない場合やオペレーションを開始できなかった場合はNO。
| - (BOOL) hasConnectedSession |
セッションが現在このセッション マネージャーによって管理されており、現在接続されているかどうかをテストします。
セッションの状態が GCKConnectionStateConnected の場合、これは YES になります。
| - (BOOL) hasConnectedCastSession |
キャスト セッションが現在このセッション マネージャーによって管理されており、現在接続されているかどうかをテストします。
セッションの状態が GCKConnectionStateConnected で、セッションがキャスト セッションの場合、これは YES になります。
| - (void) addListener: | (id< GCKSessionManagerListener >) | listener |
通知を受け取るリスナーを追加します。
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
addListener: で以前に追加されたリスナーを削除します。
- Parameters
-
listener The listener to remove.
プロパティの詳細
|
readnonatomicstrong |
現在のセッション（存在する場合）。
|
readnonatomicstrong |
現在のキャスト セッション（該当する場合）。
|
readnonatomicassign |
現在のセッション接続状態。