Web Bluetooth сканер и тест

Сканирование и подключение к BLE устройствам через браузер. Чтение характеристик и сервисов.

Окружение

Web Bluetooth API
Web Bluetooth НЕ поддерживается
HTTPS (Secure Context)
Нет
Доступность (getAvailability)
Неизвестно/Не подд.
User-Agent
-
Браузер не поддерживает Web Bluetooth
Используйте Chrome или Edge на компьютере или Android. iOS не поддерживается (обычно).
ГотовУстройство:-
Устройство
Имя: -
ID:-
Статус:Нет
Посл. разрыв:-
Реклама (ADV)
Для мониторинга RSSI без подключения (если поддерживается).

GATT Сервисы и Характеристики

0 сервисов / 0 характеристик
Сначала Подключитесь, затем нажмите Сервисы.

Лог

Пусто

Важно

Сначала посмотрите на «Среду и поддержку»: это должно быть в контексте HTTPS/безопасности; рекомендуется настольная версия Chrome/Edge. iOS Safari обычно не поддерживает Web Bluetooth.
Сканирование должно запускаться жестами пользователя, например «нажатием кнопки»; в противном случае можно легко сообщить о NotAllowedError или быть перехваченным браузером.
Невозможно подключиться/часто отключается: подойдите ближе к устройству, чтобы уменьшить препятствия и помехи 2,4 ГГц; выключите системный Bluetooth, а затем включите или перезагрузите устройство; избегайте занятия другими устройствами/приложениями.
Невозможно перечислить службы/функции: добавьте целевую службу в optionServices (браузер ограничит доступ к необъявленным службам).
Нужна помощь в устранении неполадок. Нажмите «Копировать отчет», чтобы предоставить UA, статус, ошибки и журналы в службу разработки или поддержки клиентов.

Инструкция Bluetooth

Использует Web Bluetooth API. Требует Chrome/Edge и HTTPS.

Шаг 1

Проверка совместимости

ок. 10 сек
В карточке «Среда и поддержка» подтвердите: «Веб-Bluetooth» «Поддерживается» и «Контекст безопасности (HTTPS) = Да».
Если отображается сообщение «Веб-Bluetooth не поддерживается»: вместо этого используйте настольную версию Chrome/Edge; iOS Safari обычно не поддерживает это.
Шаг 2

Сканирование

10-20 сек
Убедитесь, что Bluetooth системы включен и целевое устройство доступно для обнаружения и подключения.
Нажмите «Сканировать устройство» (должно срабатывать по щелчку, автоматическое сканирование невозможно).
Если устройство не найдено: сначала вы можете проверить AcceptAllDevices; или используйте namePrefix/service для фильтрации точного позиционирования.
Шаг 3

Подключение и GATT

10-30 сек
Нажмите «Подключиться», и статус изменится на «Подключено».
Нажмите «Перечислить услуги», чтобы просмотреть список на карточке «Услуги/характеристики GATT».
Если целевую службу невозможно перечислить: добавьте UUID службы в optionServices, повторно просканируйте/подключитесь и повторите попытку.
Шаг 4

Чтение данных

ок. 20 сек
Нажмите «Читать» в списке функций и проверьте, является ли возвращаемое шестнадцатеричное/текстовое содержимое разумным.
Если функция поддерживает уведомление/указание, вы можете нажать «Включить уведомление», чтобы проверить, продолжает ли журнал получать данные.
Если вы столкнулись с ошибкой или вам нужна помощь: нажмите «Копировать отчет», чтобы отправить контент в отдел разработки/службу поддержки клиентов для позиционирования.

FAQ (Bluetooth)

Вопросы о Web Bluetooth API.

1.

Что может сделать эта диагностическая страница Bluetooth?

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

2.

Почему появляется сообщение «Веб-Bluetooth не поддерживается»?

Веб-Bluetooth поддерживается не всеми браузерами/платформами. Обычно настольная версия Chrome/Edge имеет лучшую поддержку; iOS Safari обычно его не поддерживает. Вы можете сменить браузер или переключиться на рабочий стол и протестировать еще раз.

3.

Почему доступ к нему должен быть возможен по протоколу HTTPS?

Веб-Bluetooth — это возможность с высоким уровнем привилегий, и браузеру требуется безопасный контекст (HTTPS). Если он находится в http или небезопасной среде, будет вызвана ошибка SecurityError или он будет напрямую недоступен.

4.

Почему нет ответа при нажатии «Сканировать устройство»/сообщается ли напрямую об ошибке NotAllowedError?

Сканирование должно запускаться жестом пользователя (например, нажатием кнопки), а браузер/система должны разрешить разрешения Bluetooth. Убедитесь, что вы нажимаете кнопку, чтобы активировать его вручную, Bluetooth системы включен и браузер не блокирует всплывающие окна с разрешениями.

5.

Почему я не могу просканировать устройство?

Общие причины включают в себя: устройство невозможно обнаружить/подключить, расстояние слишком велико или заблокировано, слишком строгие условия фильтрации (namePrefix/service) или системный Bluetooth занят другими приложениями. Рекомендуется сначала проверить AcceptAllDevices, подойти к устройству и повторить попытку.

6.

Почему я подключен, но «не могу перечислить услуги/функции»?

Браузеры ограничивают доступ к необъявленным сервисам GATT. Добавьте UUID целевой службы в optionServices (поддерживает такие ключевые слова, как Battery_service, и вы также можете написать полный UUID), затем повторно отсканируйте/подключитесь и выполните перечисление еще раз.

7.

Почему происходят частые отключения (NetworkError/InvalidStateError)?

Распространенными причинами являются расстояние/помехи, низкий заряд батареи или переход устройства в режим энергосбережения, прерывание Bluetooth-соединения другими устройствами или нестабильность системного стека Bluetooth. Рекомендуется подойти ближе к устройству, уменьшить помехи на частоте 2,4 ГГц, перезагрузить Bluetooth/устройство и попытаться сохранить соединение с одним устройством.

8.

После включения «Уведомлений» данных нет. Это нормально?

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

9.

Безопасна ли конфиденциальность? Будут ли загружены мои данные Bluetooth?

Эта страница в основном взаимодействует и анализирует данные в локальном браузере и не будет активно загружать ваши данные Bluetooth. Если вы нажмете «Копировать отчет», содержимое попадет в буфер обмена; вам решать, хотите ли вы этим поделиться.

10.

Какую информацию содержит отчет о репликации?

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