В предыдущей статье мы рассказали про использование беакон-маяков и технологии BLE в приложениях на React Native c помощью библиотеки React Native BLE. Теперь перейдем к более совершенному подходу для работы с маяками, — разработаем нативный модуль на iOS.

Чем же он лучше? Можно добиться большей точности, обеспечить глубокую интеграцию с iOS и лучшее управление энергопотреблением.

В этой статье мы сравним оба подхода и обсудим, чем же нативное решение лучше для определенных типов приложений. Еще подробно остановимся на технической реализации, настройке маяков и расскажем, зачем они нужны для бизнеса.

В чем разница между BLE и iBeacon?

Bluetooth Low Energy (BLE) и iBeacon работают на одной и той же технологической основе, но предназначены для разных целей и имеют различные области применения.

BLE (Bluetooth Low Energy)

BLE разработан для передачи небольших объемов данных на короткие расстояния с минимальным энергопотреблением. Это идеально подходит для устройств, работающих от батарей, таких как фитнес-браслеты, датчики окружающей среды, умные часы и другие устройства Интернета вещей (IoT).

Основное преимущество BLE — это его способность работать в течение длительного времени на одном заряде батареи благодаря низкому энергопотреблению.

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

iBeacon

iBeacon — это протокол, разработанный Apple, который использует технологию BLE для предоставления геолокационных услуг в конкретных сценариях. Он позволяет мобильным приложениям определять их близость к маячку, небольшому устройству BLE, которое транслирует уникальный идентификатор.

В отличие от BLE, который отвечает за простой обмен данными между устройствами, iBeacon используют для создания более сложных сценариев взаимодействия. Например, приложение должно реагировать, когда пользователь приближается к определенному месту или покидает его.

Преимущества iBeacon

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

Благодаря упрощенной настройке геозон, лучшей поддержке фонового режима и повышенной точности определения местоположения. Это делает iBeacon идеальным для целей маркетинга в розничной торговле, внутренней навигации и автоматизации в помещениях.

Упрощенная настройка геозон

iBeacon позволяет легко создавать геозоны вокруг физических маяков. Разработчикам не нужно заботиться о сложной настройке и обслуживании сети GPS внутри помещений. Поскольку не гарантирует такой точности и эффективности. В то же время, iBeacon позволяет легко определять, когда пользователь входит или выходит из заданной геозоны.

Лучшая поддержка фонового режима

iOS позволяет приложению работать в фоновом режиме. Оно получит уведомление о пересечении границы геозоны даже, когда не используется. Благодаря этому можно, например, автоматически предлагать купоны или специальные предложения, когда человек приближается к магазину. Или же трекать важные события для логистических и мониторинговых приложений без активного участия пользователя.

Повышенная точность определения местоположения внутри помещений

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

Беакон-маячок

Я использовала маячок Holyiot nRF52810. Он выделяется своим ультранизким энергопотреблением, компактным размером и водонепроницаемым корпусом.

С помощью приложения Holyiot-beacon можно легко настроить маячок становятся и адаптировать параметры под конкретные нужды.

Общие характеристики

• Мощность сигнала и дальность действия:

Маячок способен передавать сигнал на расстояние до 50 метров в открытом пространстве с регулируемой мощностью передачи от -40dB до +4dB. По умолчанию мощность установлена на +4dB, что оптимизирует дальность и энергопотребление.

• Длительность жизни батареи:

С учетом емкости батареи CR2032 в 220 mAh и среднего энергопотребления в 49uA при +4dB и интервале передачи в 500ms, маячок обеспечивает работу до 180 дней без замены батареи. Это делает маячок особенно подходящим для задач, требующих долгосрочного размещения без обслуживания.

• Водонепроницаемость:

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

• Физические параметры:

Маячок имеет компактные размеры с диаметром 30 мм и толщиной 8.4 мм при весе всего 6.5 г, что делает его легко интегрируемым в любую среду.

Настройка маячка

Загрузка приложения

• Откройте магазин приложений на смартфоне (App Store для iOS или Google Play для Android).• В поиске введите «Holyiot-beacon» и найдите приложение для конфигурации маяков от Holyiot.• Установите приложение на устройство.

Поиск устройства

