Tu app puede suscribirse a mensajes de balizas de Bluetooth de bajo consumo (BLE) con el mismo mecanismo que se usa para suscribirse a mensajes publicados por otros dispositivos cercanos.
De forma predeterminada, las suscripciones a balizas solo funcionan cuando la app está en primer plano. Cuando tu app pasa a segundo plano, las suscripciones dejan de buscar balizas automáticamente. Consulta Análisis en segundo plano para obtener detalles sobre cómo habilitar el análisis en segundo plano.
Para suscribirte a las balizas, establece el parámetro deviceTypesToDiscover en
kGNSDeviceBLEBeacon en los parámetros de suscripción. En el siguiente fragmento, se muestra cómo hacerlo:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
})
La suscripción anterior solo descubre las balizas que pertenecen a tu proyecto y recibe todos los mensajes de esas balizas. Si deseas recibir mensajes de balizas registradas con un espacio de nombres diferente, puedes pasar un espacio de nombres en los parámetros de suscripción. Del mismo modo, si deseas un tipo de mensaje específico, también puedes pasar un tipo de mensaje para filtrar. En el siguiente fragmento, se muestra cómo hacerlo:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.messageNamespace = @"com.mycompany.mybeaconservice";
params.type = @"mybeacontype";
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.messageNamespace = "com.mycompany.mybeaconservice"
params.type = "mybeacontype"
})
De forma predeterminada, una suscripción de baliza busca ambos tipos de balizas, Eddystone e
iBeacon. Cuando se habilita el análisis de iBeacon, se les solicita a los usuarios que otorguen permiso para que la app use sus datos de ubicación. El archivo Info.plist de tu app debe incluir la clave NSLocationWhenInUseUsageDescription con una breve explicación de por qué se usa la ubicación. Consulta la
documentación de Apple
para obtener más detalles.
Si solo quieres buscar balizas Eddystone, puedes inhabilitar la búsqueda de iBeacon
en GNSBeaconStrategy, y iOS no le pedirá permiso al usuario para
usar la ubicación. En el siguiente fragmento, se muestra cómo inhabilitar el análisis de iBeacon para la suscripción original anterior:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.beaconStrategy =
[GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
params.includeIBeacons = NO;
};
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.beaconStrategy =
GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
params.includeIBeacons = false
})
})
De forma predeterminada, se habilita el análisis de bajo consumo, lo que a veces puede generar latencias grandes cuando se encuentran balizas de Eddystone. Cuando se inhabilita el modo de bajo consumo, se usa el análisis de iBeacon para ayudar a encontrar balizas Eddystone, lo que puede reducir estas latencias. Sin embargo, esto genera un mayor uso de batería, y iOS le pedirá permiso al usuario para usar la ubicación.
En el siguiente fragmento, se muestra cómo inhabilitar el modo de bajo consumo cuando se buscan balizas Eddystone.
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.beaconStrategy =
[GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
params.includeIBeacons = NO;
params.lowPowerPreferred = NO;
};
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.beaconStrategy =
GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
params.includeIBeacons = false
params.lowPowerPreferred = false
})
})
Cuando se buscan iBeacons, el diálogo de permiso de ubicación de iOS está precedido por el diálogo de permiso de Nearby. Si quieres anular este diálogo (por ejemplo, para proporcionar un diálogo de "comprobación preliminar" que explique por qué se necesita el permiso de ubicación), establece el permissionRequestHandler en un bloque personalizado en los parámetros de suscripción. En el siguiente fragmento, se muestra cómo hacerlo:
Objective-C
id<GNSSubscription> beaconSubscription = [messageManager
subscriptionWithMessageFoundHandler:myMessageFoundHandler
messageLostHandler:myMessageLostHandler
paramsBlock:^(GNSSubscriptionParams *params) {
params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
params.permissionRequestHandler = ^(GNSPermissionHandler permissionHandler) {
// Show your custom dialog here, and don't forget to call permissionHandler after it is dismissed
permissionHandler(userGavePermission);
};
}];
Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
paramsBlock: { (params: GNSSubscriptionParams!) in
params.deviceTypesToDiscover = .BLEBeacon
params.permissionRequestHandler = { (permissionHandler: GNSPermissionHandler!) in
// Show your custom dialog here, and don't forget to call permissionHandler after it is dismissed
permissionHandler(userGavePermission);
}
})
Análisis en segundo plano
Como el análisis de balizas usa BLE, puede funcionar en segundo plano. A continuación, se indican algunos aspectos que debes tener en cuenta cuando decidas usar el modo en segundo plano:
- Hay un costo de batería adicional para BLE en segundo plano. El costo es bajo, pero debes medirlo antes de decidir usar el modo en segundo plano.
- iOS le pedirá permiso al usuario para usar la ubicación en segundo plano si se habilita el análisis de iBeacon o se inhabilita el modo de bajo consumo.
Para habilitar el análisis de balizas en segundo plano, sigue estos pasos adicionales:
Para habilitar el modo en segundo plano de tu suscripción, pasa un objeto
GNSBeaconStrategyconfigurado correctamente. En el siguiente fragmento, se muestra cómo hacerlo:Objective-C
id<GNSSubscription> beaconSubscription = [messageManager subscriptionWithMessageFoundHandler:myMessageFoundHandler messageLostHandler:myMessageLostHandler paramsBlock:^(GNSSubscriptionParams *params) { params.deviceTypesToDiscover = kGNSDeviceBLEBeacon; params.beaconStrategy = [GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) { params.allowInBackground = YES; }]; }];Swift
let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler( myMessageFoundHandler, messageLostHandler: myMessageLostHandler, paramsBlock: { (params: GNSSubscriptionParams!) in params.deviceTypesToDiscover = .BLEBeacon params.beaconStrategy = GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in params.allowInBackground = true }) })Agrega las entradas obligatorias al archivo
Info.plistde tu app:UIBackgroundModesentradas:bluetooth-centralpara la búsqueda de BLE en segundo planolocationpara el análisis de iBeacon en segundo plano con el modo de alto consumo de energía. Puedes omitir esto si solo realizas un análisis de bajo consumo para las balizas de Eddystone.
Es una cadena
NSLocationAlwaysUsageDescriptionque describe por qué harás un seguimiento de la ubicación del usuario en segundo plano. Por ejemplo, "Se necesita tu ubicación para buscar balizas en segundo plano". Consulta la documentación de Apple para obtener más detalles. Puedes omitir este paso si solo realizas un análisis de bajo consumo para las balizas de Eddystone.
¿El usuario puede habilitar o inhabilitar el análisis en segundo plano en tu app? Si es así, debes guardar el valor del modo en segundo plano en
NSUserDefaults, ya que iOS puede cerrar tu app en cualquier momento mientras se ejecuta en segundo plano. Tu app debería hacer lo siguiente:- Guarda el valor del modo de fondo en
NSUserDefaultscada vez que el usuario lo cambie. - En el inicio, léelo desde
NSUserDefaultsy restablece la suscripción al faro si el modo en segundo plano está habilitado.
- Guarda el valor del modo de fondo en
Notificaciones en segundo plano
Si quieres que tu app notifique al usuario cuando se descubran balizas mientras se ejecuta en segundo plano, puedes usar notificaciones locales. Para obtener más información, consulta Notificaciones en segundo plano.