Получать сообщения от маячков

Приложение может подписываться на сообщения маячков Bluetooth с низким энергопотреблением (BLE) с помощью того же механизма, который используется для подписки на сообщения, публикуемые другими устройствами поблизости.

По умолчанию подписки на маячки работают, только когда приложение активно. Когда приложение переходит в фоновый режим, подписки автоматически прекращают поиск маячков. Подробнее о том, как включить фоновое сканирование…

Чтобы подписаться на маячки, задайте для параметра deviceTypesToDiscover значение kGNSDeviceBLEBeacon в параметрах подписки. Ниже показано, как это сделать.

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
    })

Приведенная выше подписка обнаруживает только маяки, принадлежащие вашему проекту, и получает все сообщения от этих маяков. Если вы хотите получать сообщения от маячков, зарегистрированных в другом пространстве имен, вы можете передать пространство имен в параметрах подписки. Аналогично, если вам нужен определенный тип сообщения, вы также можете передать тип сообщения для фильтрации. Это показано в следующем фрагменте кода:

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"
    })

По умолчанию подписка на маячки сканирует маячки обоих типов: Eddystone и iBeacon. Если сканирование iBeacon включено, пользователям будет предложено разрешить приложению использовать данные об их местоположении. В файле Info.plist вашего приложения должен быть ключ NSLocationWhenInUseUsageDescription с кратким объяснением того, зачем используются данные о местоположении. Подробную информацию можно найти в документации Apple.

Если вы хотите сканировать только маячки Eddystone, отключите сканирование iBeacon в GNSBeaconStrategy. В этом случае iOS не будет запрашивать у пользователя разрешение на доступ к данным о местоположении. В следующем фрагменте кода показано, как отключить сканирование iBeacon для исходной подписки, приведенной выше:

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
          })
    })

По умолчанию включено сканирование с низким энергопотреблением, что иногда может приводить к большим задержкам при поиске маячков Eddystone. Если режим экономии энергии отключен, для поиска маячков Eddystone используется сканирование iBeacon, что позволяет сократить задержки. Однако это приводит к более высокому расходу заряда батареи, и iOS будет запрашивать у пользователя разрешение на использование местоположения.

В следующем фрагменте кода показано, как отключить режим экономии энергии при сканировании маячков 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
          })
    })

При сканировании iBeacon перед диалоговым окном iOS с запросом доступа к данным о местоположении появляется диалоговое окно с запросом доступа к функции "Рядом". Если вы хотите переопределить это диалоговое окно (например, чтобы предоставить предварительное диалоговое окно, объясняющее, почему требуется разрешение на доступ к данным о местоположении), задайте для permissionRequestHandler пользовательский блок в параметрах подписки. Ниже показано, как это сделать.

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);
      }
    })

Фоновое сканирование

Поскольку сканирование маяков использует BLE, оно может работать в фоновом режиме. Вот что нужно учитывать, если вы решите использовать фоновый режим:

  • Работа BLE в фоновом режиме требует дополнительного заряда батареи. Затраты невелики, но их следует измерить, прежде чем принимать решение об использовании фонового режима.
  • Если сканирование iBeacon включено или режим экономии энергии отключен, iOS запросит у пользователя разрешение на использование местоположения в фоновом режиме.

Чтобы включить сканирование маячков в фоновом режиме, выполните следующие действия:

  • Чтобы включить фоновый режим для подписки, передайте правильно настроенный объект GNSBeaconStrategy. Ниже показано, как это сделать.

    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
              })
        })
    

  • Добавьте в файл Info.plist приложения следующие записи:

    • UIBackgroundModes записей:

      • bluetooth-central для сканирования BLE в фоновом режиме.
      • location для сканирования iBeacon в фоновом режиме с использованием режима высокой мощности. Вы можете пропустить этот шаг, если выполняете сканирование с низким энергопотреблением только для маячков Eddystone.
    • NSLocationAlwaysUsageDescription, в которой объясняется, почему вы будете отслеживать местоположение пользователя в фоновом режиме. Например: "Ваше местоположение необходимо для поиска маячков в фоновом режиме". Подробную информацию можно найти в документации Apple. Этот параметр можно опустить, если вы выполняете сканирование с низким энергопотреблением только для маячков Eddystone.

  • Может ли пользователь включить или отключить фоновое сканирование в вашем приложении? Если да, то вам следует сохранить значение фонового режима в NSUserDefaults, поскольку iOS может в любой момент закрыть приложение, работающее в фоновом режиме. Приложение должно выполнять следующие действия:

    • Сохраняйте значение фонового режима в NSUserDefaults, когда пользователь его меняет.
    • При запуске прочитайте его из NSUserDefaults и восстановите подписку на маячок, если включен фоновый режим.

Фоновые уведомления

Если вы хотите, чтобы приложение уведомляло пользователя об обнаружении маячков, когда оно работает в фоновом режиме, используйте локальные уведомления. Подробнее о фоновых уведомлениях…