Приложение может подписываться на сообщения маячков 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и восстановите подписку на маячок, если включен фоновый режим.
- Сохраняйте значение фонового режима в
Фоновые уведомления
Если вы хотите, чтобы приложение уведомляло пользователя об обнаружении маячков, когда оно работает в фоновом режиме, используйте локальные уведомления. Подробнее о фоновых уведомлениях…