chrome.bluetooth

Beschreibung

Verwenden Sie die chrome.bluetooth API, um eine Verbindung zu einem Bluetooth-Gerät herzustellen. Alle Funktionen melden Fehler über chrome.runtime.lastError.

Verfügbarkeit

Nur ChromeOS

Manifest

Die folgenden Schlüssel müssen im Manifest deklariert werden, um diese API zu verwenden.

"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 sucht.

  • name

    String

    Der menschenlesbare Name des Adapters.

  • powered

    boolean

    Gibt an, ob der Adapter mit Strom versorgt wird.

BluetoothFilter

Chrome 67 oder höher

Attribute

  • filterType

    FilterType optional

    Typ des Filters, der auf die Geräteliste angewendet werden soll. Der Standardwert ist „all“.

  • Limit

    number optional

    Maximale Anzahl der zurückzugebenden Bluetooth-Geräte. Wenn keine Angabe erfolgt, wird standardmäßig „0“ (kein Limit) verwendet.

Device

Attribute

  • Adresse

    String

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

  • batteryPercentage

    number optional

    Chrome 77 oder höher

    Der verbleibende Akkustand des Geräts.

  • verbindbar

    Boolesch optional

    Chrome 48 oder höher

    Gibt an, ob das Gerät verbunden werden kann.

  • verbunden

    Boolesch optional

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

  • verbinden

    Boolesch optional

    Chrome 48 oder höher

    Gibt an, ob das Gerät gerade 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 oder höher

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

  • inquiryTxPower

    number optional

    Chrome 44 oder höher

    Die Sendeleistung. 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 menschenlesbare Name des Geräts.

  • gekoppelt

    Boolesch optional

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

  • productId

    number optional

  • transport

    Transport optional

    Chrome 76 oder höher

    Der Transporttyp des Bluetooth-Geräts.

  • Typ

    DeviceType optional

    Der Typ des Geräts, sofern von Chrome erkannt. Dieser 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 von Protokollen, Profilen und Diensten, 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 AD- und GATT-Primärdiensten abgerufen. Bei Dual-Mode-Geräten kann sie von beiden abgerufen werden.

  • 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 oder höher

Typen zum Filtern von Bluetooth-Geräten.

Enum

"all"

"known"

Transport

Chrome 76 oder höher

Transportart 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,
): Promise<AdapterState>

Informationen zum Bluetooth-Adapter abrufen.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objekt mit den Adapterinformationen.

Ausgabe

  • Promise<AdapterState>

    Chrome 91 oder höher

    Promises 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,
): Promise<Device>

Informationen zu einem dem System bekannten Bluetooth-Gerät abrufen.

Parameter

  • deviceAddress

    String

    Adresse des abzurufenden Geräts.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (deviceInfo: Device) => void

    • deviceInfo

      Gerät

      Objekt mit den Geräteinformationen.

Ausgabe

  • Promise<Device>

    Chrome 91 oder höher

    Promises 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,
): Promise<Device[]>

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

Parameter

  • Filter

    BluetoothFilter optional

    Chrome 67 oder höher

    Einige Kriterien zum Filtern der Liste der zurückgegebenen Bluetooth-Geräte. Wenn der Filter nicht festgelegt oder auf {} gesetzt ist, enthält die zurückgegebene Geräteliste alle Bluetooth-Geräte. Derzeit wird dies nur in ChromeOS unterstützt. Für andere 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.

Ausgabe

  • Promise<Device[]>

    Chrome 91 oder höher

    Promises 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,
): Promise<void>

Erkennung starten. Neu erkannte Geräte werden über das Ereignis „onDeviceAdded“ zurückgegeben. Zuvor erkannte Geräte, die dem Adapter bereits bekannt sind, müssen über „getDevices“ abgerufen werden. Sie werden nur über das Ereignis onDeviceChanged aktualisiert, wenn sich die Informationen zu ihnen ä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

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises 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,
): Promise<void>

Erkennung beenden.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises 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 außerhalb der Reichweite war, dass es wieder als nicht verfügbar gilt, und wenn ein gekoppeltes Gerät entfernt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (device: Device) => void