Obtener mensajes de las balizas

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 GNSBeaconStrategy configurado 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.plist de tu app:

    • UIBackgroundModes entradas:

      • bluetooth-central para la búsqueda de BLE en segundo plano
      • location para 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 NSLocationAlwaysUsageDescription que 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 NSUserDefaults cada vez que el usuario lo cambie.
    • En el inicio, léelo desde NSUserDefaults y restablece la suscripción al faro si el modo en segundo plano está habilitado.

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.