Bluetooth-устройство в браузере: что проверить до подключения датчика
- Как сверить поддержку Web Bluetooth по браузерам и платформам до начала работ
- Какие проверки контекста, Permissions Policy и разрешений пройти заранее
- Почему вызов выбора устройства привязан к жесту пользователя и что задать в фильтрах
- Как обработать отключение и заново получить GATT-атрибуты после переподключения
Датчик на столе, страница с графиком почти готова, а устройство в списке не появляется. Или появляется, но обмен данными падает на первом же запросе к сервису. Причина обычно не в коде чтения характеристик, а в проверках, которые нужно пройти раньше: поддержка API, защищённый контекст, разрешения и пользовательский жест.
Web Bluetooth API позволяет сайтам общаться с устройствами Bluetooth (F7). Но это экспериментальная технология с ограниченной доступностью: она не входит в Baseline, потому что не работает в части широко используемых браузеров (F1). Значит, до подключения датчика стоит ответить на несколько вопросов о среде, в которой откроется страница.
Ниже — порядок проверок и типичные места, где интеграция ломается. Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему устройству и целевым браузерам. Смежная тема — передача файлов между браузерами, а работы с сайтами и кабинетами собраны на странице контента и сайтов.
Зачем проверять ограничения до подключения датчика
Соблазн начать с кода обмена данными понятен: хочется скорее увидеть показания на графике. Но если браузер не поддерживает API или страница открыта не в защищённом контексте, обмен не начнётся вовсе, и время уйдёт на отладку несуществующей проблемы.
Проверка ограничений заранее отвечает на простой вопрос: где эта функция вообще может работать. Ответ на него определяет, нужен ли запасной сценарий для неподдерживающих браузеров и стоит ли вообще строить интерфейс вокруг прямого подключения.
Отдельно стоит помнить, что пометка MDN — это общая характеристика на дату последней правки страницы, а не список конкретных версий. Конкретику даёт таблица совместимости, и её нужно смотреть отдельно.
Поддержка браузеров и платформ: что сверить заранее
Начните с таблицы совместимости MDN: она показывает, в каких браузерах API доступен, а в каких нет. Пометка о том, что технология экспериментальная и не Baseline, означает: рассчитывать на неё как на универсальную нельзя (F1).
Документация Chrome описывает подмножество API как доступное в ChromeOS, Chrome для Android 6.0, Mac (Chrome 56) и Windows 10 (Chrome 70) (F8). Это снимок состояния на момент публикации страницы, поэтому версии и платформы стоит сверять с актуальной таблицей, а не принимать как постоянную величину.
Для Linux и более ранних версий Windows в документации Chrome предлагается включить флаг #experimental-web-platform-features в about://flags (F9). Это указание для разработчиков, а не рекомендация конечным пользователям: заставлять клиента менять флаги браузера — плохой запасной план.
Практический вывод: составьте короткий список целевых браузеров и платформ и для каждого отметьте, поддерживается ли API. Если часть аудитории в него не попадает, продумайте, что увидит такой пользователь.
Защищённый контекст, Permissions Policy и разрешение пользователя
Первое техническое условие — защищённый контекст: Web Bluetooth API можно использовать только в нём (F3). Источник не перечисляет, какие именно схемы и адреса считаются защищённым контекстом, поэтому проверьте конкретный адрес вашей страницы по документации, а не по памяти.
Второе условие — Permissions Policy. Доступ к API управляется директивой bluetooth, и по умолчанию allowlist равен self: это разрешает использование в одноимённых вложенных фреймах и по умолчанию закрывает доступ стороннему контенту (F4). Если страница встроена кросс-доменно, проверьте заголовок и атрибуты iframe.
Третье — разрешение пользователя. Для использования функции он должен сначала явно выдать разрешение, а запрос показывается при вызове Bluetooth.requestDevice() для нового устройства, на которое разрешения ещё нет (F5). При этом нужна transient activation, а при блокировке по другим причинам, например по Permissions Policy, запрос не покажется вовсе.
Состояние разрешения можно проверить через navigator.permissions.query() с именем bluetooth: состояния — granted, denied или prompt (F6). Источник не описывает поведение в браузерах без поддержки запроса этого разрешения, поэтому обработайте и такой случай.
Пользовательский жест и выбор устройства
Вызов navigator.bluetooth.requestDevice должен запускаться пользовательским жестом, например pointerup, click или touchend (F10). Это защитная мера, и попытка вызвать выбор устройства из кода инициализации страницы приведёт к отказу.
При вызове браузер показывает пользователю выбор устройства, где можно выбрать одно устройство или отменить запрос (F11). Значит, в интерфейсе нужна понятная кнопка подключения и сообщение на случай отмены — иначе пользователь решит, что страница зависла.
Синтетический пример: кнопка «Подключить датчик» вызывает requestDevice из обработчика click, а фильтр задан по имени устройства. Если после подключения код обращается к сервису, которого нет в фильтре, нужен optionalServices — иначе при обращении к нему возникнет ошибка (F12).
Опция exclusionFilters в requestDevice() позволяет исключить часть устройств из выбора браузера, например совпадающих с широким фильтром, но неподдерживаемых (F13). А acceptAllDevices вместо фильтров может показать множество посторонних устройств и привести к лишнему расходу энергии (F14) — используйте осторожно.
Подключение, отключение и повторное получение GATT-атрибутов
Отключение — штатное событие, а не авария. В документации Chrome для улучшения опыта пользователя предлагается слушать события отключения и приглашать пользователя переподключиться (F15). Это лучше, чем молча ждать, пока данные снова появятся.
Вызов device.gatt.disconnect() отключает веб-приложение от устройства и вызывает существующие обработчики gattserverdisconnected, но не останавливает связь, если с устройством уже общается другое приложение (F16). Это стоит учитывать, когда датчик одновременно открыт в другом приложении.
Главная ловушка — устаревшие ссылки. Атрибуты, сервисы и характеристики GATT становятся недействительными при отключении устройства, поэтому их нужно заново получать после переподключения через getPrimaryService(s), getCharacteristic(s) и подобные методы (F17).
Синтетический пример: после события gattserverdisconnected код заново вызывает getPrimaryService и getCharacteristic, а не переиспользует объекты, сохранённые до отключения. Иначе обмен падает на уже недействительных ссылках.
Ограничения окружения: воркеры и последовательность операций
Web Bluetooth API не доступен в Web Workers, так как не экспонируется через WorkerNavigator (F2). Если обмен данными вынесен в воркер, прямого доступа к API там не будет — источник обходных путей не описывает, поэтому архитектуру стоит продумать заранее.
Второе ограничение — последовательность операций. Параллельное чтение и запись характеристик Bluetooth может вызывать ошибки в зависимости от платформы, поэтому в документации Chrome предлагается вручную ставить операции GATT в очередь (F18).
Простая очередь запросов снижает риск гонок и делает поведение предсказуемым. Это не гарантия безошибочной работы на всех платформах, а способ убрать один класс проблем, который иначе проявится нерегулярно.
Чек-лист решений перед стартом интеграции
Соберите проверки в один проход. Поддержка: сверьте таблицу совместимости MDN и статус Chrome, помня, что API не Baseline (F1). Контекст: убедитесь, что страница открывается в защищённом контексте (F3).
Политика доступа: проверьте директиву Permissions Policy bluetooth и атрибуты iframe для кросс-доменных вставок (F4). Разрешение: запросите navigator.permissions.query() с именем bluetooth и обработайте granted, denied и prompt (F6).
Жест: привяжите requestDevice к обработчику pointerup, click или touchend (F10). Фильтры: сверьте фильтры и optionalServices, чтобы обращение к сервису вне фильтра не дало ошибку (F12). Отключение: проверьте обработчик gattserverdisconnected и повторное получение GATT-атрибутов после переподключения (F17).
Если все пункты пройдены, обмен данными с датчиком перестаёт быть лотереей. Если какой-то пункт не проходит, вы узнаете об этом до того, как напишете код чтения характеристик.