Classe GCKDeviceProvider

Riferimento alla classe GCKDeviceProvider

Panoramica

Una classe base astratta per l'esecuzione del rilevamento dei dispositivi e la creazione di sessioni.

È possibile aggiungere il supporto di altri tipi di dispositivi estendendo questo corso. Consulta la categoria GCKDeviceProvider(Protected) per un elenco dei metodi helper destinati all'uso da parte delle sottoclassi. I nuovi fornitori di dispositivi sono registrati con il framework utilizzando registerDeviceProvider: (GCKCastContext).

Dal
3,0

Eredita NSObject.

Riepilogo del metodo di istanza

(instancetype) - initWithDeviceCategory:
 Inizializzatore designato. Altro...
 
(void) - startDiscovery
 Avvia una nuova scansione del rilevamento. Altro...
 
(void) - stopDiscovery
 Interrompe la scansione del rilevamento. Altro...
 
(GCKSession *) - createSessionForDevice:sessionID:sessionOptions:
 Consente di creare una nuova sessione per il dispositivo specificato e, facoltativamente, un ID sessione esistente. Altro...
 
(GCKSession *) - createSessionForDevice:sessionID:
 Consente di creare una nuova sessione per il dispositivo specificato e, facoltativamente, un ID sessione esistente. Altro...
 
(void) - notifyDidStartDiscovery
 Comunica al gestore predittivo che il rilevamento è iniziato. Altro...
 
(void) - notifyDidPublishDevice:
 Comunica al gestore discovery che è stato pubblicato un nuovo dispositivo. Altro...
 
(void) - notifyDidUnpublishDevice:
 Comunica al gestore discovery che la pubblicazione di un dispositivo precedentemente pubblicato è stata annullata, in quanto non è più disponibile. Altro...
 
(void) - notifyDidUpdateDevice:
 Comunica al gestore discovery che uno o più attributi di visualizzazione di un dispositivo pubblicati in precedenza (come il nome descrittivo o le icone) sono cambiati. Altro...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 
(GCKDevice *) - createDeviceWithID:networkAddress:servicePort:
 Metodo di sviluppo per la creazione di nuove istanze GCKDevice. Altro...
 

Riepilogo proprietà

NSString * deviceCategory
 Una stringa che identifica in modo univoco il tipo di dispositivo che verrà rilevato da questo provider. Altro...
 
BOOL passiveScan
 Indica se la scansione deve essere una scansione passiva. Altro...
 
NSArray< GCKDevice * > * devices
 L'array di dispositivi rilevati. Altro...
 

Dettaglio metodo

- (instancetype) initWithDeviceCategory: (NSString *)  deviceCategory

Inizializzatore designato.

Consente di creare un nuovo GCKDeviceProvider per i dispositivi del tipo specificato.

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

Avvia una nuova scansione del rilevamento.

Si tratta (di solito) di un'operazione asincrona. Se uno dei dispositivi rilevati dalla scansione precedente non è più valido, il provider dovrebbe annullarne la pubblicazione in questo momento. Deve essere sostituita dalle sottoclassi.

Il provider deve avvisare il gestore del rilevamento dell'avvio della scansione e dell'annullamento della pubblicazione di eventuali dispositivi inattivi chiamando notifyDidStartDiscovery (GCKDeviceProvider(Protected)). Se una particolare implementazione di questo metodo non prevede operazioni asincrone da eseguire quando viene avviata una scansione, può chiamare il metodo di notifica direttamente prima di tornare.

- (void) stopDiscovery

Interrompe la scansione del rilevamento.

Deve essere sostituita dalle sottoclassi.

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

Consente di creare una nuova sessione per il dispositivo specificato e, facoltativamente, un ID sessione esistente.

Deve essere sostituita dalle sottoclassi.

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.
Dal
4,0
- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID 

Consente di creare una nuova sessione per il dispositivo specificato e, facoltativamente, un ID sessione esistente.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
Deprecated:
Le sottoclassi devono chiamare createSessionForDevice:sessionID:sessionOptions.
- (void) notifyDidStartDiscovery

Comunica al gestore predittivo che il rilevamento è iniziato.

Fornito dalla categoria GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

Comunica al gestore discovery che è stato pubblicato un nuovo dispositivo.

Fornito dalla categoria GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

Comunica al gestore discovery che la pubblicazione di un dispositivo precedentemente pubblicato è stata annullata, in quanto non è più disponibile.

Fornito dalla categoria GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

Comunica al gestore discovery che uno o più attributi di visualizzazione di un dispositivo pubblicati in precedenza (come il nome descrittivo o le icone) sono cambiati.

Fornito dalla categoria GCKDeviceProvider(Protected).

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort 
Deprecated:
Utilizza createDeviceWithID:networkAddress:servicePort: per il supporto IPv4 e IPv6

Metodo di sviluppo per la creazione di nuove istanze GCKDevice. I parametri corrispondono a proprietà immutabili di un elemento 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.

Fornito dalla categoria GCKDeviceProvider(Protected).

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

Metodo di sviluppo per la creazione di nuove istanze GCKDevice.

I parametri corrispondono a proprietà immutabili di un elemento 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.
Dal
4,2

Fornito dalla categoria GCKDeviceProvider(Protected).

Dettagli della proprietà

- (NSString*) deviceCategory
readnonatomiccopy

Una stringa che identifica in modo univoco il tipo di dispositivo che verrà rilevato da questo provider.

- (BOOL) passiveScan
readwritenonatomicassign

Indica se la scansione deve essere una scansione passiva.

Una scansione passiva invia query di rilevamento con minore frequenza, perciò è più efficiente, ma i risultati non saranno così aggiornati. È appropriato eseguire una scansione passiva quando l'utente non seleziona attivamente un target di trasmissione. Non tutte le implementazioni rispetteranno questa proprietà.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

L'array di dispositivi rilevati.