Classe GCKDiscoveryManager

Riferimento alla classe GCKDiscoveryManager

Panoramica

Una classe che gestisce il processo di rilevamento dei dispositivi.

GCKDiscoveryManager gestisce una raccolta di istanze di sottoclassi GCKDeviceProvider, ognuna delle quali è responsabile del rilevamento di dispositivi di un tipo specifico. Inoltre, gestisce un elenco lessicografico dei dispositivi attualmente rilevati.

Il framework avvia automaticamente il processo di rilevamento quando l'applicazione passa in primo piano e lo sospende quando l'applicazione passa in background. In genere non è necessario che l'applicazione chiami startDiscovery (GCKDiscoveryManager) e stopDiscovery (GCKDiscoveryManager), tranne che come misura di ottimizzazione per ridurre il traffico di rete e l'utilizzo della CPU in aree dell'applicazione che non utilizzano la funzionalità di trasmissione.

Se l'applicazione utilizza la finestra di dialogo Trasmetti del framework, tramite GCKUICastButton o presentandola direttamente, tale finestra utilizzerà GCKDiscoveryManager per completare l'elenco dei dispositivi disponibili. Se, tuttavia, l'applicazione fornisce la propria UI della finestra di dialogo di selezione/controllo dei dispositivi, deve utilizzare GCKDiscoveryManager e il protocollo listener associato, GCKDiscoveryManagerListener, per compilare e aggiornare l'elenco dei dispositivi disponibili.

Dal
3,0

Eredita NSObject.

Riepilogo del metodo di istanza

(instancetype) - init
 Inizializzatore predefinito non disponibile. Altro...
 
(void) - addListener:
 Aggiunge un listener che riceverà le notifiche di rilevamento. Altro...
 
(void) - removeListener:
 Rimuove un listener registrato in precedenza. Altro...
 
(void) - startDiscovery
 Avvia il processo di rilevamento. Altro...
 
(void) - stopDiscovery
 Interrompe il processo di rilevamento. Altro...
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 Verifica se il rilevamento è attualmente attivo per la categoria di dispositivo specificata. Altro...
 
(GCKDevice *) - deviceAtIndex:
 Restituisce il dispositivo nell'indice specificato nell'elenco dei dispositivi rilevati dal gestore. Altro...
 
(nullable GCKDevice *) - deviceWithUniqueID:
 Restituisce il dispositivo con l'ID univoco specificato nell'elenco dei dispositivi rilevati dal gestore. Altro...
 
(void) - findDeviceWithUniqueID:timeout:completion:
 Attende che un dispositivo con l'ID univoco specificato venga rilevato e richiama un blocco di completamento. Altro...
 
(void) - cancelFindOperation
 Annulla qualsiasi operazione di ricerca in corso avviata da findDeviceWithUniqueID:timeout:completion:. Altro...
 

Riepilogo proprietà

GCKDiscoveryState discoveryState
 Lo stato di rilevamento attuale. Altro...
 
BOOL hasDiscoveredDevices
 Un flag che indica se sono stati rilevati dispositivi da uno dei provider di rilevamento gestiti da questo oggetto. Altro...
 
BOOL passiveScan
 Un flag che indica se il rilevamento deve utilizzare una scansione "passiva". Altro...
 
BOOL discoveryActive
 Un flag che indica se il rilevamento è attivo o meno. Altro...
 
NSUInteger deviceCount
 Il numero di dispositivi attualmente rilevati. Altro...
 

Dettaglio metodo

- (instancetype) init

Inizializzatore predefinito non disponibile.

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

Aggiunge un listener che riceverà le notifiche di rilevamento.

Il listener aggiunto è bloccato in modo debole e deve essere mantenuto per evitare una deallocation imprevista.

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

Rimuove un listener registrato in precedenza.

Parameters
listenerThe listener to remove.
- (void) startDiscovery

Avvia il processo di rilevamento.

- (void) stopDiscovery

Interrompe il processo di rilevamento.

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

Verifica se il rilevamento è attualmente attivo per la categoria di dispositivo specificata.

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

Restituisce il dispositivo nell'indice specificato nell'elenco dei dispositivi rilevati dal gestore.

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

Restituisce il dispositivo con l'ID univoco specificato nell'elenco dei dispositivi rilevati dal gestore.

Parameters
uniqueIDThe device's unique ID.
Ritorni
L'oggetto GCKDevice corrispondente o nil se non è stato trovato un dispositivo corrispondente.
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

Attende che un dispositivo con l'ID univoco specificato venga rilevato e richiama un blocco di completamento.

Se un dispositivo corrispondente è già nell'elenco dei dispositivi rilevati, il blocco di completamento verrà richiamato immediatamente (ma dopo la restituzione di questo metodo). È possibile attivare una sola operazione di ricerca alla volta; l'avvio di una nuova operazione di ricerca mentre è in corso un'altra annullerà l'operazione corrente.

Parameters
uniqueIDThe unique ID of the device.
timeoutThe maximum amount of time to wait for the device to be discovered.
completionThe completion block to invoke when either the device is found or the timeout is reached. The device (if found) or nil (if not found) will be passed to the completion block.
Dal
4,0
- (void) cancelFindOperation

Annulla qualsiasi operazione di ricerca in corso avviata da findDeviceWithUniqueID:timeout:completion:.

Dal
4,0

Dettagli della proprietà

- (GCKDiscoveryState) discoveryState
readnonatomicassign

Lo stato di rilevamento attuale.

- (BOOL) hasDiscoveredDevices
readnonatomicassign

Un flag che indica se sono stati rilevati dispositivi da uno dei provider di rilevamento gestiti da questo oggetto.

- (BOOL) passiveScan
readwritenonatomicassign

Un flag che indica se il rilevamento deve utilizzare una scansione "passiva".

Le analisi passive richiedono meno risorse, ma non forniscono risultati aggiornati come le analisi attive.

- (BOOL) discoveryActive
readnonatomicassign

Un flag che indica se il rilevamento è attivo o meno.

Dal
3,4
- (NSUInteger) deviceCount
readnonatomicassign

Il numero di dispositivi attualmente rilevati.