• Запустите приложение «Holyiot-beacon» на смартфоне.• В приложении выберите тип устройства для поиска: может быть выбран beacon, ibeacon или eddystone в зависимости от потребностей.• Приложение начнет поиск доступных устройств поблизости.

Подключение к маяку

• Когда маяк будет обнаружен, выберите его в списке доступных устройств.• Для подключения к маяку и доступа к дополнительной информации нажмите на кнопку «Connect».• При запросе введите пароль для подключения. По умолчанию пароль: х`aa14061112`.

Конфигурация маяка

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

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

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

UUID (Универсальный уникальный идентификатор)UUID — это 128-битный идентификатор, который используется для обозначения определенной группы или категории маяков в большом пространстве. Он позволяет мобильному приложению отличать маяки вашей организации.

Major и MinorMajor и Minor — это числовые значения, используемые для идентификации подгруппы внутри группы маяков с одинаковым UUID. Major обычно определяет более крупную подгруппу, а Minor — более мелкую. Эти параметры позволяют создавать дополнительную иерархию или структурирование внутри вашей системы маяков, упрощая управление и целенаправленное взаимодействие в приложении.

TX Power (Мощность передачи)TX Power отражает мощность сигнала, с которой маяк передает свои данные. Этот параметр напрямую влияет на дальность действия маяка и потребление энергии. Настройка оптимальной мощности передачи позволяет сбалансировать видимость маяка и длительность его работы от батареи.

ADV_interval (Интервал рекламы)ADV_interval — это время между последовательными передачами рекламных пакетов Bluetooth от маяка. Интервал влияет на то, насколько часто маяк «объявляет» о себе, что влияет на энергопотребление и скорость реакции приложений на появление или исчезновение маяка из зоны действия. Уменьшение интервала увеличивает шансы на быстрое обнаружение маяка, но также увеличивает энергопотребление.

Внесите необходимые изменения и сохраните настройки. Некоторые изменения могут потребовать повторного подключения к маяку или перезагрузки маяка.

Реализация нативного модуля в React Native для iOS

Когда мы разрабатывали приложение на React Native, искали решение для работы с маяками iBeacon, но не нашли такого, которое бы полностью соответствовало нашим требованиям. Поэтому решили разработать собственный нативный модуль для iOS, чтобы максимально использовать возможности этой платформы для взаимодействия с маяками.

Создание нативного модуля

Сперва создаем нативный модуль для iOS, который интегрируем с React Native. Для этого пишем код на Swift или Objective-C, который будет вызван из JavaScript. Этот процесс включает в себя объявление методов, доступных для вызова из React Native, и настройку событийной модели для обмена данными между нативной и JavaScript частями приложения.

Подробные инструкции по созданию и интеграции нативных модулей в проект React Native, включая примеры кода и наилучшие практики, вы найдете в официальной документации React Native.

Настройка необходимых разрешений

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

Откройте настройки проекта в Xcode и перейдите в раздел «Signing & Capabilities".

Здесь необходимо добавить два ключевых capability: «Background Modes" и "Push Notifications".

• Активация «Location updates» и «Uses Bluetooth LE accessories» в разделе «Background Modes» позволяет приложению получать данные о местоположении и работать с Bluetooth-аксессуарами, даже когда оно находится в фоновом режиме.

• Включение «Push Notifications» необходимо, чтобы приложение могло отправлять пользователю локальные уведомления при входе или выходе из зоны действия маяка.

Для корректной работы с маяками и Bluetooth в iOS, важно добавить в файл Info.plist проекта необходимые строки разрешений. Эти строки информируют пользователя о том, как приложение собирается использовать данные или функции устройства.

Вот ключевые разрешения, которые обычно требуются:

Privacy - Location Always and When In Use Usage Description

(NSLocationAlwaysAndWhenInUseUsageDescription): Требуется описание, почему приложению нужен доступ к данным о местоположении пользователя в любое время, включая фоновый режим.

Например, «Это приложение использует ваше местоположение для определения близости к интересующим вас маякам, даже когда приложение находится в фоновом режиме».

Privacy - Location When In Use Usage Description

(`NSLocationWhenInUseUsageDescription`): Необходимо указать причину, по которой приложению требуется доступ к информации о местоположении, когда оно используется.

