概要
デバイス検出プロセスを管理するクラス。
GCKDiscoveryManager は GCKDeviceProvider サブクラス インスタンスのコレクションを管理します。各インスタンス インスタンスは、特定のタイプのデバイスを検出する役割を果たします。また、現在検出されたデバイスのリストも、辞書順に並べられた状態で維持されます。
フレームワークは、アプリがフォアグラウンドに移動したときに自動的に検出プロセスを開始し、アプリがバックグラウンドに移動したときに一時停止します。通常、アプリで startDiscovery (GCKDiscoveryManager) や stopDiscovery (GCKDiscoveryManager) を呼び出す必要はありません。ただし、キャスト機能を使用しないアプリ内の領域で、ネットワーク トラフィックと CPU 使用率を削減するための最適化手段としては例外です。
アプリが 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 |
現在検出されたデバイスの数。