概要
デバイスの検出プロセスを管理するクラス。
GCKDiscoveryManager は、GCKDeviceProvider サブクラス インスタンスのコレクションを管理します。各インスタンスはそれぞれ、特定のタイプのデバイスを検出する役割を担います。また、現在検出されているデバイスを辞書順のリストで保持します。
フレームワークは、アプリがフォアグラウンドに移動すると自動的に検出プロセスを開始し、アプリがバックグラウンドに移動すると一時停止します。通常、キャスト機能を使用しないアプリケーション領域でネットワーク トラフィックと CPU 使用率を低減するための最適化手段として、startDiscovery (GCKDiscoveryManager) と stopDiscovery (GCKDiscoveryManager) をアプリで呼び出す必要はありません。
アプリが GCKUICastButton を使用するか、直接提示して、フレームワークのキャスト ダイアログを使用している場合、そのダイアログは GCKDiscoveryManager を使用して使用可能なデバイスのリストを入力します。ただし、アプリが独自のデバイス選択/制御ダイアログ UI を提供する場合は、GCKDiscoveryManager とそれに関連するリスナー プロトコル（GCKDiscoveryManagerListener）を使用して、使用可能なデバイスのリストを追加し、更新する必要があります。
- 開始:
- 3.0
NSObject を継承します。
インスタンス メソッドの概要 | |
| (instancetype) | - init |
| デフォルトのイニシャライザは使用できません。その他... | |
| (void) | - addListener: |
| 検出通知を受け取るリスナーを追加します。その他... | |
| (void) | - removeListener: |
| 以前に登録されたリスナーを削除します。その他... | |
| (void) | - startDiscovery |
| 検出プロセスを開始します。その他... | |
| (void) | - stopDiscovery |
| 検出プロセスを停止します。その他... | |
| (BOOL) | - isDiscoveryActiveForDeviceCategory: |
| 指定されたデバイス カテゴリで検出が現在アクティブかどうかをテストします。その他... | |
| (GCKDevice *) | - deviceAtIndex: |
| マネージャーが検出したデバイスのリスト内で、指定したインデックスにあるデバイスを返します。その他... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| マネージャーが検出したデバイスのリスト内で、指定された一意の ID を持つデバイスを返します。その他... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| 指定された一意の ID を持つデバイスが検出されるのを待ってから、完了ブロックを呼び出します。その他... | |
| (void) | - cancelFindOperation |
| findDeviceWithUniqueID:timeout:completion: によって開始された、進行中の検索オペレーションをキャンセルします。その他... | |
プロパティの概要 | |
| GCKDiscoveryState | discoveryState |
| 現在の検出状態。その他... | |
| BOOL | hasDiscoveredDevices |
| このオブジェクトによって管理されている検出プロバイダのいずれかによってデバイスが検出されたかどうかを示すフラグ。その他... | |
| BOOL | passiveScan |
| 検出で「パッシブ」スキャンを使用するかどうかを示すフラグ。その他... | |
| BOOL | discoveryActive |
| 検出が有効かどうかを示すフラグ。その他... | |
| NSUInteger | deviceCount |
| 現在検出されたデバイスの数。その他... | |
メソッドの詳細
| - (instancetype) init |
デフォルトのイニシャライザは使用できません。
| - (void) addListener: | (id< GCKDiscoveryManagerListener >) | listener |
検出通知を受け取るリスナーを追加します。
追加されたリスナーは弱く保持されるため、予期しない割り当て解除を避けるために保持する必要があります。
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
以前に登録されたリスナーを削除します。
- Parameters
-
listener The listener to remove.
| - (void) startDiscovery |
検出プロセスを開始します。
| - (void) stopDiscovery |
検出プロセスを停止します。
| - (BOOL) isDiscoveryActiveForDeviceCategory: | (NSString *) | deviceCategory |
指定されたデバイス カテゴリで検出が現在アクティブかどうかをテストします。
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
マネージャーが検出したデバイスのリスト内で、指定したインデックスにあるデバイスを返します。
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
マネージャーが検出したデバイスのリスト内で、指定された一意の ID を持つデバイスを返します。
- Parameters
-
uniqueID The device's unique ID.
- 戻り値
- 一致する GCKDevice オブジェクト。一致するデバイスが見つからなかった場合は
nil。
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
指定された一意の ID を持つデバイスが検出されるのを待ってから、完了ブロックを呼び出します。
一致するデバイスが検出されたデバイスのリストにすでに存在する場合、完了ブロックは直ちに（ただしこのメソッドが返されると）呼び出されます。アクティブにできる検索オペレーションは一度に 1 つのみです。別の検索オペレーションが進行中のときに新しい検索オペレーションを開始すると、現在の検索オペレーションはキャンセルされます。
- Parameters
-
uniqueID The unique ID of the device. timeout The maximum amount of time to wait for the device to be discovered. completion The completion block to invoke when either the device is found or the timeout is reached. The device (if found) or nil(if not found) will be passed to the completion block.
- 開始:
- 4.0
| - (void) cancelFindOperation |
findDeviceWithUniqueID:timeout:completion: によって開始された、進行中の検索オペレーションをキャンセルします。
- 開始:
- 4.0
物件の詳細
|
readnonatomicassign |
現在の検出状態。
|
readnonatomicassign |
このオブジェクトによって管理されている検出プロバイダのいずれかによってデバイスが検出されたかどうかを示すフラグ。
|
readwritenonatomicassign |
検出で「パッシブ」スキャンを使用するかどうかを示すフラグ。
パッシブ スキャンはリソースを消費しませんが、アクティブ スキャンほど新しい結果は得られません。
|
readnonatomicassign |
検出が有効かどうかを示すフラグ。
- 開始:
- 3.4
|
readnonatomicassign |
現在検出されたデバイスの数。