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) verfügbar ist.

  • Entdecken

    boolean

    Gibt an, ob der Adapter derzeit eine Erkennung durchführt.

  • Name

    String

    Der visuell lesbare Name des Adapters.

  • Powered by

    boolean

    Gibt an, ob das Netzteil mit Strom versorgt wird.

BluetoothFilter

Chrome 67 und höher

Attribute

  • filterType

    FilterType optional

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

  • Limit

    Zahl optional

    Maximale Anzahl der zurückzugebenden Bluetooth-Geräte. Wenn kein Wert angegeben wird, ist der Standardwert 0 (unbegrenzt).

Device

Attribute

  • Adresse

    String

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

  • batteryPercentage

    Zahl optional

    Chrome 77 oder höher

    Der verbleibende Akku des Geräts.

  • anschließbar

    Boolescher Wert optional

    Chrome (ab Version 48)

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

  • verbunden

    Boolescher Wert optional

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

  • Multistop-Flug

    Boolescher Wert optional

    Chrome (ab Version 48)

    Gibt an, ob sich das Gerät gerade mit dem System verbindet.

  • deviceClass

    Zahl optional

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

  • deviceId

    Zahl optional

  • inquiryRssi

    Zahl optional

    Chrome (ab Version 44)

    Die Stärke des empfangenen Signals 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

    Zahl optional

    Chrome (ab Version 44)

    Der Pegel der übertragenen Leistung. 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

    Zahl optional

  • transport

    Transport optional

    Chrome 76 und höher

    Der Transporttyp des Bluetooth-Geräts.

  • Typ

    DeviceType optional

    Der Typ des Geräts, das von Chrome erkannt wird. Diese wird aus dem Feld deviceClass abgerufen und repräsentiert nur einen kleinen Bruchteil der möglichen Gerätetypen. 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 entnommen. Diese Liste für Low-Energy-Geräte wird von den AD- und GATT-Primärdiensten bezogen. Bei Dual-Modus-Geräten kann dieser Schritt von beiden verwendet werden.

  • vendorId

    Zahl optional

  • vendorIdSource

    VendorIdSource optional

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

DeviceType

Häufig von Chrome erkannte Gerätetypen.

Enum

"Computer"

"Telefon"

"modem"

"Audio"

"carAudio"

"Video"

"Peripheriegerät"

"Joystick"

"Gamepad"

"Tastatur"

"Maus"

"Tablet"

"KeyboardMouseCombo"

FilterType

Chrome 67 und höher

Typen zum Filtern von Bluetooth-Geräten.

Enum

"alle"

"bekannt"

Transport

Chrome 76 und höher

Transporttyp des Bluetooth-Geräts.

Enum

"ungültig"

"Klassisch"

"le"

"Dual"

VendorIdSource

Zuweisungsstellen für Anbieter-IDs.

Enum

"Bluetooth"

„usb“

Methoden

getAdapterState()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Hier finden Sie Informationen zum Bluetooth-Adapter.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objekt, das die Adapterinformationen enthält.

Gibt Folgendes zurück:

  • Promise&lt;AdapterState&gt;

    Chrome 91 und höher

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

getDevice()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Rufen Sie Informationen zu einem Bluetooth-Gerät ab, das dem System bekannt ist.

Parameter

  • deviceAddress

    String

    Adresse des abzurufenden Geräts.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (deviceInfo: Device) => void

    • deviceInfo

      Gerät

      Objekt mit den Geräteinformationen.

Gibt Folgendes zurück:

  • Promise&lt;Device&gt;

    Chrome 91 und höher

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

getDevices()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Rufen Sie eine Liste der dem System bekannten Bluetooth-Geräte ab, einschließlich gekoppelter und kürzlich gefundener Geräte.

Parameter

  • Filter

    BluetoothFilter optional

    Chrome 67 und höher

    Kriterien zum Filtern der Liste zurückgegebener 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: <ph type="x-smartling-placeholder"></ph>

    (deviceInfos: Device[]) => void

    • deviceInfos

      Gerät[]

      Array von Objekten, die Geräteinformationen enthalten.

Gibt Folgendes zurück:

  • Promise<Gerät[]>

    Chrome 91 und höher

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

startDiscovery()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Inhalte entdecken Neu erkannte Geräte werden über das Ereignis „onDeviceAdded“ zurückgegeben. Zuvor erkannte Geräte, die dem Adapter bereits bekannt sind, müssen mit getDevices abgerufen werden und werden nur mit dem onDeviceChanged-Ereignis aktualisiert, wenn sich die Informationen über sie ä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: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 91 und höher

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

stopDiscovery()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Erkennung beenden.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 91 und höher

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

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (state: AdapterState) => void

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: <ph type="x-smartling-placeholder"></ph>

    (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: <ph type="x-smartling-placeholder"></ph>

    (device: Device) => void

onDeviceRemoved

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

Wird ausgelöst, wenn ein zuvor erkanntes Bluetooth-Gerät sich lange genug außerhalb der Reichweite befindet, um wieder als nicht verfügbar angesehen zu werden, und wenn ein gekoppeltes Gerät entfernt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (device: Device) => void