Übersicht
Eine Klasse, die den Geräteerkennungsprozess verwaltet.
GCKDiscoveryManager verwaltet eine Sammlung von GCKDeviceProvider-Unterklassen, von denen jede für die Erkennung von Geräten eines bestimmten Typs verantwortlich ist. Außerdem wird eine lexikografisch geordnete Liste der aktuell gefundenen Geräte geführt.
Das Framework startet automatisch den Erkennungsprozess, wenn die Anwendung in den Vordergrund verschoben wird, und unterbricht sie, wenn die Anwendung in den Hintergrund verschoben wird. Im Allgemeinen ist es nicht erforderlich, dass die Anwendung startDiscovery (GCKDiscoveryManager) und stopDiscovery (GCKDiscoveryManager) aufruft, außer als Optimierungsmaßnahme zur Reduzierung des Netzwerkverkehrs und der CPU-Auslastung in Bereichen der Anwendung, in denen die Cast-Funktion nicht verwendet wird.
Wenn die Anwendung das Cast-Dialogfeld des Frameworks verwendet, entweder über GCKUICastButton oder durch direkte Präsentation, verwendet dieses Dialogfeld GCKDiscoveryManager, um die Liste der verfügbaren Geräte auszufüllen. Wenn die Anwendung jedoch eine eigene Benutzeroberfläche für die Geräteauswahl/-steuerung bereitstellt, sollte sie GCKDiscoveryManager und das zugehörige Listener-Protokoll GCKDiscoveryManagerListener verwenden, um die Liste der verfügbaren Geräte auszufüllen und zu aktualisieren.
- Sincé
- 3,0
Übernimmt NSObject.
Zusammenfassung der Instanzmethoden | |
| (instancetype) | - init |
| Der Standard-Initialisierer ist nicht verfügbar. Mehr... | |
| (void) | - addListener: |
| Fügt einen Listener hinzu, der Erkennungsbenachrichtigungen erhält. Mehr... | |
| (void) | - removeListener: |
| Entfernt einen zuvor registrierten Listener. Mehr... | |
| (void) | - startDiscovery |
| Startet den Erkennungsprozess. Mehr... | |
| (void) | - stopDiscovery |
| Stoppt den Erkennungsprozess. Mehr... | |
| (BOOL) | - isDiscoveryActiveForDeviceCategory: |
| Testet, ob die Erkennung für die angegebene Gerätekategorie derzeit aktiv ist. Mehr... | |
| (GCKDevice *) | - deviceAtIndex: |
| Gibt das Gerät am angegebenen Index in der Liste der erkannten Geräte des Managers zurück. Mehr... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| Gibt das Gerät mit der angegebenen eindeutigen ID in der Liste der gefundenen Geräte zurück. Mehr... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| Wartet, bis ein Gerät mit der angegebenen eindeutigen ID erkannt wurde, und löst einen Abschlussblock aus. Mehr... | |
| (void) | - cancelFindOperation |
| Brechen laufende laufende Suchvorgänge ab, die von findDeviceWithUniqueID:timeout:completion: gestartet wurden. Mehr... | |
Property-Zusammenfassung | |
| GCKDiscoveryState | discoveryState |
| Der aktuelle Erkennungsstatus. Mehr... | |
| BOOL | hasDiscoveredDevices |
| Ein Flag, das angibt, ob Geräte von einem der von diesem Objekt verwalteten Erkennungsanbieter gefunden wurden. Mehr... | |
| BOOL | passiveScan |
| Ein Flag, das angibt, ob bei der Erkennung ein „passiver“ Scan verwendet werden soll. Mehr... | |
| BOOL | discoveryActive |
| Eine Markierung, die angibt, ob die Erkennung aktiv ist oder nicht. Mehr... | |
| NSUInteger | deviceCount |
| Die Anzahl der aktuell gefundenen Geräte. Mehr... | |
Methodendetail
| - (instancetype) init |
Der Standard-Initialisierer ist nicht verfügbar.
| - (void) addListener: | (id< GCKDiscoveryManagerListener >) | listener |
Fügt einen Listener hinzu, der Erkennungsbenachrichtigungen erhält.
Der hinzugefügte Listener wird nur eingeschränkt zur Verfügung gestellt und sollte aufbewahrt werden, um eine unerwartete Dealverteilung zu vermeiden.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
Entfernt einen zuvor registrierten Listener.
- Parameters
-
listener The listener to remove.
| - (void) startDiscovery |
Startet den Erkennungsprozess.
| - (void) stopDiscovery |
Stoppt den Erkennungsprozess.
| - (BOOL) isDiscoveryActiveForDeviceCategory: | (NSString *) | deviceCategory |
Testet, ob die Erkennung für die angegebene Gerätekategorie derzeit aktiv ist.
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
Gibt das Gerät am angegebenen Index in der Liste der erkannten Geräte des Managers zurück.
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
Gibt das Gerät mit der angegebenen eindeutigen ID in der Liste der gefundenen Geräte zurück.
- Parameters
-
uniqueID The device's unique ID.
- Gibt Folgendes zurück:
- Das übereinstimmende GCKDevice-Objekt oder
nil, wenn kein übereinstimmendes Gerät gefunden wurde.
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
Wartet, bis ein Gerät mit der angegebenen eindeutigen ID erkannt wurde, und löst einen Abschlussblock aus.
Wenn sich ein übereinstimmendes Gerät bereits in der Liste der erkannten Geräte befindet, wird der Vervollständigungsblock sofort aufgerufen (aber nachdem diese Methode zurückgegeben wird). Es kann immer nur ein Suchvorgang aktiv sein. Wenn Sie einen neuen Suchvorgang starten, während ein anderer ausgeführt wird, wird der aktuelle Suchvorgang abgebrochen.
- 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.
- Sincé
- 4,0
| - (void) cancelFindOperation |
Brechen laufende laufende Suchvorgänge ab, die von findDeviceWithUniqueID:timeout:completion: gestartet wurden.
- Sincé
- 4,0
Property-Details
|
readnonatomicassign |
Der aktuelle Erkennungsstatus.
|
readnonatomicassign |
Ein Flag, das angibt, ob Geräte von einem der von diesem Objekt verwalteten Erkennungsanbieter gefunden wurden.
|
readwritenonatomicassign |
Ein Flag, das angibt, ob bei der Erkennung ein „passiver“ Scan verwendet werden soll.
Passive Scans sind weniger ressourcenintensiv, liefern jedoch keine Ergebnisse, die so aktuell sind wie aktive Scans.
|
readnonatomicassign |
Eine Markierung, die angibt, ob die Erkennung aktiv ist oder nicht.
- Sincé
- 3,4
|
readnonatomicassign |
Die Anzahl der aktuell gefundenen Geräte.