Реалізація сканування та підключення BLE-пристроїв

Розробники BLE-додатків часто стикаються з ситуацією: пристрій не виявляється, з'єднання рветься через кілька секунд, або на Android раптово запитується геолокація. Причина — неправильна обробка станів адаптера та фільтрації за сервісними UUID. За 5 років ми реалізували понад 30 комерційних BLE-проєктів і виробили підхід, який гарантує стабільне сканування та підключення без зайвого енергоспоживання. Розберемо його на прикладах на Swift та Kotlin.

Чому важливо обробляти стани адаптера?

На iOS сканування можливе лише коли CBCentralManager.state == .poweredOn. Інші стани потрібно обробляти, щоб користувач розумів, що відбувається:

func centralManagerDidUpdateState(_ central: CBCentralManager) { switch central.state { case .poweredOn: startScanning() case .poweredOff: showAlert("Включіть Bluetooth у налаштуваннях") case .unauthorized: if CBCentralManager.authorization == .denied { showSettingsLink() } case .unsupported: showAlert("Пристрій не підтримує Bluetooth LE") case .resetting: // стек перезагружается, ждём .poweredOn break default: break } } 

Типова помилка: не обробляти .unauthorized на iOS 13+, через що додаток падає з крашем. На Android ситуація складніша — потрібна динамічна перевірка дозволів та правильне налаштування маніфесту, щоб не запитувати геолокацію. Наприклад, додавання android:usesPermissionFlags="neverForLocation" в <uses-permission android:name="android.permission.BLUETOOTH_SCAN" /> дозволяє обійтися без ACCESS_FINE_LOCATION. Без цього прапорця користувач бачить запит місцезнаходження, хоча для сканування BLE воно не потрібне. Зекономте користувачеві зайвий крок.

Як налаштувати фільтрацію BLE-пристроїв?

Фільтрація за сервісними UUID — основа ефективного сканування. Передайте масив UUID у scanForPeripherals(withServices:) на iOS або ScanFilter на Android:

let serviceUUIDs = [CBUUID(string: "YOUR-SERVICE-UUID")] centralManager.scanForPeripherals(withServices: serviceUUIDs, options: [ CBCentralManagerScanOptionAllowDuplicatesKey: false ]) 

withServices: nil — сканує всі BLE-пристрої поруч. Зручно при розробці, але в продакшн ставити не варто: витрачає більше батареї та засмічує список чужими пристроями. На практиці фільтрація скорочує кількість виявлених пристроїв у 3-5 разів.

На Android використовуйте ScanFilter.Builder().setServiceUuid():

val filters = listOf( ScanFilter.Builder() .setServiceUuid(ParcelUuid(UUID.fromString("YOUR-SERVICE-UUID"))) .build() ) 

Важливо: на Android 8+ можна використовувати setDeviceName() для фільтрації за ім'ям, але це менш надійно, оскільки ім'я може бути змінено.

Порівняння режимів сканування на Android

SCAN_MODE_LOW_LATENCY краще SCAN_MODE_BALANCED у 3 рази за швидкістю виявлення, але споживає на 40% більше енергії. Тому для UI-екрану використовуйте LOW_LATENCY, для фону — LOW_POWER. У рекламному кейсі нашого клієнта (фітнес-браслет) заміна LOW_LATENCY на BALANCED знизила енергоспоживання на 18% без помітного збільшення часу виявлення.

Як реалізувати повторне підключення до відомого пристрою?

Якщо UUID периферії збережений (наприклад, у UserDefaults), можна відновити об'єкт без повторного сканування:

let knownUUID = UUID(uuidString: savedUUIDString)! let peripherals = centralManager.retrievePeripherals(withIdentifiers: [knownUUID]) if let peripheral = peripherals.first { centralManager.connect(peripheral, options: nil) } else { // UUID устарел или устройство заменено — запускаем полное сканирование startScanning() } 

Це важливо для додатків, які часто перепідключаються до одного пристрою (браслет, датчик). Без retrievePeripherals щоразу запускається сканування із затримкою ~1-2 секунди, що збільшує час підключення на 30-50%.

На Android для повторного підключення використовуйте connectGatt з autoConnect = true. Збережіть MAC-адресу пристрою або його ідентифікатор із BluetoothDevice. Врахуйте, що на Android 10+ для повторного підключення не потрібне сканування, якщо пристрій було сполучено або до нього вже підключалися.

Як уникнути типових помилок при підключенні?

Помилка 1: підключення до пристрою без повної обробки centralManager(_:didDisconnectPeripheral:error:). Якщо не реалізувати перепідключення, користувач залишиться без зв'язку після тимчасового розриву. Ми рекомендуємо автоматичне перепідключення з експоненційною затримкою (1с, 2с, 4с, 8с, скидання після успіху). Помилка 2: не перевіряти, чи не підключено вже пристрій — це викликає краш. Перед connect перевірте peripheral.state == .disconnected. Помилка 3: на Android не обробляти BluetoothGattCallback.onConnectionStateChange при збої — це призводить до витоку ресурсів.

Процес роботи над BLE-інтеграцією

1. Аналіз вимог — визначаємо, які сервіси та характеристики потрібні, як часто відбувається обмін даними, які пристрої підтримуються.
2. Проектування — обираємо архітектуру: центральна чи периферійна роль, стратегія перепідключення, управління дозволами.
3. Реалізація — пишемо код сканування та підключення з обробкою всіх станів та дозволів. Використовуємо DI для тестованості.
4. Тестування — перевіряємо на реальних пристроях (5+ моделей, включаючи старі версії ОС), симулюємо розриви та втрату сигналу.
5. Документація та підтримка — передаємо інтеграційні матеріали, консультуємо команду.

Що входить у роботу

Реалізуємо сканування та підключення під ключ. Входить:

• Код на Swift/Kotlin з обробкою всіх станів адаптера та дозволів.
• Фільтрація за сервісними UUID та обробка дублікатів.
• Автоматичне перепідключення при розриві зв'язку.
• Інтеграція з вашим додатком (архітектура, DI).
• Консультації та правки після релізу.

Зв'яжіться з нами для оцінки вашого проєкту. Наш досвід: 5+ років у BLE-розробці, 30+ комерційних проєктів. Гарантуємо стабільне з'єднання та дотримання гайдлайнів App Store та Google Play. Замовте реалізацію BLE-модуля з гарантією якості.

Для детального вивчення API рекомендуємо офіційну документацію CBCentralManager та BluetoothLeScanner.