GCKDiscoveryManager クラス

GCKDiscoveryManager クラス リファレンス

概要

デバイスの検出プロセスを管理するクラス。

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
listenerThe listener to add.
- (void) removeListener: (id< GCKDiscoveryManagerListener >)  listener

以前に登録されたリスナーを削除します。

Parameters
listenerThe listener to remove.
- (void) startDiscovery

検出プロセスを開始します。

- (void) stopDiscovery

検出プロセスを停止します。

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

指定されたデバイス カテゴリで検出が現在アクティブかどうかをテストします。

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

マネージャーが検出したデバイスのリスト内で、指定したインデックスにあるデバイスを返します。

- (nullable GCKDevice *) deviceWithUniqueID: (NSString *)  uniqueID

マネージャーが検出したデバイスのリスト内で、指定された一意の ID を持つデバイスを返します。

Parameters
uniqueIDThe device's unique ID.
戻り値
一致する GCKDevice オブジェクト。一致するデバイスが見つからなかった場合は nil
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

指定された一意の ID を持つデバイスが検出されるのを待ってから、完了ブロックを呼び出します。

一致するデバイスが検出されたデバイスのリストにすでに存在する場合、完了ブロックは直ちに(ただしこのメソッドが返されると)呼び出されます。アクティブにできる検索オペレーションは一度に 1 つのみです。別の検索オペレーションが進行中のときに新しい検索オペレーションを開始すると、現在の検索オペレーションはキャンセルされます。

Parameters
uniqueIDThe unique ID of the device.
timeoutThe maximum amount of time to wait for the device to be discovered.
completionThe 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

物件の詳細

- (GCKDiscoveryState) discoveryState
readnonatomicassign

現在の検出状態。

- (BOOL) hasDiscoveredDevices
readnonatomicassign

このオブジェクトによって管理されている検出プロバイダのいずれかによってデバイスが検出されたかどうかを示すフラグ。

- (BOOL) passiveScan
readwritenonatomicassign

検出で「パッシブ」スキャンを使用するかどうかを示すフラグ。

パッシブ スキャンはリソースを消費しませんが、アクティブ スキャンほど新しい結果は得られません。

- (BOOL) discoveryActive
readnonatomicassign

検出が有効かどうかを示すフラグ。

開始:
3.4
- (NSUInteger) deviceCount
readnonatomicassign

現在検出されたデバイスの数。