Descripción general
Es una clase que administra el proceso de descubrimiento de dispositivos.
GCKDiscoveryManager administra una colección de instancias de subclase GCKDeviceProvider, cada una de las cuales es responsable de descubrir dispositivos de un tipo específico. Además, mantiene una lista ordenada lexicográfica de los dispositivos descubiertos en la actualidad.
El marco de trabajo inicia automáticamente el proceso de descubrimiento cuando la aplicación pasa a primer plano y la suspende cuando pasa a segundo plano. En general, no es necesario que la aplicación llame a startDiscovery (GCKDiscoveryManager) y stopDiscovery (GCKDiscoveryManager), excepto como una medida de optimización para reducir el tráfico de red y el uso de CPU en áreas de la aplicación que no usan la funcionalidad de Cast.
Si la aplicación usa el diálogo de Cast del framework, ya sea a través de GCKUICastButton o de presentarlo directamente, ese diálogo usará GCKDiscoveryManager para propagar su lista de dispositivos disponibles. Sin embargo, si la aplicación proporciona su propia IU de diálogo de selección/control de dispositivos, debe usar el GCKDiscoveryManager y su protocolo de objeto de escucha asociado, GCKDiscoveryManagerListener, para propagar y actualizar su lista de dispositivos disponibles.
- Since
- 3.0
Hereda NSObject.
Resumen del método de instancia | |
| (instancetype) | - init |
| El inicializador predeterminado no está disponible. Más... | |
| (void) | - addListener: |
| Agrega un objeto de escucha que recibirá notificaciones de descubrimiento. Más... | |
| (void) | - removeListener: |
| Quita un objeto de escucha registrado anteriormente. Más... | |
| (void) | - startDiscovery |
| Inicia el proceso de descubrimiento. Más... | |
| (void) | - stopDiscovery |
| Detiene el proceso de descubrimiento. Más... | |
| (BOOL) | - isDiscoveryActiveForDeviceCategory: |
| Prueba si el descubrimiento está activo actualmente para la categoría de dispositivo determinada. Más... | |
| (GCKDevice *) | - deviceAtIndex: |
| Muestra el dispositivo en el índice dado en la lista de dispositivos descubiertos del administrador. Más... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| Muestra el dispositivo con el ID único proporcionado en la lista de dispositivos descubiertos del administrador. Más... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| Espera a que se detecte un dispositivo con el ID único especificado e invoca un bloque de finalización. Más... | |
| (void) | - cancelFindOperation |
| Cancela cualquier operación de búsqueda en curso que inició findDeviceWithUniqueID:timeout:completion: Más... | |
Resumen de la propiedad | |
| GCKDiscoveryState | discoveryState |
| El estado de descubrimiento actual. Más... | |
| BOOL | hasDiscoveredDevices |
| Una marca que indica si se descubrió alguno de los dispositivos administrados por este objeto o alguno de los proveedores de detección. Más... | |
| BOOL | passiveScan |
| Una marca que indica si el descubrimiento debe emplear un análisis “pasivo”. Más... | |
| BOOL | discoveryActive |
| Marca que indica si el descubrimiento está activo o no. Más... | |
| NSUInteger | deviceCount |
| La cantidad de dispositivos que se descubren actualmente. Más... | |
Detalle del método
| - (instancetype) init |
El inicializador predeterminado no está disponible.
| - (void) addListener: | (id< GCKDiscoveryManagerListener >) | listener |
Agrega un objeto de escucha que recibirá notificaciones de descubrimiento.
El objeto de escucha agregado se retiene de manera débil y debe retenerse para evitar la desasignación inesperada.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
Quita un objeto de escucha registrado anteriormente.
- Parameters
-
listener The listener to remove.
| - (void) startDiscovery |
Inicia el proceso de descubrimiento.
| - (void) stopDiscovery |
Detiene el proceso de descubrimiento.
| - (BOOL) isDiscoveryActiveForDeviceCategory: | (NSString *) | deviceCategory |
Prueba si el descubrimiento está activo actualmente para la categoría de dispositivo determinada.
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
Muestra el dispositivo en el índice dado en la lista de dispositivos descubiertos del administrador.
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
Muestra el dispositivo con el ID único proporcionado en la lista de dispositivos descubiertos del administrador.
- Parameters
-
uniqueID The device's unique ID.
- Resultado que se muestra
- El objeto GCKDevice que coincide o
nilsi no se encontró un dispositivo que coincida.
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
Espera a que se detecte un dispositivo con el ID único especificado e invoca un bloque de finalización.
Si un dispositivo coincidente ya se encuentra en la lista de dispositivos detectados, se invocará el bloque de finalización inmediatamente (pero después de que regrese este método). Solo puede haber una operación de búsqueda activa a la vez. Si inicias una nueva operación de búsqueda mientras otra está en curso, se cancelará la actual.
- Parameters
-
uniqueID The unique ID of the device. timeout The maximum amount of time to wait for the device to be discovered. completion The 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.
- Since
- 4.0
| - (void) cancelFindOperation |
Cancela cualquier operación de búsqueda en curso que inició findDeviceWithUniqueID:timeout:completion:
- Since
- 4.0
Detalles de la propiedad
|
readnonatomicassign |
El estado de descubrimiento actual.
|
readnonatomicassign |
Una marca que indica si se descubrió alguno de los dispositivos administrados por este objeto o alguno de los proveedores de detección.
|
readwritenonatomicassign |
Una marca que indica si el descubrimiento debe emplear un análisis “pasivo”.
Los análisis pasivos consumen menos recursos, pero no proporcionan resultados tan actuales como los análisis activos.
|
readnonatomicassign |
Marca que indica si el descubrimiento está activo o no.
- Since
- 3.4
|
readnonatomicassign |
La cantidad de dispositivos que se descubren actualmente.