chrome.bluetooth

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, damit diese API verwendet werden kann.

"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 Geräte sucht.

  • name

    String

    Der für Menschen lesbare Name des Adapters.

  • powered

    boolean

    Gibt an, ob der Adapter mit Strom versorgt wird.

BluetoothFilter

Chrome 67 und höher

Attribute

  • filterType

    FilterType optional

    Der Filtertyp, der auf die Geräteliste angewendet werden soll. Standardmäßig ist „Alle“ ausgewählt.

  • Limit

    number optional

    Maximale Anzahl der zurückzugebenden Bluetooth-Geräte. Ist keine Angabe vorhanden, ist der Standardwert „0“ (kein Limit).

Device

Attribute

  • Adresse

    String

    Die Adresse des Geräts im Format „XX:XX:XX:XX:XX:XX“.

  • batteryPercentage

    number optional

    Chrome 77 und höher

    Die verbleibende Akkulaufzeit des Geräts.

  • connectable

    boolescher Wert optional

    Chrome 48 und höher

    Gibt an, ob eine Verbindung zum Gerät hergestellt werden 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öher

    Gibt an, ob das Gerät derzeit eine Verbindung zum System herstellt.

  • deviceClass

    number optional

    Die Klasse des Geräts, ein Bitfeld, das unter http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband definiert ist.

  • deviceId

    number optional

  • inquiryRssi

    number optional

    Chrome 44 und höher

    Die empfangene Signalstärke in dBm. Dieses Feld ist nur während der Erkennung verfügbar und gültig. Außerhalb der Discovery-Phase ist der Wert nicht angegeben.

  • inquiryTxPower

    number optional

    Chrome 44 und höher

    Die übertragene Leistungsstufe. 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 für Menschen lesbare Name des Geräts.

  • gekoppelt

    boolescher Wert optional

    Gibt an, ob das Gerät mit dem System gekoppelt ist.

  • productId

    number optional

  • transport

    Transport optional

    Chrome 76 und höher

    Der Transporttyp des Bluetooth-Geräts.

  • Typ

    DeviceType optional

    Der Typ des Geräts, sofern von Chrome erkannt. Dieser Wert wird aus dem Feld deviceClass abgerufen und stellt nur einen kleinen Teil der möglichen Gerätetypen dar. Im Zweifelsfall sollten Sie das Feld deviceClass direkt verwenden.

  • uuids

    string[] optional

    UUIDs der Protokolle, Profile und Dienste, die vom Gerät beworben werden. Bei klassischen Bluetooth-Geräten wird diese Liste aus EIR-Daten und SDP-Tabellen abgerufen. Bei Low-Energy-Geräten wird diese Liste aus den primären AD- und GATT-Diensten abgerufen. Bei Dual-Mode-Geräten kann dies über beide erfolgen.

  • vendorId

    number optional

  • vendorIdSource

    VendorIdSource optional

    Der Geräte-ID-Eintrag des Geräts, sofern verfügbar.

DeviceType

Gängige Gerätetypen, die von Chrome erkannt werden

Enum

"computer"

"phone"

"modem"

„audio“

"carAudio"

"video"

„peripheral“

„joystick“

„gamepad“

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 und höher

Typen zum Filtern von Bluetooth-Geräten.

Enum

"alle"

„known“

Transport

Chrome 76 und höher

Transporttyp des Bluetooth-Geräts.

Enum

"invalid"

„classic“

"le"

"dual"

VendorIdSource

Zuweisungsstellen für Anbieter-IDs.

Enum

„bluetooth“

"usb"

Methoden

getAdapterState()

Promise 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Informationen zum Bluetooth-Adapter abrufen

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objekt mit den Adapterinformationen.

Gibt Folgendes zurück:

  • Promise<AdapterState>

    Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDevice()

Promise 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Informationen zu einem Bluetooth-Gerät abrufen, das dem System bekannt ist.

Parameter

  • deviceAddress

    String

    Adresse des Geräts, dessen Daten abgerufen werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (deviceInfo: Device) => void

    • deviceInfo

      Gerät

      Objekt mit den Geräteinformationen.

Gibt Folgendes zurück:

  • Promise<Device>

    Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDevices()

Promise 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Liste der dem System bekannten Bluetooth-Geräte abrufen, einschließlich gekoppelter und kürzlich erkannter Geräte

Parameter

  • Filter

    BluetoothFilter optional

    Chrome 67 und höher

    Einige Kriterien zum Filtern der Liste der zurückgegebenen Bluetooth-Geräte. Wenn der Filter nicht festgelegt oder auf {} festgelegt ist, enthält die zurückgegebene Geräteliste alle Bluetooth-Geräte. Derzeit wird diese Funktion nur in ChromeOS unterstützt. Auf anderen Plattformen wird eine vollständige Liste zurückgegeben.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Gerät[]

      Array von Objekten mit Geräteinformationen.

Gibt Folgendes zurück:

  • Promise<Device[]>

    Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

startDiscovery()

Promise 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Starten Sie die Erkennung. Neu erkannte Geräte werden über das Ereignis „onDeviceAdded“ zurückgegeben. Geräte, die bereits zuvor gefunden wurden und dem Adapter bekannt sind, müssen mit „getDevices“ abgerufen werden. Sie werden nur über das Ereignis onDeviceChanged aktualisiert, wenn sich Informationen zu ihnen ändern.

Die Erkennung wird nicht gestartet, wenn diese Anwendung bereits startDiscovery aufgerufen hat. Die Erkennung kann ressourcenintensiv sein: „stopDiscovery“ sollte so bald wie möglich aufgerufen werden.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

stopDiscovery()

Promise 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Erkennung beenden

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich der Status des Bluetooth-Adapters ändert.

Parameter

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

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

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein zuvor erkanntes Bluetooth-Gerät so lange nicht in Reichweite war, dass es als nicht verfügbar betrachtet wird, und wenn ein gekoppeltes Gerät entfernt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (device: Device) => void