Разблокировка электросамоката по BLE/QR через мобильное приложение
Мы разрабатываем систему разблокировки электросамокатов через мобильное приложение. Пользователь сканирует QR, наше приложение общается с сервером и отправляет BLE-команду — всё за секунды. За 5+ лет работы над 10+ шеринговыми проектами мы знаем: любой сбой в этом пути мгновенно подрывает доверие к сервису. Любая задержка воспринимается как баг, поэтому мы уделяем внимание каждой миллисекунде. Один из наших клиентов, запуская кикшеринг в городе с 500 самокатами, столкнулся с тем, что 15% пользователей бросали аренду на этапе разблокировки — из-за медленного BLE-подключения. Мы оптимизировали протокол, и отток снизился до 3%.
Как работает разблокировка по QR?
QR на самокате кодирует идентификатор устройства: строка вида https://ride.example.com/unlock?id=SC-00234 или просто SC-00234. Сканируем через ML Kit Barcode Scanning (Android/iOS) или AVFoundation AVCaptureMetadataOutput. ML Kit предпочтительнее — работает без сетевого соединения, быстрее в условиях плохого освещения.
После получения ID — запрос на сервер: POST /api/v1/unlock с {scooterId, userId, sessionToken}. Сервер проверяет баланс/подписку, резервирует самокат, возвращает {bleUnlockToken, bleDeviceAddress, lockServiceUUID, lockCharacteristicUUID, expiresAt}. Токен одноразовый, живёт 30-60 секунд — если BLE-подключение не успело, пользователь получает ошибку и инициирует новый запрос.
// iOS: сканирование QR через AVFoundation class QRScannerViewController: UIViewController, AVCaptureMetadataOutputObjectsDelegate { func metadataOutput(_ output: AVCaptureMetadataOutput, didOutput metadataObjects: [AVMetadataObject], from connection: AVCaptureConnection) { guard let readableObject = metadataObjects.first as? AVMetadataMachineReadableCodeObject, let stringValue = readableObject.stringValue, let scooterId = parseScooterId(from: stringValue) else { return } captureSession.stopRunning() Task { await viewModel.initiateUnlock(scooterId: scooterId) } } } Почему BLE-токен истекает?
Самокаты в шеринге используют BLE-модули на Nordic nRF52 или ESP32 с кастомным GATT-профилем. Схема проста: пишем токен в WriteCharacteristic, контроллер проверяет HMAC-подпись токена (общий секрет зашит в прошивку), при совпадении — снимает электромагнитный замок и разрешает мотор.
// Android: запись unlock-токена в BLE characteristic class ScooterUnlockManager(private val context: Context) { private var gatt: BluetoothGatt? = null suspend fun unlock(address: String, token: UnlockToken): UnlockResult { return suspendCancellableCoroutine { cont -> val device = bluetoothAdapter.getRemoteDevice(address) gatt = device.connectGatt(context, false, object : BluetoothGattCallback() { override fun onConnectionStateChange(g: BluetoothGatt, status: Int, state: Int) { if (state == BluetoothProfile.STATE_CONNECTED) g.discoverServices() else if (status != BluetoothGatt.GATT_SUCCESS) { cont.resume(UnlockResult.BleConnectionFailed(status)) } } override fun onServicesDiscovered(g: BluetoothGatt, status: Int) { val characteristic = g .getService(token.serviceUUID) ?.getCharacteristic(token.characteristicUUID) ?: run { cont.resume(UnlockResult.ServiceNotFound); return } characteristic.value = token.payload.toByteArray() characteristic.writeType = BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT g.writeCharacteristic(characteristic) } override fun onCharacteristicWrite(g: BluetoothGatt, characteristic: BluetoothGattCharacteristic, status: Int) { val result = if (status == BluetoothGatt.GATT_SUCCESS) UnlockResult.Success else UnlockResult.WriteFailed(status) cont.resume(result) g.disconnect() } }, BluetoothDevice.TRANSPORT_LE) cont.invokeOnCancellation { gatt?.disconnect() } } } } Критичная деталь: TRANSPORT_LE в connectGatt — без этого флага Android может попытаться подключиться через Classic Bluetooth, что даёт status=133 на устройствах BLE-only.
Проблемы в реальных условиях
Плохой BLE-сигнал. Самокат стоит в подземном паркинге, вокруг 20 других самокатов с теми же GATT-сервисами. Сканируем не все устройства подряд, а адресно: bluetoothAdapter.getRemoteDevice(address) по MAC из серверного ответа. Это быстрее, чем сканировать окружение.
Истёкший токен. Пользователь отсканировал QR, потом отвлёкся на 2 минуты. Токен истёк. При получении GATT_SUCCESS на запись, но самокат не разблокировался — нужен Notify Characteristic для ответа от контроллера. Контроллер пишет в ответный characteristic: 0x01 (OK), 0x02 (token expired), 0x03 (already locked by another session).
Android 12+ Bluetooth permissions. BLUETOOTH_SCAN и BLUETOOTH_CONNECT — теперь runtime permissions. Если пользователь отклонил и выбрал «Не спрашивать снова», shouldShowRequestPermissionRationale возвращает false — ведём его в Settings через Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).
UX-детали, которые делают разницу
Параллельный запуск сервера и BLE: как только получен ответ сервера с адресом устройства, начинаем BLE-подключение не дожидаясь финальной анимации UI. Пользователь видит спиннер, а BLE-handshake уже идёт. Экономит ~300-500 мс. Также стоит использовать кэширование токенов: если самокат уже был подключён ранее, можно попробовать восстановить подключение без повторного QR-сканирования. Это сокращает среднее время разблокировки на 20-30%.
Сравнение подходов к разблокировке
| Характеристика | BLE | NFC | QR + BLE |
|---|---|---|---|
| Скорость | 1-2 сек | 0.5 сек | 1-3 сек |
| Безопасность | HMAC-токен | Криптоключ | Токен + HMAC |
| Совместимость | iOS/Android | iPhone 7+, Android 5+ | Почти все смартфоны |
| Доп. оборудование | Нет | NFC-модуль | Только BLE |
| Надёжность в условиях шума | Средняя (адресное подключение) | Высокая | Высокая (адресное) |
На основе исследований Bluetooth SIG и документации Apple Core Bluetooth.
Типичные ошибки при внедрении BLE-разблокировки
| Ошибка | Последствие | Решение |
|---|---|---|
Пропущен TRANSPORT_LE |
Ошибка подключения на Android | Явно указывать параметр |
| Одновременные запросы с нескольких устройств | Конфликт токенов | Резервировать самокат на сервере |
| Отсутствие уведомлений после записи | Невозможность узнать результат | Использовать Notify-характеристику |
| Токен без временной метки | Возможность повторного использования | HMAC с timestamp |
Что входит в работу
- Модуль QR-сканирования для iOS и Android (ML Kit / AVFoundation)
- BLE-команда разблокировки с поддержкой GATT-профиля
- Бэкенд-сервис аутентификации и резервирования
- Тестирование на реальных самокатах (Nordic nRF52, ESP32)
- Документация по интеграции и обучение команды
Сроки и стоимость
Разработка модуля QR-сканирования + BLE-разблокировки для шеринговой платформы (iOS + Android): 3-5 недель. С полным флотовым бэкендом (резервирование, биллинг, геофенсинг): 3-5 месяцев. Стоимость рассчитывается индивидуально в зависимости от сложности прошивки и требований к безопасности. Свяжитесь для консультации — мы оперативно оценим ваш проект.
Этапы реализации
- Аудит текущего оборудования самоката (BLE-модуль, прошивка)
- Проектирование GATT-профиля и протокола
- Разработка iOS-модуля (Swift, Combine)
- Разработка Android-модуля (Kotlin, Coroutines)
- Интеграция с сервером (REST/GraphQL)
- Тестирование (unit, integration, полевое)
- Деплой в App Store и Google Play
- Мониторинг и поддержка после запуска
Оценим ваш проект в течение 1 рабочего дня. Получите консультацию прямо сейчас — напишите нам!