Beschreibung
Verwende die chrome.bluetooth
API, um eine Verbindung zu einem Bluetooth-Gerät herzustellen. Alle Funktionen melden Fehler über „chrome.runtime.lastError“.
Manifest
Die folgenden Schlüssel müssen im Manifest deklariert werden, um diese API verwenden zu können.
"bluetooth"
Typen
AdapterState
Attribute
-
Adresse
String
Die Adresse des Adapters im Format „XX:XX:XX:XX:XX:XX“.
-
verfügbar
boolean
Gibt an, ob der Adapter verfügbar (d.h. aktiviert) ist.
-
Entdecken
boolean
Gibt an, ob der Adapter derzeit eine Erkennung durchführt.
-
name
String
Der visuell lesbare Name des Adapters.
-
mit Strom versorgt
boolean
Gibt an, ob das Netzteil mit Strom versorgt wird.
BluetoothFilter
Attribute
-
filterType
FilterType optional
Art des Filters, der auf die Geräteliste angewendet werden soll. Die Standardeinstellung ist „Alle“.
-
Limit
Nummer optional
Maximale Anzahl an Bluetooth-Geräten, die zurückgegeben werden sollen. Wenn keine Vorgabe erfolgt, ist der Standardwert 0 (kein Limit).
Device
Attribute
-
Adresse
String
Die Adresse des Geräts im Format „XX:XX:XX:XX:XX:XX“.
-
batteryPercentage
Nummer optional
Chrome 77 oder höherDer Akkustand des Geräts.
-
verbunden
Boolescher Wert optional
Chrome 48 und höherGibt an, ob das Gerät eine Verbindung herstellen kann.
-
verbunden
Boolescher Wert optional
Gibt an, ob das Gerät derzeit mit dem System verbunden ist.
-
Multistop-Flug
Boolescher Wert optional
Chrome 48 und höherGibt an, ob das Gerät gerade eine Verbindung zum System herstellt.
-
deviceClass
Nummer optional
Die Klasse des Geräts, ein durch http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband definiertes Bitfeld.
-
deviceId
Nummer optional
-
inquiryRssi
Nummer optional
Chrome 44 und höherDie Stärke des empfangenen Signals in dBm. Dieses Feld ist verfügbar und nur während der Erkennung gültig. Außerhalb der Erkennung ist sein Wert nicht angegeben.
-
inquiryTxPower
Nummer optional
Chrome 44 und höherDer übertragene Energiepegel. Dieses Feld ist nur für LE-Geräte verfügbar, die dieses Feld in AD enthalten. Sie ist nur während der Erkennung verfügbar und gültig.
-
name
String optional
Der visuell lesbare Name des Geräts.
-
gekoppelt
Boolescher Wert optional
Gibt an, ob das Gerät mit dem System gekoppelt ist.
-
productId
Nummer optional
-
transport
Verkehrsmittel optional
Chrome 76 und höherDer Transporttyp des Bluetooth-Geräts.
-
Typ
DeviceType optional
Der Typ des Geräts, sofern es von Chrome erkannt wird. Sie wird aus dem Feld
deviceClass
abgerufen und stellt nur einen kleinen Teil der möglichen Gerätetypen dar. Im Zweifelsfall sollten Sie direkt das FelddeviceClass
verwenden. -
UUIDs
string[] optional
UUIDs der vom Gerät beworbenen Protokolle, Profile und Dienste. Für klassische Bluetooth-Geräte wird diese Liste aus EIR-Daten und SDP-Tabellen abgerufen. Für Low Energy-Geräte stammt diese Liste von den Primärdiensten von AD und GATT. Bei Geräten mit Dual-Modus kann diese von beidem abgerufen werden.
-
vendorId
Nummer optional
-
vendorIdSource
VendorIdSource optional
Geräte-ID-Eintrag des Geräts, falls verfügbar
DeviceType
Häufige Gerätetypen, die von Chrome erkannt werden.
Enum
"carAudio"
"tablet"
FilterType
Typen zum Filtern von Bluetooth-Geräten
Enum
Transport
Transporttyp des Bluetooth-Geräts.
Enum
"le"
VendorIdSource
Zuordnungsstellen für Anbieter-IDs.
Enum
Methoden
getAdapterState()
chrome.bluetooth.getAdapterState(
callback?: function,
)
Informationen zum Bluetooth-Adapter abrufen
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(adapterInfo: AdapterState) => void
-
adapterInfo
Objekt mit den Adapterinformationen.
-
Returns
-
Promise<AdapterState>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getDevice()
chrome.bluetooth.getDevice(
deviceAddress: string,
callback?: function,
)
Informationen zu einem dem System bekannten Bluetooth-Gerät abrufen
Parameter
-
deviceAddress
String
Adresse des abzurufenden Geräts.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(deviceInfo: Device) => void
-
deviceInfo
Objekt mit den Geräteinformationen.
-
Returns
-
Promise<Gerät>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getDevices()
chrome.bluetooth.getDevices(
filter?: BluetoothFilter,
callback?: function,
)
Du kannst eine Liste der dem System bekannten Bluetooth-Geräte abrufen, einschließlich der gekoppelten und kürzlich erkannten Geräte.
Parameter
-
Filter
BluetoothFilter optional
Chrome 67 oder höherEinige Kriterien zum Filtern der Liste der zurückgegebenen Bluetooth-Geräte. Wenn der Filter nicht konfiguriert oder auf
{}
gesetzt ist, enthält die zurückgegebene Geräteliste alle Bluetooth-Geräte. Derzeit wird dies nur in ChromeOS unterstützt. Bei anderen Plattformen wird eine vollständige Liste zurückgegeben. -
callback
Funktion optional
Der Parameter
callback
sieht so aus:(deviceInfos: Device[]) => void
-
deviceInfos
Gerät[]
Array des Objekts, das Geräteinformationen enthält
-
Returns
-
Promise<Gerät[]>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
startDiscovery()
chrome.bluetooth.startDiscovery(
callback?: function,
)
Erkennung starten. Neu erkannte Geräte werden über das Ereignis „onDeviceHinzugefügt“ zurückgegeben. Zuvor erkannte Geräte, die bereits mit dem Adapter vertraut sind, müssen mit getdevices bezogen werden und werden nur dann mit dem onDeviceChanged
-Ereignis aktualisiert, wenn sich entsprechende Informationen ändern.
Die Erkennung kann nicht gestartet werden, wenn diese Anwendung bereits startDiscovery aufgerufen hat. Die Erkennung kann ressourcenintensiv sein: stopDiscovery sollte so schnell wie möglich aufgerufen werden.
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Promise<void>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
stopDiscovery()
chrome.bluetooth.stopDiscovery(
callback?: function,
)
Erkennung beenden.
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Promise<void>
Chrome 91 und höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
Veranstaltungen
onAdapterStateChanged
chrome.bluetooth.onAdapterStateChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich der Status des Bluetooth-Adapters ändert
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(state: AdapterState) => void
-
state
-
onDeviceAdded
chrome.bluetooth.onDeviceAdded.addListener(
callback: function,
)
Wird ausgelöst, wenn Informationen zu einem neuen Bluetooth-Gerät verfügbar sind
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(device: Device) => void
-
Gerät
-
onDeviceChanged
chrome.bluetooth.onDeviceChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich Informationen zu einem bekannten Bluetooth-Gerät geändert haben.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(device: Device) => void
-
Gerät
-
onDeviceRemoved
chrome.bluetooth.onDeviceRemoved.addListener(
callback: function,
)
Wird ausgelöst, wenn ein zuvor gefundenes Bluetooth-Gerät lange genug außerhalb der Reichweite war, um wieder als nicht verfügbar zu gelten, und wenn ein gekoppeltes Gerät entfernt wird.