chroom.bluetooth

Beschrijving

Gebruik de chrome.bluetooth API om verbinding te maken met een Bluetooth-apparaat. Alle functies melden fouten via chrome.runtime.lastError.

Beschikbaarheid

alleen ChromeOS

Manifest

De volgende sleutels moeten in het manifest worden gedeclareerd om deze API te kunnen gebruiken.

"bluetooth"

Soorten

AdapterState

Eigenschappen

  • adres

    snaar

    Het adres van de adapter, in het formaat 'XX:XX:XX:XX:XX:XX'.

  • beschikbaar

    booleaans

    Geeft aan of de adapter beschikbaar (oftewel ingeschakeld) is.

  • ontdekken

    booleaans

    Geeft aan of de adapter momenteel aan het zoeken is.

  • naam

    snaar

    De voor mensen leesbare naam van de adapter.

  • aangedreven

    booleaans

    Geeft aan of de adapter stroom heeft of niet.

BluetoothFilter

Chrome 67+

Eigenschappen

  • filterType

    FilterType optioneel

    Het type filter dat op de apparatenlijst moet worden toegepast. Standaard is 'alles'.

  • beperken

    nummer optioneel

    Maximaal aantal Bluetooth-apparaten dat moet worden geretourneerd. De standaardwaarde is 0 (geen limiet) indien niet gespecificeerd.

Device

Eigenschappen

  • adres

    snaar

    Het adres van het apparaat, in het formaat 'XX:XX:XX:XX:XX:XX'.

  • batterijpercentage

    nummer optioneel

    Chrome 77+

    De resterende batterijduur van het apparaat.

  • koppelbaar

    boolean optioneel

    Chrome 48+

    Geeft aan of het apparaat verbinding kan maken.

  • aangesloten

    boolean optioneel

    Geeft aan of het apparaat momenteel met het systeem is verbonden.

  • verbinding

    boolean optioneel

    Chrome 48+

    Geeft aan of het apparaat momenteel verbinding maakt met het systeem.

  • apparaatklasse

    nummer optioneel

    De klasse van het apparaat, een bitveld gedefinieerd door http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • apparaat-ID

    nummer optioneel

  • aanvraagRssi

    nummer optioneel

    Chrome 44+

    De ontvangen signaalsterkte, in dBm. Dit veld is alleen beschikbaar en geldig tijdens de ontdekkingsfase. Buiten de ontdekkingsfase is de waarde ervan niet gespecificeerd.

  • vraagTxPower

    nummer optioneel

    Chrome 44+

    Het uitgezonden vermogensniveau. Dit veld is alleen beschikbaar voor LE-apparaten die dit veld in AD hebben opgenomen. Het is alleen beschikbaar en geldig tijdens de detectie.

  • naam

    string optioneel

    De voor mensen leesbare naam van het apparaat.

  • gepaard

    boolean optioneel

    Geeft aan of het apparaat al dan niet met het systeem is gekoppeld.

  • productId

    nummer optioneel

  • vervoer

    Vervoer optioneel

    Chrome 76+

    Het transporttype van het Bluetooth-apparaat.

  • type

    Apparaattype optioneel

    Het type apparaat, indien herkend door Chrome. Dit wordt verkregen uit het veld deviceClass en vertegenwoordigt slechts een klein deel van de mogelijke apparaattypen. Bij twijfel kunt u het veld deviceClass direct gebruiken.

  • uuids

    string[] optioneel

    UUID's van protocollen, profielen en services die door het apparaat worden geadverteerd. Voor klassieke Bluetooth-apparaten wordt deze lijst verkregen uit EIR-gegevens en SDP-tabellen. Voor apparaten met laag energieverbruik wordt deze lijst verkregen uit AD- en GATT-primaire services. Voor dual-mode apparaten kan deze lijst uit beide bronnen worden verkregen.

  • leveranciers-ID

    nummer optioneel

  • vendorIdSource

    VendorIdSource optioneel

    Het apparaat-ID-record van het apparaat, indien beschikbaar.

DeviceType

Veelvoorkomende apparaattypen die door Chrome worden herkend.

Enum

"computer"

"telefoon"

"modem"

"audio"

"carAudio"

"video"

"perifeer"

"joystick"

"gamepad"

"toetsenbord"

"muis"

"tablet"

"toetsenbordmuiscombinatie"

FilterType

Chrome 67+

Typen voor het filteren van Bluetooth-apparaten.

Enum

"alle"

"bekend"

Transport

Chrome 76+

Transporttype van het bluetooth-apparaat.

Enum

"ongeldig"

"klassiek"

"le"

"dubbel"

VendorIdSource

Toewijzingsbevoegdheden voor leveranciers-ID's.

Enum

"Bluetooth"

"usb"

Methoden

getAdapterState()

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

Vraag informatie op over de Bluetooth-adapter.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (adapterInfo: AdapterState) => void

Retourneert

  • Promise< AdapterState >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getDevice()

Belofte
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

Informatie opvragen over een Bluetooth-apparaat dat door het systeem wordt herkend.

Parameters

  • apparaatadres

    snaar

    Het adres van het apparaat dat moet worden opgevraagd.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (deviceInfo: Device) => void

    • apparaatinfo

      Apparaat

      Object met de apparaatinformatie.

Retourneert

  • Belofte< Apparaat >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getDevices()

Belofte
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

Krijg een lijst van Bluetooth-apparaten die het systeem kent, inclusief gekoppelde en recent ontdekte apparaten.

Parameters

  • filter

    BluetoothFilter optioneel

    Chrome 67+

    Er zijn criteria om de lijst met geretourneerde Bluetooth-apparaten te filteren. Als het filter niet is ingesteld of is ingesteld op {} , bevat de lijst met geretourneerde apparaten alle Bluetooth-apparaten. Momenteel wordt dit alleen ondersteund in ChromeOS; voor andere platforms wordt een volledige lijst geretourneerd.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (deviceInfos: Device[]) => void

    • apparaatinfo's

      Apparaat []

      Een array van objecten met apparaatinformatie.

Retourneert

  • Promise< Apparaat []>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

startDiscovery()

Belofte
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

Start de detectie. Nieuw ontdekte apparaten worden geretourneerd via de onDeviceAdded-gebeurtenis. Eerder ontdekte apparaten die al bekend zijn bij de adapter, moeten worden opgehaald met getDevices en worden alleen bijgewerkt via de onDeviceChanged -gebeurtenis als de informatie erover verandert.

Het ontdekken van de bron kan niet starten als deze applicatie de functie `startDiscovery` al heeft aangeroepen. Het ontdekken van de bron kan veel systeembronnen verbruiken: `stopDiscovery` moet zo snel mogelijk worden aangeroepen.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

stopDiscovery()

Belofte
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

Stop de ontdekking.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onAdapterStateChanged

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

Wordt geactiveerd wanneer de status van de Bluetooth-adapter verandert.

Parameters

onDeviceAdded

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

Wordt geactiveerd wanneer er informatie beschikbaar is over een nieuw Bluetooth-apparaat.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (device: Device) => void

onDeviceChanged

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

Wordt geactiveerd wanneer informatie over een bekend Bluetooth-apparaat is gewijzigd.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (device: Device) => void

onDeviceRemoved

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

Deze melding wordt geactiveerd wanneer een eerder gedetecteerd Bluetooth-apparaat lang genoeg buiten bereik is geweest om opnieuw als niet beschikbaar te worden beschouwd, en wanneer een gekoppeld apparaat wordt verwijderd.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (device: Device) => void