GCKDeviceProvider-Klasse

GCKDeviceProvider-Klassenreferenz

Überblick

Eine abstrakte Basisklasse zum Ausführen der Geräteerkennung und Sitzungserstellung.

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

Seit
3,0

Übernimmt NSObject.

Übersicht über Instanzmethoden

(instancetype) - initWithDeviceCategory:
 Definierter Initialisierer. Mehr...
 
(void) - startDiscovery
 Startet einen neuen Discovery-Scan. Mehr...
 
(void) - stopDiscovery
 Beendet den Erkennungsscan. Mehr...
 
(GCKSession *) - createSessionForDevice:sessionID:sessionOptions:
 Erstellt eine neue Sitzung für das angegebene Gerät und optional eine vorhandene Sitzungs-ID. 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, dass die Erkennung gestartet wurde. Mehr...
 
(void) - notifyDidPublishDevice:
 Informiert den Discovery Manager darüber, dass ein neues Gerät veröffentlicht wurde. Mehr...
 
(void) - notifyDidUnpublishDevice:
 Informiert 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:
 Der Discovery-Manager wird darüber informiert, dass sich mindestens ein Anzeigeattribut eines bereits veröffentlichten Geräts, z. B. der Anzeigename oder die Symbole, geändert hat. Mehr...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 
(GCKDevice *) - createDeviceWithID:networkAddress:servicePort:
 Factory-Methode zum Erstellen neuer GCKDevice-Instanzen. Mehr...
 

Property-Zusammenfassung

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

Methodendetail

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

Definierter Initialisierer.

Erstellt eine neue 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 Discovery-Scan.

Dies ist (üblicherweise) ein asynchroner Vorgang. Wenn eines der beim vorherigen Scan gefundenen Geräte nicht mehr gültig ist, sollte der Anbieter die Veröffentlichung zu diesem Zeitpunkt aufheben. Muss von Unterklassen überschrieben werden.

Der Anbieter muss den Discovery Manager durch Aufrufen von notifyDidStartDiscovery (GCKDeviceProvider(Protected)) benachrichtigen, sobald der Scan gestartet und die Veröffentlichung aller veralteten Geräte aufgehoben wurde. Wenn eine bestimmte Implementierung dieser Methode beim Starten eines Scans keine asynchrone Arbeit zu erledigen hat, kann sie die Benachrichtigungsmethode direkt vor der Rückgabe aufrufen.

- (void) stopDiscovery

Beendet den Erkennungsscan.

Muss von Unterklassen überschrieben werden.

- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

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

Muss von Unterklassen überschrieben werden.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
sessionOptionsThe session options, if any; otherwise nil.
Seit
4,0
- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID 

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

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
Deprecated:
Abgeleitete Klassen sollten stattdessen createSessionForDevice:sessionID:sessionOptions aufrufen.
- (void) notifyDidStartDiscovery

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

Bereitgestellt von der Kategorie „GCKDeviceProvider(Protected)“.

- (void) notifyDidPublishDevice: (GCKDevice *)  device

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

Bereitgestellt von der Kategorie „GCKDeviceProvider(Protected)“.

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

Informiert 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

Der Discovery-Manager wird darüber informiert, dass sich mindestens ein Anzeigeattribut eines bereits veröffentlichten Geräts, z. B. der Anzeigename oder die Symbole, geändert hat.

Bereitgestellt von der Kategorie „GCKDeviceProvider(Protected)“.

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort 
Deprecated:
Verwenden Sie createDeviceWithID:networkAddress:servicePort: für die IPv4- und IPv6-Unterstützung.

Factory-Methode zum Erstellen neuer GCKDevice-Instanzen. Die Parameter entsprechen unveränderlichen Eigenschaften 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. Supports IPv4 only.
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)“.

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
networkAddress: (GCKNetworkAddress *)  networkAddress
servicePort: (uint16_t)  servicePort 

Factory-Methode zum Erstellen neuer GCKDevice-Instanzen.

Die Parameter entsprechen unveränderlichen Eigenschaften einer GCKDevice.

Parameters
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
networkAddressThe IP address of the device, either IPv4 or IPv6
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.
Seit
4,2

Bereitgestellt von der Kategorie „GCKDeviceProvider(Protected)“.

Objektdetails

- (NSString*) deviceCategory
readnonatomiccopy

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

- (BOOL) passiveScan
readwritenonatomicassign

Gibt an, ob der Scan ein passiver Scan sein soll.

Bei einem passiven Scan werden Erkennungsabfragen seltener gesendet und sind daher effizienter. Die Ergebnisse sind jedoch nicht so aktuell. Es empfiehlt sich, einen passiven Scan durchzuführen, wenn der Nutzer nicht aktiv ein Streaming-Ziel auswählt. Diese Eigenschaft wird nicht bei allen Implementierungen berücksichtigt.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

Array der erkannten Geräte