GCKDeviceProvider-Klasse

GCKDeviceProvider-Klassenreferenz

Übersicht

Eine abstrakte Basisklasse zur Ausführung von Geräteerkennung und Sitzungserstellung.

Durch das Erweitern dieser Klasse können Sie weitere Gerätetypen unterstützen. Eine Liste der Hilfsmethoden, die von Unterklassen verwendet werden sollen, finden Sie in der Kategorie GCKDeviceProvider(Protected). Neue Geräteanbieter werden mit registerDeviceProvider: (GCKCastContext) im Framework registriert.

Sincé
3,0

Übernimmt NSObject.

Zusammenfassung der Instanzmethoden

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

Property-Zusammenfassung

NSString * deviceCategory
 Ein String, der den Gerätetyp, der von diesem Anbieter erkannt wird, eindeutig identifiziert. Mehr...
 
BOOL passiveScan
 Gibt an, ob der Scan ein passiver Scan sein soll. Mehr...
 
NSArray< GCKDevice * > * devices
 Das Array der erkannten Geräte. Mehr...
 

Methodendetail

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

Angegebener Initialisierer.

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 normalerweise ein asynchroner Vorgang. Wenn eines der im vorherigen Scan gefundenen Geräte nicht mehr gültig ist, sollte der Anbieter die Veröffentlichung vorerst aufheben. Muss von abgeleiteten Klassen überschrieben werden.

Der Anbieter muss den Erkennungsmanager benachrichtigen, sobald der Scan gestartet wurde (und alle veralteten Geräte aufgehoben wurden), indem er notifyDidStartDiscovery (GCKDeviceProvider(Protected)) aufruft. Wenn bei einer bestimmten Implementierung dieser Methode zum Starten eines Scans keine asynchrone Arbeit erforderlich ist, kann die Benachrichtigungsmethode direkt vor der Rückkehr aufgerufen werden.

- (void) stopDiscovery

Stoppt 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 darüber, dass die Erkennung gestartet wurde.

Bereitgestellt von der Kategorie GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

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

Bereitgestellt von der Kategorie GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

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

Bereitgestellt von der Kategorie GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

Benachrichtigt den Discovery-Manager darüber, dass mindestens eines der Anzeigeattribute eines zuvor veröffentlichten Geräts (z. B. Anzeigename oder Symbole) geändert wurde.

Bereitgestellt von der 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 einer 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 der 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 der Scan ein passiver Scan sein soll.

Bei einem passiven Scan werden Erkennungsanfragen seltener gesendet, sodass sie effizienter sind. Die Ergebnisse sind jedoch nicht so aktuell. Es empfiehlt sich, einen passiven Scan auszuführen, wenn der Nutzer nicht aktiv ein Cast-Ziel auswählt. Diese Property wird nicht in allen Implementierungen berücksichtigt.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

Das Array der erkannten Geräte.