Descripción general
Una clase que administra el proceso de descubrimiento de dispositivos.
GCKDiscoveryManager administra una colección de instancias de la subclase GCKDeviceProvider, cada una de las cuales es responsable de descubrir dispositivos de un tipo específico. También mantiene una lista ordenada y lexicográfica de los dispositivos descubiertos actualmente.
El framework inicia automáticamente el proceso de descubrimiento cuando la aplicación pasa al primer plano y lo suspende cuando la aplicación pasa a segundo plano. Por lo general, no es necesario que la aplicación llame a startDiscovery (GCKDiscoveryManager) y stopDiscovery (GCKDiscoveryManager), excepto como 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 transmisión del framework, ya sea a través de GCKUICastButton o presentándolos 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, debería usar GCKDiscoveryManager y su protocolo de objeto de escucha asociado, GCKDiscoveryManagerListener, para propagar y actualizar su lista de dispositivos disponibles.
- Desde
- 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 previamente. Más... | |
| (void) | - startDiscovery |
| Inicia el proceso de descubrimiento. Más... | |
| (void) | - stopDiscovery |
| Detiene el proceso de descubrimiento. Más... | |
| (BOOL) | - isDiscoveryActiveForDeviceCategory: |
| Prueba si la detección está activa actualmente para la categoría de dispositivo determinada. Más... | |
| (GCKDevice *) | - deviceAtIndex: |
| Muestra el dispositivo en el índice determinado en la lista de dispositivos detectados del administrador. Más... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| Muestra el dispositivo con el ID único especificado en la lista de dispositivos detectados del administrador. Más... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| Espera a que se descubra un dispositivo con el ID único especificado y, luego, invoca un bloque de finalización. Más... | |
| (void) | - cancelFindOperation |
| Cancela cualquier operación de búsqueda en curso que haya iniciado findDeviceWithUniqueID:timeout:completion:. Más... | |
Resumen de la propiedad | |
| GCKDiscoveryState | discoveryState |
| El estado de detección actual. Más... | |
| BOOL | hasDiscoveredDevices |
| Una marca que indica si alguno de los proveedores de descubrimiento que administra este objeto detectó algún dispositivo. Más... | |
| BOOL | passiveScan |
| Una marca que indica si la detección debe emplear un análisis "pasivo". Más... | |
| BOOL | discoveryActive |
| Una 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 no se retiene y se debe conservar para evitar la desasignación inesperada.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
Quita un objeto de escucha registrado previamente.
- 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 la detección está activa actualmente para la categoría de dispositivo determinada.
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
Muestra el dispositivo en el índice determinado en la lista de dispositivos detectados del administrador.
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
Muestra el dispositivo con el ID único especificado en la lista de dispositivos detectados del administrador.
- Parameters
-
uniqueID The device's unique ID.
- Devuelve
- El objeto GCKDevice coincidente o
nilsi no se encontró un dispositivo coincidente.
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
Espera a que se descubra un dispositivo con el ID único especificado y, luego, 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 de inmediato (pero después de que se muestre este método). Solo puede haber una operación de búsqueda activa a la vez. Si inicias una operación de búsqueda nueva 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.
- Desde
- 4.0
| - (void) cancelFindOperation |
Cancela cualquier operación de búsqueda en curso que haya iniciado findDeviceWithUniqueID:timeout:completion:.
- Desde
- 4.0
Detalles de la propiedad
|
readnonatomicassign |
El estado de detección actual.
|
readnonatomicassign |
Una marca que indica si alguno de los proveedores de descubrimiento que administra este objeto detectó algún dispositivo.
|
readwritenonatomicassign |
Una marca que indica si la detección debe emplear un análisis "pasivo".
Los análisis pasivos requieren menos recursos, pero no proporcionan resultados tan actualizados como los análisis activos.
|
readnonatomicassign |
Una marca que indica si el descubrimiento está activo o no.
- Desde
- 3.4
|
readnonatomicassign |
La cantidad de dispositivos que se descubren actualmente.