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.

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.

  • bereitgestellt

    boolean

    Gibt an, ob der Adapter mit Strom versorgt wird.

BluetoothFilter

Chrome 67 und höher

Attribute

  • filterType

    FilterType optional

    Gibt den Filtertyp an, der auf die Geräteliste angewendet werden soll. Die Standardeinstellung ist „Alle“.

  • 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

    Der verbleibende Akkustand des Geräts.

  • verbindungsfähig

    boolean optional

    Chrome 48 und höher

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

  • verbunden

    boolean optional

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

  • Multistop-Flug

    boolean optional

    Chrome 48 und höher

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

  • deviceClass

    number optional

    Die Geräteklasse, 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 Ermittlung verfügbar und gültig. Außerhalb der Ermittlung wird der Wert nicht angegeben.

  • inquiryTxPower

    number optional

    Chrome 44 und höher

    Die übertragene Leistung. Dieses Feld ist nur für LE-Geräte verfügbar, die dieses Feld in AD enthalten. Sie ist nur während der Ermittlung verfügbar und gültig.

  • name

    String optional

    Der für Menschen lesbare Name des Geräts.

  • gekoppelt

    boolean 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 er von Chrome erkannt wird. Diese 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 vom Gerät beworbenen Protokolle, Profile und Dienste. Bei Geräten mit klassischem Bluetooth 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 Geräten mit dualem Modus können die Informationen von beiden Quellen 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 und höher

Typen zum Filtern von Bluetooth-Geräten.

Enum

"all"

„known“

Transport

Chrome 76 und höher

Transportart des Bluetooth-Geräts.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Zuweisungsbehörden für Anbieter-IDs.

Enum

"bluetooth"

"usb"

Methoden

getAdapterState()

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

Informationen zum Bluetooth-Adapter abrufen

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objekt mit den Adapterinformationen.

Ausgabe

  • Promise<AdapterState>

    Chrome 91 und 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 Bluetooth-Gerät abrufen, das dem System bekannt ist.

Parameter

  • deviceAddress

    String

    Adresse des Geräts, das abgerufen werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (deviceInfo: Device) => void

    • deviceInfo

      Gerät

      Objekt mit den Geräteinformationen.

Ausgabe

  • Promise<Device>

    Chrome 91 und 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 Bluetooth-Geräte abrufen, die dem System bekannt sind, einschließlich gekoppelter und kürzlich erkannter Geräte.

Parameter

  • filtern

    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 {} 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

    Funktion optional

    Der Parameter callback sieht so aus: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Gerät[]

      Array mit Objekten, die Geräteinformationen enthalten.

Ausgabe

  • Promise<Device[]>

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

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

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 und 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

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 und 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 lange genug außerhalb der Reichweite war, um wieder als nicht verfügbar zu gelten, und wenn ein gekoppeltes Gerät entfernt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (device: Device) => void