Пример описания: «Приложению требуется доступ к вашему местоположению, чтобы уведомлять вас о маяках поблизости, когда вы используете приложение».

Privacy - Bluetooth Always Usage Description

(`NSBluetoothAlwaysUsageDescription`): Поскольку модуль использует Bluetooth для определения маяков, необходимо объяснить, зачем приложению постоянный доступ к Bluetooth.

Пример: «Доступ к Bluetooth используется для обнаружения маяков вокруг вас, чтобы предоставить соответствующую информацию и уведомления».

Privacy - Bluetooth Peripheral Usage Description

(`NSBluetoothPeripheralUsageDescription`): Это объяснение нужно, если ваше приложение собирается выступать в роли Bluetooth-периферии.

Например: «Это приложение использует Bluetooth для связи с маяками и другими устройствами в вашей окрестности».

Реализация

BeaconManager.swift

import CoreBluetooth
import CoreLocation
import React
import UserNotifications

// Объявляем класс BeaconManager, который реализует интерфейсы для работы с React Native и делегаты для мониторинга маяков и Bluetooth
@objc(BeaconManager)
class BeaconManager: NSObject, RCTBridgeModule, CLLocationManagerDelegate, CBCentralManagerDelegate
{

  // Имя модуля для React Native
  static func moduleName() -> String {
    return "BeaconManager"
  }

  private var locationManager: CLLocationManager!
  private var beaconRegion: CLBeaconRegion!
  public var bridge: RCTBridge!
  private var centralManager: CBCentralManager!

  // Метод для отправки локальных уведомлений
  func sendLocalNotification(with message: String) {
    let content = UNMutableNotificationContent()
    content.title = message  // Заголовок уведомления
    content.body = "This is a region event"  // Текст уведомления
    content.sound = .default  // Звук уведомления

    let request = UNNotificationRequest(
      identifier: UUID().uuidString, content: content, trigger: nil)  // Создание запроса на уведомление
    UNUserNotificationCenter.current().add(request, withCompletionHandler: nil)  // Добавление запроса в центр уведомлений
  }

