Classe GCKDiscoveryManager

Documentation de référence sur la classe GCKDiscoveryManager

Présentation

Une classe qui gère le processus de détection d'appareils.

GCKDiscoveryManager gère une collection d'instances de sous-classe GCKDeviceProvider, chacune responsable de la détection d'appareils d'un type spécifique. Elle tient également à jour une liste triée par ordre lexicographique des appareils actuellement découverts.

Le framework lance automatiquement le processus de découverte lorsque l'application passe au premier plan et le suspend lorsqu'elle passe en arrière-plan. En règle générale, l'application n'a pas besoin d'appeler startDiscovery (GCKDiscoveryManager) et stopDiscovery (GCKDiscoveryManager), sauf pour optimiser les opérations visant à réduire le trafic réseau et l'utilisation du processeur dans les zones de l'application qui n'utilisent pas la fonctionnalité Cast.

Si l'application utilise la boîte de dialogue Cast du framework, que ce soit via GCKUICastButton ou en la présentant directement, cette boîte de dialogue utilisera GCKDiscoveryManager pour renseigner la liste des appareils disponibles. Toutefois, si l'application fournit sa propre interface utilisateur de la boîte de dialogue de sélection/commande d'appareil, elle doit utiliser GCKDiscoveryManager et son protocole d'écoute associé, GCKDiscoveryManagerListener, pour renseigner et mettre à jour la liste des appareils disponibles.

Depuis
3,0

Hérite du NSObject.

Résumé des méthodes d'instance

(instancetype) - init
 L'initialiseur par défaut n'est pas disponible. Plus...
 
(void) - addListener:
 Ajoute un écouteur qui recevra les notifications de découverte. Plus...
 
(void) - removeListener:
 Supprime un écouteur précédemment enregistré. Plus...
 
(void) - startDiscovery
 Lance le processus de découverte. Plus...
 
(void) - stopDiscovery
 Arrête le processus de découverte. Plus...
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 Vérifie si la détection est actuellement active pour la catégorie d'appareil donnée. Plus...
 
(GCKDevice *) - deviceAtIndex:
 Renvoie l'appareil correspondant à l'index donné dans la liste des appareils détectés du gestionnaire. Plus...
 
(nullable GCKDevice *) - deviceWithUniqueID:
 Renvoie l'appareil ayant l'identifiant unique indiqué dans la liste des appareils détectés du gestionnaire. Plus...
 
(void) - findDeviceWithUniqueID:timeout:completion:
 Attend qu'un appareil doté de l'ID unique donné soit détecté et appelle un bloc "complète". Plus...
 
(void) - cancelFindOperation
 Annule toute opération de recherche en cours lancée par findDeviceWithUniqueID:timeout:completed:. Plus...
 

Résumé de la propriété

GCKDiscoveryState discoveryState
 État de découverte actuel. Plus...
 
BOOL hasDiscoveredDevices
 Indicateur indiquant si des appareils ont été détectés par l'un des fournisseurs de découverte gérés par cet objet. Plus...
 
BOOL passiveScan
 Indicateur indiquant si la découverte doit utiliser une analyse "passive". Plus...
 
BOOL discoveryActive
 Indicateur indiquant si la découverte est active ou non. Plus...
 
NSUInteger deviceCount
 Nombre d'appareils actuellement détectés. Plus...
 

Détails sur la méthode

- (instancetype) init

L'initialiseur par défaut n'est pas disponible.

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

Ajoute un écouteur qui recevra les notifications de découverte.

L'écouteur ajouté est faiblement détenu et doit être conservé pour éviter une désallocation inattendue.

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

Supprime un écouteur précédemment enregistré.

Parameters
listenerThe listener to remove.
- (void) startDiscovery

Lance le processus de découverte.

- (void) stopDiscovery

Arrête le processus de découverte.

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

Vérifie si la détection est actuellement active pour la catégorie d'appareil donnée.

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

Renvoie l'appareil correspondant à l'index donné dans la liste des appareils détectés du gestionnaire.

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

Renvoie l'appareil ayant l'identifiant unique indiqué dans la liste des appareils détectés du gestionnaire.

Parameters
uniqueIDThe device's unique ID.
Renvoie
Objet GCKDevice correspondant, ou nil si aucun appareil correspondant n'a été trouvé.
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

Attend qu'un appareil doté de l'ID unique donné soit détecté et appelle un bloc "complète".

Si un appareil correspondant figure déjà dans la liste des appareils détectés, le bloc de saisie semi-automatique sera appelé immédiatement (mais après le retour de cette méthode). Une seule opération de recherche peut être active à la fois. Si vous lancez une nouvelle opération de recherche alors qu'une autre est en cours, l'opération en cours est annulée.

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.
Depuis
4,0
- (void) cancelFindOperation

Annule toute opération de recherche en cours lancée par findDeviceWithUniqueID:timeout:completed:.

Depuis
4,0

Détails de la propriété

- (GCKDiscoveryState) discoveryState
readnonatomicassign

État de découverte actuel.

- (BOOL) hasDiscoveredDevices
readnonatomicassign

Indicateur indiquant si des appareils ont été détectés par l'un des fournisseurs de découverte gérés par cet objet.

- (BOOL) passiveScan
readwritenonatomicassign

Indicateur indiquant si la découverte doit utiliser une analyse "passive".

Les analyses passives consomment moins de ressources, mais ne fournissent pas des résultats aussi récents que les analyses actives.

- (BOOL) discoveryActive
readnonatomicassign

Indicateur indiquant si la découverte est active ou non.

Depuis
3,4
- (NSUInteger) deviceCount
readnonatomicassign

Nombre d'appareils actuellement détectés.