GCKDiscoveryManager-Klasse

GCKDiscoveryManager-Klassenreferenz

Übersicht

Eine Klasse, die den Geräteerkennungsprozess verwaltet.

GCKDiscoveryManager verwaltet eine Sammlung von GCKDeviceProvider-Unterklasseninstanzen, die jeweils für die Erkennung von Geräten eines bestimmten Typs verantwortlich sind. Außerdem wird eine lexikografisch sortierte Liste der aktuell erkannten Geräte geführt.

Das Framework startet den Erkennungsprozess automatisch, wenn die Anwendung in den Vordergrund wechselt, und setzt ihn aus, wenn die Anwendung in den Hintergrund wechselt. Im Allgemeinen ist es nicht erforderlich, dass die Anwendung startDiscovery (GCKDiscoveryManager) und stopDiscovery (GCKDiscoveryManager) aufruft. Dies kann jedoch als Optimierungsmaßnahme erfolgen, um den Netzwerkverkehr und die CPU-Auslastung in Bereichen der Anwendung zu reduzieren, in denen keine Casting-Funktionen verwendet werden.

Wenn die Anwendung das Cast-Dialogfeld des Frameworks verwendet, entweder über GCKUICastButton oder durch direktes Präsentieren, wird in diesem Dialogfeld GCKDiscoveryManager verwendet, um die Liste der verfügbaren Geräte zu füllen. Wenn die Anwendung jedoch eine eigene Benutzeroberfläche für die Geräteauswahl bzw. ‑steuerung bereitstellt, sollte sie GCKDiscoveryManager und das zugehörige Listener-Protokoll GCKDiscoveryManagerListener verwenden, um die Liste der verfügbaren Geräte zu füllen und zu aktualisieren.

Seit
3.0

Erbt von NSObject.

Zusammenfassung der Instanzmethoden

(instancetype) - init
 Der Standard-Initializer ist nicht verfügbar. Weitere Informationen
 
(void) - addListener:
 Fügt einen Listener hinzu, der Discovery-Benachrichtigungen empfängt. Weitere Informationen
 
(void) - removeListener:
 Entfernt einen zuvor registrierten Listener. Weitere Informationen
 
(void) - startDiscovery
 Startet den Ermittlungsprozess. Weitere Informationen
 
(void) - stopDiscovery
 Beendet den Erkennungsprozess. Weitere Informationen
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 Prüft, ob die Erkennung für die angegebene Geräteklasse derzeit aktiv ist. Weitere Informationen
 
(GCKDevice *) - deviceAtIndex:
 Gibt das Gerät mit dem angegebenen Index in der Liste der erkannten Geräte des Managers zurück. Weitere Informationen
 
(GCKDevice *__nullable) - deviceWithUniqueID:
 Gibt das Gerät mit der angegebenen eindeutigen ID in der Liste der erkannten Geräte des Managers zurück. Weitere Informationen
 

Zusammenfassung der Property

GCKDiscoveryState discoveryState
 Der aktuelle Erkennungsstatus. Weitere Informationen
 
BOOL hasDiscoveredDevices
 Ein Flag, das angibt, ob Geräte von einem der von diesem Objekt verwalteten Discovery-Anbieter erkannt wurden. Weitere Informationen
 
BOOL passiveScan
 Ein Flag, das angibt, ob für die Erkennung ein „passiver“ Scan verwendet werden soll. Weitere Informationen
 
BOOL discoveryActive
 Ein Flag, das angibt, ob die Suche aktiv ist. Weitere Informationen
 
NSUInteger deviceCount
 Die Anzahl der Geräte, die derzeit erkannt werden. Weitere Informationen
 

Methodendetail

- (instancetype) init

Der Standard-Initializer ist nicht verfügbar.

- (void) addListener: (id< GCKDiscoveryManagerListener >)  listener

Fügt einen Listener hinzu, der Discovery-Benachrichtigungen empfängt.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKDiscoveryManagerListener >)  listener

Entfernt einen zuvor registrierten Listener.

Parameters
listenerThe listener to remove.
- (void) startDiscovery

Startet den Ermittlungsprozess.

- (void) stopDiscovery

Beendet den Erkennungsprozess.

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

Prüft, ob die Erkennung für die angegebene Geräteklasse derzeit aktiv ist.

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

Gibt das Gerät mit dem angegebenen Index in der Liste der erkannten Geräte des Managers zurück.

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

Gibt das Gerät mit der angegebenen eindeutigen ID in der Liste der erkannten Geräte des Managers zurück.

Parameters
uniqueIDThe device's unique ID.
Ausgabe
Das entsprechende GCKDevice-Objekt oder nil, wenn kein passendes Gerät gefunden wurde.

Property-Details

- (GCKDiscoveryState) discoveryState
readnonatomicassign

Der aktuelle Erkennungsstatus.

- (BOOL) hasDiscoveredDevices
readnonatomicassign

Ein Flag, das angibt, ob Geräte von einem der von diesem Objekt verwalteten Discovery-Anbieter erkannt wurden.

- (BOOL) passiveScan
readwritenonatomicassign

Ein Flag, das angibt, ob für die Erkennung ein „passiver“ Scan verwendet werden soll.

Passive Scans sind weniger ressourcenintensiv, liefern aber keine so aktuellen Ergebnisse wie aktive Scans.

- (BOOL) discoveryActive
readnonatomicassign

Ein Flag, das angibt, ob die Suche aktiv ist.

Seit
3.4
- (NSUInteger) deviceCount
readnonatomicassign

Die Anzahl der Geräte, die derzeit erkannt werden.