  // Начать сканирование маяков с заданным UUID
  @objc func startScanning(_ uuid: String, config: NSDictionary) {
    // Запрос разрешений на отправку уведомлений
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound]) {
      granted, error in
      if granted {
        print("Notifications allowed")
      } else {
        print("Notifications not allowed")
      }
    }
    DispatchQueue.main.async {
      self.locationManager = CLLocationManager()  // Инициализация CLLocationManager
      self.locationManager.delegate = self  // Установка делегата
      self.locationManager.requestAlwaysAuthorization()  // Запрос на постоянный доступ к геолокации

      // Проверка и установка настроек для сканирования в фоновом режиме
      self.locationManager.allowsBackgroundLocationUpdates = true
      self.locationManager.pausesLocationUpdatesAutomatically = false

      let uuid = UUID(uuidString: uuid)!  // Преобразование строки UUID в UUID
      let beaconConstraint = CLBeaconIdentityConstraint(uuid: uuid)  // Создание ограничения для маяка
      self.beaconRegion = CLBeaconRegion(
        beaconIdentityConstraint: beaconConstraint, identifier: "BeaconManagerRegion")  // Инициализация региона маяка
      self.beaconRegion.notifyOnEntry = true  // Уведомление при входе в регион
      self.beaconRegion.notifyOnExit = true  // Уведомление при выходе из региона

      self.locationManager.startMonitoring(for: self.beaconRegion)  // Начало мониторинга региона
      self.locationManager.startRangingBeacons(in: self.beaconRegion)  // Начало определения расстояния до маяков в регионе
    }
  }

  // Остановить сканирование маяков
  @objc func stopScanning() {
    if let beaconRegion = self.beaconRegion {
      self.locationManager.stopMonitoring(for: beaconRegion)  // Остановка мониторинга региона
      self.locationManager.stopRangingBeacons(in: beaconRegion)  // Остановка определения расстояния до маяков
      self.beaconRegion = nil  // Сброс региона маяка
      self.locationManager = nil  // Сброс CLLocationManager
    }
  }

  // Инициализация менеджера Bluetooth
  @objc func initializeBluetoothManager() {
    centralManager = CBCentralManager(
      delegate: self, queue: nil, options: [CBCentralManagerOptionShowPowerAlertKey: false])
  }

  // Обработка изменения состояния Bluetooth
  func centralManagerDidUpdateState(_ central: CBCentralManager) {
    var msg = ""
    switch central.state {
    case .unknown: msg = "unknown"
    case .resetting: msg = "resetting"
    case .unsupported: msg = "unsupported"
    case .unauthorized: msg = "unauthorized"
    case .poweredOff: msg = "poweredOff"
    case .poweredOn: msg = "poweredOn"
    @unknown default: msg = "unknown"
    }
    bridge.eventDispatcher().sendAppEvent(withName: "onBluetoothStateChanged", body: ["state": msg])  // Отправка события изменения состояния Bluetooth в React Native
  }

  // Запрос на постоянный доступ к геолокации
  @objc func requestAlwaysAuthorization(
    _ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock
  ) {
    let locationManager = CLLocationManager()
    locationManager.delegate = self
    locationManager.requestAlwaysAuthorization()
    let status = CLLocationManager.authorizationStatus()
    let statusString = statusToString(status)
    resolve(["status": statusString])
  }

  // Запрос на доступ к геолокации при использовании приложения
  @objc func requestWhenInUseAuthorization(
    _ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock
  ) {
    let locationManager = CLLocationManager()
    locationManager.delegate = self
    locationManager.requestWhenInUseAuthorization()
    let status = CLLocationManager.authorizationStatus()
    let statusString = statusToString(status)
    resolve(["status": statusString])
  }

  // Получение текущего статуса разрешений геолокации
  @objc func getAuthorizationStatus(
    _ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock
  ) {
    let status = CLLocationManager.authorizationStatus()
    resolve(statusToString(status))
  }

  // Обработка событий входа в регион и выхода из региона
  func locationManager(_ manager: CLLocationManager, didEnterRegion region: CLRegion) {
    if let beaconRegion = region as? CLBeaconRegion {
      sendLocalNotification(with: "Entered region: \(region.identifier)")  // Отправка уведомления о входе в регион
      if let bridge = self.bridge {
        bridge.eventDispatcher().sendAppEvent(
          withName: "onEnterRegion", body: ["region": beaconRegion.identifier])  // Отправка события входа в регион в React Native
      }
    }
  }

  func locationManager(_ manager: CLLocationManager, didExitRegion region: CLRegion) {
    if let beaconRegion = region as? CLBeaconRegion {
      sendLocalNotification(with: "Exit region: \(region.identifier)")  // Отправка уведомления о выходе из региона
      if let bridge = self.bridge {
        bridge.eventDispatcher().sendAppEvent(
          withName: "onExitRegion", body: ["region": beaconRegion.identifier])  // Отправка события выхода из региона в React Native
      }
    }
  }

  // Обработка обнаружения маяков в регионе
  func locationManager(
    _ manager: CLLocationManager, didRangeBeacons beacons: [CLBeacon], in region: CLBeaconRegion
  ) {
    let beaconArray = beacons.map { beacon -> [String: Any] in
      return [
        "uuid": beacon.uuid.uuidString,  // UUID маяка
        "major": beacon.major.intValue,  // Major значение маяка
        "minor": beacon.minor.intValue,  // Minor значение маяка
        "distance": beacon.accuracy,  // Точность расстояния до маяка
        "rssi": beacon.rssi,  // Мощность сигнала маяка
      ]
    }
    if let bridge = bridge {
      bridge.eventDispatcher().sendAppEvent(withName: "onBeaconsDetected", body: beaconArray)  // Отправка данных об обнаруженных маяках в React Native
    }
  }

  // Обработка изменения разрешений геолокации
  func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
    if #available(iOS 14.0, *) {
      if manager.authorizationStatus == .authorizedAlways
        || manager.authorizationStatus == .authorizedWhenInUse
      {
        locationManager.startMonitoring(for: beaconRegion)  // Начало мониторинга региона
        locationManager.startRangingBeacons(in: beaconRegion)  // Начало определения расстояния до маяков
      }
    } else {
      if CLLocationManager.authorizationStatus() == .authorizedAlways
        || CLLocationManager.authorizationStatus() == .authorizedWhenInUse
      {
        locationManager.startMonitoring(for: beaconRegion)
        locationManager.startRangingBeacons(in: beaconRegion)
      }
    }
  }

  // Вспомогательный метод для преобразования статуса разрешения геолокации в строку
  private func statusToString(_ status: CLAuthorizationStatus) -> String {
    switch status {
    case .notDetermined: return "notDetermined"
    case .restricted: return "restricted"
    case .denied: return "denied"
    case .authorizedAlways: return "authorizedAlways"
    case .authorizedWhenInUse: return "authorizedWhenInUse"
    @unknown default: return "unknown"
    }
  }
}

