Überblick
Eine Klasse, die den Geräteerkennungsprozess verwaltet.
GCKDiscoveryManager verwaltet eine Sammlung von GCKDeviceProvider-Unterklasseninstanzen, 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 den Erkennungsprozess automatisch, wenn die Anwendung in den Vordergrund wechselt, und hält sie an, wenn die Anwendung in den Hintergrund verschoben wird. Im Allgemeinen ist es nicht erforderlich, dass die App startDiscovery (GCKDiscoveryManager) und stopDiscovery (GCKDiscoveryManager) aufruft, außer zur Optimierung zur Reduzierung des Netzwerkverkehrs und der CPU-Auslastung in Bereichen der App, in denen keine Cast-Funktion verwendet wird.
Wenn die App 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 zu füllen. Wenn die Anwendung jedoch ihre eigene Benutzeroberfläche für den Dialog zur Geräteauswahl und -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.
- Seit
- 3,0
Übernimmt NSObject.
Übersicht über Instanzmethoden | |
| (instancetype) | - init |
| Standardinitialisierer 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 im 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 erkannten Geräte des Managers zurück. Mehr... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| Wartet, bis ein Gerät mit der angegebenen eindeutigen ID gefunden wird, und ruft einen Abschlussblock auf. Mehr... | |
| (void) | - cancelFindOperation |
| Bricht alle laufenden Suchvorgänge ab, die mit 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 erkannt wurden. Mehr... | |
| BOOL | passiveScan |
| Ein Flag, das angibt, ob bei der Erkennung ein „passiver“ Scan verwendet werden soll. Mehr... | |
| BOOL | discoveryActive |
| Ein Flag, das angibt, ob die Erkennung aktiv ist oder nicht. Mehr... | |
| NSUInteger | deviceCount |
| Die Anzahl der aktuell erkannten Geräte. Mehr... | |
Methodendetail
| - (instancetype) init |
Standardinitialisierer ist nicht verfügbar.
| - (void) addListener: | (id< GCKDiscoveryManagerListener >) | listener |
Fügt einen Listener hinzu, der Erkennungsbenachrichtigungen erhält.
Der hinzugefügte Listener ist schwach gehalten und sollte beibehalten werden, um eine unerwartete Zuordnung 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 im 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 erkannten Geräte des Managers zurück.
- Parameters
-
uniqueID The device's unique ID.
- Rückgaben
- Das übereinstimmende GCKDevice-Objekt oder
nil, wenn kein passendes 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 gefunden wird, und ruft einen Abschlussblock auf.
Wenn sich ein passendes Gerät bereits in der Liste der gefundenen Geräte befindet, wird die Vervollständigungsfunktion sofort aufgerufen (aber nach der Rückgabe dieser Methode). Es kann immer nur ein Suchvorgang aktiv sein. Wenn Sie einen neuen Suchvorgang starten, während ein anderer ausgeführt wird, wird der aktuelle 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.
- Seit
- 4,0
| - (void) cancelFindOperation |
Bricht alle laufenden Suchvorgänge ab, die mit findDeviceWithUniqueID:timeout:completion: gestartet wurden.
- Seit
- 4,0
Objektdetails
|
readnonatomicassign |
Der aktuelle Erkennungsstatus.
|
readnonatomicassign |
Ein Flag, das angibt, ob Geräte von einem der von diesem Objekt verwalteten Erkennungsanbieter erkannt wurden.
|
readwritenonatomicassign |
Ein Flag, das angibt, ob bei der Erkennung ein „passiver“ Scan verwendet werden soll.
Passive Scans sind weniger ressourcenintensiv, liefern aber keine Ergebnisse, die so aktuell sind wie aktive Scans.
|
readnonatomicassign |
Ein Flag, das angibt, ob die Erkennung aktiv ist oder nicht.
- Seit
- 3,4
|
readnonatomicassign |
Die Anzahl der aktuell erkannten Geräte.