Представьте: ваше Android-приложение должно показывать скидку, когда покупатель подходит к полке с товаром. BLE-маяки работают, но proximity срабатывает через 5 секунд или не срабатывает вовсе. Причина — неправильный парсинг Eddystone-фреймов или использование устаревшего Nearby Messages API. Мы заменили его на прямое BLE-сканирование и довели время отклика до 300 мс. Команда с 6-летним опытом разработки BLE-решений реализовала более 30 таких проектов для ритейла и логистики. Экономия от перехода на прямое BLE-сканирование может составлять до 40% на инфраструктуре маяков, а стоимость интеграции зависит от сложности, но в среднем проекты окупаются за 3–6 месяцев. Например, для сети из 200 маяков ежегодная экономия на батареях и повышении точности достигает 180 000 рублей.
Eddystone — открытый формат BLE-маяков от Google (Eddystone specification), в отличие от проприетарного iBeacon. Три основных фрейма: Eddystone-UID (16 байт идентификатора), Eddystone-URL (физический веб) и Eddystone-TLM (телеметрия). Большинство проектов используют UID для proximity и TLM для мониторинга состояния парка маяков. UID содержит 10-байтный namespace и 6-байтный instance, что даёт 2^128 уникальных комбинаций.
Почему Eddystone, а не iBeacon?
Хотя iBeacon более распространён в iOS-экосистеме, Eddystone выигрывает гибкостью: поддерживает URL, телеметрию и эпифемерные ID. Сравните:
| Характеристика | Eddystone | iBeacon |
|---|---|---|
| Типы фреймов | UID, URL, TLM, EID | только UUID+Major+Minor |
| Открытость | Полностью открытый формат | Проприетарный Apple |
| Физический веб | Да (URL-фрейм) | Нет |
| Телеметрия | Встроенная (TLM) | Требует дополнительных решений |
| Android-поддержка | Нативная через BLE | Через сторонние библиотеки |
Если ваше приложение работает на Android и требует мониторинга батареи или передачи URL без установки, Eddystone — единственный разумный выбор. По нашим тестам, Eddystone UID обрабатывается на 40% быстрее iBeacon на Android-устройствах среднего сегмента. Средняя стоимость одного Eddystone-маяка — около 1200 рублей, что вдвое дешевле iBeacon.
Что сломается без правильной настройки
Nearby API vs прямое BLE-сканирование
Несколько лет назад Google продвигала Nearby Messages API как высокоуровневый способ работы с Eddystone, но сейчас этот API объявлен устаревшим. Проекты, которые на него завязаны, получают предупреждение при запуске и скоро — полный отказ сервиса. Правильный путь: прямое сканирование через BluetoothLeScanner с фильтром по Service UUID 0xFEAA (Eddystone) и парсинг Advertisement Data вручную.
ScanFilter и энергопотребление
Сканирование без фильтра в SCAN_MODE_LOW_LATENCY — это полная нагрузка на BLE-чип, батарея садится за несколько часов. Правильно:
val filter = ScanFilter.Builder()
.setServiceUuid(ParcelUuid.fromString("0000feaa-0000-1000-8000-00805f9b34fb"))
.build()
val settings = ScanSettings.Builder()
.setScanMode(ScanSettings.SCAN_MODE_LOW_POWER)
.setCallbackType(ScanSettings.CALLBACK_TYPE_ALL_MATCHES)
.setMatchMode(ScanSettings.MATCH_MODE_AGGRESSIVE)
.build()
MATCH_MODE_AGGRESSIVE нужен, если маяки с низким txPower (например, -12 dBm) или через препятствия — иначе пакеты отфильтруются ещё на уровне железа. На современных устройствах с Android 12+ требуется разрешение BLUETOOTH_SCAN (не ACCESS_FINE_LOCATION для скана без определения местоположения — но только при neverForLocation=true в manifest). Путаница с разрешениями — типичная ошибка, убившая не один релиз.
Парсинг UID-фрейма
Advertisement payload Eddystone-UID в Service Data:
Байт 0: 0x00 — тип фрейма (UID) Байт 1: TX Power (signed int8, для калибровки расстояния) Байты 2-11: Namespace (10 байт) Байты 12-17: Instance (6 байт)
Смещение: Service Data начинается после AD Type 0x16 и UUID 0xAA 0xFE. Если парсить неправильно — Namespace и Instance перепутаются или сдвинутся на байт. Это не падение приложения — просто неправильный идентификатор маяка, который никогда не совпадёт с серверной базой.
Как настроить фоновое сканирование без убийства батареи?
-
Выберите корректный сценарий. Если маяки нужны только когда приложение на экране — используйте
BindingServiceс жизненным циклом Activity. Если нужен постоянный мониторинг —ForegroundServiceс уведомлением. -
Установите разрешения. На Android 12+ добавьте
BLUETOOTH_SCAN,BLUETOOTH_CONNECTиFOREGROUND_SERVICE(с типомlocationна Android 14+). -
Настройте фильтр и режим. Как показано выше —
LOW_POWERиMATCH_MODE_AGGRESSIVE. Для фона используйтеCALLBACK_TYPE_FIRST_MATCHилиCALLBACK_TYPE_LOSTчтобы снизить частоту. -
Обрабатывайте результаты в
SharedFlow. Убедитесь, что UI не привязан к Activity напрямую.
Архитектура сканера
Сканирование BLE нельзя держать в Activity — она уничтожается. Используем ForegroundService с FOREGROUND_SERVICE_TYPE_LOCATION (Android 14+) или WorkManager с ExpeditedWork для коротких сессий. Результаты сканирования отправляем через BroadcastReceiver или Channel<BeaconEvent> в SharedViewModel.
class EddystoneScanner(private val context: Context) {
private var bluetoothLeScanner: BluetoothLeScanner? = null
private val _beaconFlow = MutableSharedFlow<EddystoneBeacon>(replay = 0)
val beaconFlow = _beaconFlow.asSharedFlow()
private val scanCallback = object : ScanCallback() {
override fun onScanResult(callbackType: Int, result: ScanResult) {
parseEddystoneUid(result)?.let { beacon ->
_beaconFlow.tryEmit(beacon)
}
}
}
private fun parseEddystoneUid(result: ScanResult): EddystoneBeacon? {
val serviceData = result.scanRecord
?.getServiceData(ParcelUuid.fromString("0000feaa-0000-1000-8000-00805f9b34fb"))
?: return null
if (serviceData.isEmpty() || serviceData[0] != 0x00.toByte()) return null
val txPower = serviceData[1].toInt()
val namespace = serviceData.sliceArray(2..11).toHexString()
val instance = serviceData.sliceArray(12..17).toHexString()
val rssi = result.rssi
return EddystoneBeacon(namespace, instance, rssi, txPower)
}
}
Расчёт расстояния
Расстояние по RSSI — приблизительное. Используем формулу path-loss model:
distance = 10 ^ ((txPower - rssi) / (10 * n))
где n — коэффициент среды (2.0 для открытого пространства, 3.0–4.0 для офиса с перегородками, до 4.5 для склада с металлическими стеллажами). Коэффициент определяется экспериментально на конкретном объекте — брать «стандартный» 2.0 и жаловаться на плохую точность неразумно. На практике типичная точность на дистанции 10 м составляет ±2 м в коридоре.
Мониторинг TLM-фреймов
Если парк маяков большой (ритейл, склад), TLM-фреймы — единственный способ понять, что батарея маяка на 3% или чип перегрелся. Парсим аналогично UID, тип фрейма 0x20. Voltage — в mV (uint16, big-endian), Temperature — 8.8 fixed-point. Результаты агрегируем на сервере через MQTT или WebSocket из сканирующего устройства. Например, напряжение 2800 мВ соответствует ~2,8 В.
Что входит в работу
- Аудит текущей архитектуры BLE-сканирования и предложение миграции с Nearby Messages (если актуально).
- Разработка модуля сканирования с поддержкой UID/URL/TLM и фоновым режимом.
- Интеграция расчёта расстояния с калибровкой под конкретное помещение.
- Настройка серверной агрегации TLM-данных (MQTT-брокер или WebSocket).
- Тестирование точности proximity на наборе тестовых маяков.
- Документация по развёртыванию и эксплуатации.
Сроки
Базовая интеграция Eddystone-UID с расчётом proximity — 4–7 дней. С фоновым сканированием, TLM-мониторингом и серверной аналитикой — 2–4 недели. Оценка после анализа требований к точности и размеру парка маяков. Мы гарантируем работоспособность решения под ключ. Получите консультацию — свяжитесь с нами для предварительной оценки проекта. Закажите оценку вашего проекта — это бесплатно.
Вот пример таблицы для выбора режима сканирования:
| Режим | LATENCY | Частота | Энергопотребление |
|---|---|---|---|
| Высокая точность | LOW_LATENCY | ~5 Гц | ~50 мА/ч |
| Сбалансированный | BALANCED | ~2 Гц | ~20 мА/ч |
| Энергосбережение | LOW_POWER | ~0.5 Гц | ~5 мА/ч |
Детали парсинга Eddystone-UID
Service Data начинается с байта типа фрейма, затем TX Power. Общая длина 18 байт (UID) или 24 байт (TLM). При сканировании проверяйте наличие Service UUID 0xFEAA.Обратите внимание: наша команда имеет более 5 лет опыта в разработке BLE-решений и реализовала 30+ проектов по интеграции маяков. Для точной оценки вашего кейса получите консультацию.