BeaconManagerBridge.m

#import "React/RCTBridgeModule.h"

@interface RCT_EXTERN_MODULE(BeaconManager, NSObject)

RCT_EXTERN_METHOD(startScanning:(NSString *)uuid config:(NSDictionary *)config)
RCT_EXTERN_METHOD(stopScanning)
RCT_EXTERN_METHOD(requestAlwaysAuthorization:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
RCT_EXTERN_METHOD(requestWhenInUseAuthorization:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
RCT_EXTERN_METHOD(getAuthorizationStatus:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
RCT_EXTERN_METHOD(initializeBluetoothManager)

+ (BOOL)requiresMainQueueSetup {
  return YES;
}

@end

App.js

import React, {useEffect, useState} from 'react';
import {View, NativeModules, Text} from 'react-native';
import {DeviceEventEmitter} from 'react-native';

const {BeaconManager} = NativeModules;

BeaconManager.requestAlwaysAuthorization();

BeaconManager.startScanning('FDA50693-A4E2-4FB1-AFCF-C6EB07647825');

const App = () => {
  const [inRegion, setInRegion] = useState(false);
  useEffect(() => {
    DeviceEventEmitter.addListener('onBeaconsDetected', beacons => {
      console.log('onBeaconsDetected', beacons);
    });
  }, []);

  useEffect(() => {
    DeviceEventEmitter.addListener('onEnterRegion', beacons => {
      setInRegion(true);
    });
  }, []);

  useEffect(() => {
    DeviceEventEmitter.addListener('onExitRegion', beacons => {
      setInRegion(false);
    });
  }, []);

  return (
    <View
      style={{
        flex: 1,
        alignItems: 'center',
        justifyContent: 'center',
        paddingHorizontal: 32,
        backgroundColor: inRegion ? '#62BB46' : '#472F92',
      }}>
      <Text style={{color: '#fff', fontWeight: 600, fontSize: 16}}>
        {inRegion
          ? 'You are within the range of the beacon'
          : 'You are out of range of the beacon'}
      </Text>
    </View>
  );
};

export default App;

Работа с маяками в фоновом режиме

Методы `didEnterRegion` и `didExitRegion` являются частью протокола `CLLocationManagerDelegate` и вызываются, когда устройство входит в зону действия маяка или выходит из неё соответственно. Эти методы позволяют приложениям реагировать на изменения местоположения пользователя даже в фоновом режиме.

Ограничения и особенности

⭕ Ограничения iOS на фоновую работу

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

Apple может ограничивать частоту обновлений местоположения или временно приостанавливать фоновую активность приложения для оптимизации работы системы. Также iOS предоставляет ограниченное время для выполнения необходимых действий в ответ на это событие. Это время может варьироваться, но обычно составляет несколько секунд. За это время приложение должно успеть выполнить все необходимые операции.

⭕ Ограничения на отправку уведомлений

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

⭕ Задержки реагирования

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

⭕ Требования к точности и конфигурации маяка

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

Работа с маяками в фоне значительно расширяет функциональные возможности приложений, позволяя создавать продвинутые решения для локационных сервисов, навигации внутри зданий, автоматизированного взаимодействия с пользователем и многого другого. Однако при разработке таких приложений важно учитывать упомянутые выше особенности и ограничения, чтобы обеспечить наилучшую производительность и пользовательский опыт.

Если вас заинтересовала эта тема, и вы хотите разобраться, как можно применять маяки в жизни, читайте нашу статью "Технология BLE для бизнеса"

Использование технологии iBeacon в React Native