Веб-API Bluetooth

Веб-API Bluetooth предоставляет возможность подключения и взаимодействия с периферийными устройствами Bluetooth Low Energy.

Bluetooth

Предоставляет методы для проверки доступности Bluetooth и запроса доступа к устройствам.

BluetoothCharacteristicProperties

Предоставляет свойства определённого BluetoothRemoteGATTCharacteristic.

BluetoothDevice

Представляет устройство Bluetooth внутри конкретной среды выполнения сценария.

BluetoothRemoteGATTCharacteristic

Представляет характеристику GATT, которая является базовым элементом данных, предоставляющим дополнительную информацию о сервисе периферийного устройства.

BluetoothRemoteGATTDescriptor

Представляет дескриптор GATT, предоставляющий дополнительную информацию о значении характеристики.

BluetoothRemoteGATTServer

Представляет сервер GATT на удалённом устройстве.

BluetoothRemoteGATTService

Представляет сервис, предоставляемый сервером GATT, включая устройство, список ссылочных сервисов и список характеристик этого сервиса.

API Bluetooth расширяет следующие API, добавляя перечисленные функции.

Navigator.bluetooth

Возвращает объект Bluetooth для текущего документа, предоставляя доступ к функциональности API Web Bluetooth.

API Web Bluetooth может использоваться только в защищённом контексте.

Доступ к API контролируется директивой Политики разрешений bluetooth. Значение по умолчанию для политики bluetooth составляет self, что разрешает использование Bluetooth в вложенных фреймах с тем же происхождением, но по умолчанию запрещает доступ стороннему контенту. Доступ к данным из другого источника разрешается указанием разрешенных источников как в HTTP-заголовке Permissions-Policy: bluetooth, так и в желаемой <iframe>.

Для использования этой функции пользователь должен сначала предоставить явное разрешение (запрос на разрешение не будет отображаться, если доступ запрещён по другим причинам, например, если он заблокирован политикой разрешений). Запрос разрешения отображается при вызове Bluetooth.requestDevice() для запроса доступа к новому устройству Bluetooth, для которого разрешение не предоставлено (управляющий глобальный объект также должен иметь временную активацию). Можно использовать Bluetooth.getDevices() для получения устройств, для которых ранее было предоставлено разрешение для сайта.

Метод API разрешений navigator.permissions.query() может быть использован с разрешением bluetooth для проверки наличия у сайта разрешения на использование устройств Bluetooth. Состояние разрешения будет granted, denied или prompt (требуется подтверждение пользователя после запроса):

const btPermission = await navigator.permissions.query({ name: "bluetooth" });
if (btPermission.state !== "denied") {
  // Do something
}