GCKDeviceProvider-Klasse

GCKDeviceProvider-Klassenreferenz

Übersicht

Eine abstrakte Basisklasse zum Ausführen der Geräteerkennung und zum Erstellen von Sitzungen.

Durch Erweitern dieser Klasse kann Unterstützung für zusätzliche Gerätetypen hinzugefügt werden. Eine Liste der Hilfsmethoden, die für die Verwendung durch Unterklassen vorgesehen sind, finden Sie in der Kategorie GCKDeviceProvider(Protected). Neue Geräteanbieter werden mit registerDeviceProvider: (GCKCastContext) im Framework registriert.

Seit
3.0

Erbt von NSObject.

Zusammenfassung der Instanzmethoden

(instancetype) - initWithDeviceCategory:
 Designated Initializer Weitere Informationen
 
(void) - startDiscovery
 Startet einen neuen Erkennungsscan. Weitere Informationen
 
(void) - stopDiscovery
 Beendet den Erkennungsscan. Weitere Informationen
 
(GCKSession *) - createSessionForDevice:sessionID:
 Erstellt eine neue Sitzung für das angegebene Gerät und optional eine vorhandene Sitzungs-ID. Weitere Informationen
 
(void) - notifyDidStartDiscovery
 Benachrichtigt den Discovery-Manager, dass die Erkennung gestartet wurde. Weitere Informationen
 
(void) - notifyDidPublishDevice:
 Benachrichtigt den Discovery-Manager, dass ein neues Gerät veröffentlicht wurde. Weitere Informationen
 
(void) - notifyDidUnpublishDevice:
 Benachrichtigt den Discovery Manager, dass die Veröffentlichung eines zuvor veröffentlichten Geräts aufgehoben wurde, da es nicht mehr verfügbar ist. Weitere Informationen
 
(void) - notifyDidUpdateDevice:
 Benachrichtigt den Discovery Manager, dass sich ein oder mehrere Anzeigeattribute (z. B. Anzeigename oder Symbole) eines zuvor veröffentlichten Geräts geändert haben. Weitere Informationen
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 Factory-Methode zum Erstellen neuer GCKDevice-Instanzen. Weitere Informationen
 

Zusammenfassung der Property

NSString * deviceCategory
 Ein String, der den Gerätetyp, der von diesem Anbieter erkannt wird, eindeutig identifiziert. Weitere Informationen
 
BOOL passiveScan
 Gibt an, ob es sich um einen passiven Scan handeln soll. Weitere Informationen
 
NSArray< GCKDevice * > * devices
 Das Array der erkannten Geräte. Weitere Informationen
 

Methodendetail

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

Designated Initializer

Erstellt ein neues GCKDeviceProvider für Geräte des angegebenen Typs.

Parameters
deviceCategoryA string that uniquely identifies the type of device that is managed by by this provider.
- (void) startDiscovery

Startet einen neuen Erkennungsscan.

Dies ist (in der Regel) ein asynchroner Vorgang. Wenn Geräte, die beim vorherigen Scan erkannt wurden, nicht mehr gültig sind, sollte der Anbieter sie jetzt aus dem Angebot entfernen. Muss von abgeleiteten Klassen überschrieben werden.

Der Anbieter muss den Discovery Manager benachrichtigen, sobald der Scan gestartet wurde (und alle veralteten Geräte nicht mehr veröffentlicht wurden), indem er notifyDidStartDiscovery (GCKDeviceProvider(Protected)) aufruft. Wenn bei einer bestimmten Implementierung dieser Methode beim Starten eines Scans keine asynchrone Arbeit zu erledigen ist, kann sie die Benachrichtigungsmethode direkt vor der Rückgabe aufrufen.

- (void) stopDiscovery

Beendet den Erkennungsscan.

Muss von abgeleiteten Klassen überschrieben werden.

- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (NSString *__nullable)  sessionID 

Erstellt eine neue Sitzung für das angegebene Gerät und optional eine vorhandene Sitzungs-ID.

Muss von abgeleiteten Klassen überschrieben werden.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
- (void) notifyDidStartDiscovery

Benachrichtigt den Discovery-Manager, dass die Erkennung gestartet wurde.

Bereitgestellt von Kategorie GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

Benachrichtigt den Discovery-Manager, dass ein neues Gerät veröffentlicht wurde.

Bereitgestellt von Kategorie GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

Benachrichtigt den Discovery Manager, dass die Veröffentlichung eines zuvor veröffentlichten Geräts aufgehoben wurde, da es nicht mehr verfügbar ist.

Bereitgestellt von Kategorie GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

Benachrichtigt den Discovery Manager, dass sich ein oder mehrere Anzeigeattribute (z. B. Anzeigename oder Symbole) eines zuvor veröffentlichten Geräts geändert haben.

Bereitgestellt von Kategorie GCKDeviceProvider(Protected).

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort 

Factory-Methode zum Erstellen neuer GCKDevice-Instanzen.

Die Parameter entsprechen unveränderlichen Attributen eines GCKDevice.

Parameters
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
ipAddressThe IP address of the device, in numeric form (for example, @"10.0.0.10"). May not be nil.
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.

Bereitgestellt von Kategorie GCKDeviceProvider(Protected).

Property-Details

- (NSString*) deviceCategory
readnonatomiccopy

Ein String, der den Gerätetyp, der von diesem Anbieter erkannt wird, eindeutig identifiziert.

- (BOOL) passiveScan
readwritenonatomicassign

Gibt an, ob es sich um einen passiven Scan handeln soll.

Bei einem passiven Scan werden weniger häufig Discovery-Abfragen gesendet. Das ist effizienter, aber die Ergebnisse sind nicht so aktuell. Ein passiver Scan ist angemessen, wenn der Nutzer kein Cast-Ziel auswählt. Diese Property wird nicht in allen Implementierungen berücksichtigt.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

Das Array der erkannten Geräte.