Die Web Bluetooth API ermöglicht die Verbindung und Interaktion mit Bluetooth Low Energy-Peripheriegeräten.

Schnittstellen

Bluetooth

Bietet Methoden zum Abfragen der Bluetooth-Verfügbarkeit und zum Anfordern des Zugriffs auf Geräte.

BluetoothCharacteristicProperties

Stellt Eigenschaften einer bestimmtenBluetoothRemoteGATTCharacteristic bereit.

BluetoothDevice

Repräsentiert ein Bluetooth-Gerät innerhalb einer bestimmten Skript-Ausführungsumgebung.

BluetoothRemoteGATTCharacteristic

Repräsentiert eine GATT-Charakteristik, ein grundlegendes Datenelement, das weitere Informationen über einen Dienst eines Peripheriegeräts liefert.

BluetoothRemoteGATTDescriptor

Repräsentiert einen GATT-Deskriptor, der weitere Informationen über den Wert einer Charakteristik liefert.

BluetoothRemoteGATTServer

Repräsentiert einen GATT-Server auf einem entfernten Gerät.

BluetoothRemoteGATTService

Repräsentiert einen Dienst, der von einem GATT-Server bereitgestellt wird, einschließlich eines Geräts, einer Liste referenzierter Dienste und einer Liste der Charakteristika dieses Dienstes.

Erweiterungen zu anderen Schnittstellen

Die Bluetooth API erweitert die folgenden APIs und fügt die aufgeführten Funktionen hinzu.

Navigator

Navigator.bluetooth

Gibt einBluetooth-Objekt für das aktuelle Dokument zurück und bietet Zugriff auf die Funktionalität der Web Bluetooth API.

Sicherheitsüberlegungen

Die Web Bluetooth API kann nur in einem sicheren Kontext verwendet werden.

Der Zugriff auf die API wird durch diePermissions Policy-Direktivebluetooth kontrolliert.Die Standard-Zugriffsliste für diebluetooth-Richtlinie istself, was die Bluetooth-Nutzung in gleichherkunftsverschachtelten Frames ermöglicht, jedoch standardmäßig den Zugriff von Drittinhalten verhindert.Der ursprungsübergreifende Zugriff wird durch die Angabe der erlaubten Ursprünge sowohl imPermissions-Policy: bluetooth-HTTP-Header als auch im gewünschten<iframe> ermöglicht.

Um die Funktion nutzen zu können, muss der Benutzer zuerst ausdrücklich die Erlaubnis erteilen (er wird nicht um Zugriff gebeten, wenn dies aus anderen Gründen nicht erlaubt ist, z.B. wenn es durch eine Permissions Policy blockiert wird).Die Berechtigungsaufforderung wird angezeigt, wennBluetooth.requestDevice() aufgerufen wird, um den Zugriff auf ein neues Bluetooth-Gerät zu beantragen, für das keine Berechtigung erteilt wurde (das besitzende globale Objekt muss ebenfalls einetransiente Aktivierung haben).Sie könnenBluetooth.getDevices() verwenden, um alle Geräte abzurufen, für die der Website zuvor die Berechtigung erteilt wurde.

Die Methodenavigator.permissions.query() derPermissions API kann mit derbluetooth-Berechtigung verwendet werden, um zu testen, ob eine Website Berechtigung hat, Bluetooth-Geräte zu verwenden.Der Berechtigungsstatus istgranted,denied oderprompt (erfordert die Bestätigung einer Aufforderung durch den Benutzer):

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

Spezifikationen

Browser-Kompatibilität