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, 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

Chrome 67 oder höher

Attribute

  • filterType

    FilterType optional

    Art des Filters, der auf die Geräteliste angewendet werden soll. Die Standardeinstellung ist „Alle“.

  • Limit

    Nummer optional

    Maximale Anzahl der zurückzugebenden Bluetoth-Geräte. 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öher

    Der Akkustand des Geräts.

  • verbunden

    Boolescher Wert optional

    Chrome 48 und höher

    Gibt 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öher

    Gibt 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öher

    Die 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öher

    Der ü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öher

    Der 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 Feld deviceClass 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

Chrome 67 oder höher

Typen zum Filtern von Bluetooth-Geräten

Enum

Transport

Chrome 76 und höher

Transporttyp des Bluetooth-Geräts.

Enum

"le"

VendorIdSource

Zuordnungsstellen für Anbieter-IDs.

Enum

Methoden

getAdapterState()

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

Informationen zum Bluetooth-Adapter abrufen

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

      Objekt mit den Adapterinformationen.

Rückgaben

  • Promise<AdapterState>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getDevice()

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

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

Parameters

  • deviceAddress

    String

    Adresse des abzurufenden Geräts.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (deviceInfo: Device)=>void

    • deviceInfo

      Gerät

      Objekt mit den Geräteinformationen.

Rückgaben

  • Promise<Gerät>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getDevices()

Versprechen 
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.

Parameters

  • Filter

    BluetoothFilter optional

    Chrome 67 oder höher

    Einige 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

Rückgaben

  • Promise<Gerät[]>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

startDiscovery()

Versprechen 
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.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

stopDiscovery()

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

Erkennung beenden.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-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

Parameters

onDeviceAdded

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

Wird ausgelöst, wenn Informationen zu einem neuen Bluetooth-Gerät verfügbar sind

Parameters

  • 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.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (device: Device)=>void

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.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (device: Device)=>void