chrome.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 gedefinieerd om deze API te gebruiken.

"bluetooth"

Typen

AdapterState

Eigenschappen

  • adres

    tekenreeks

    Het adres van de adapter, in de indeling 'XX:XX:XX:XX:XX:XX'.

  • beschikbaar

    booleaans

    Geeft aan of de adapter beschikbaar is (dat wil zeggen aangezet).

  • ontdekken

    booleaans

    Geeft aan of de adapter op dit moment aan het ontdekken is.

  • name

    tekenreeks

    De door mensen leesbare naam van de adapter.

  • met stroom

    booleaans

    Geeft aan of de adapter stroom krijgt.

BluetoothFilter

Chrome 67+

Eigenschappen

  • filterType

    FilterType optioneel

    Het type filter dat je wilt toepassen op de apparaatlijst. De standaard is Alle.

  • limiet

    number optioneel

    Maximum aantal bluetooth-apparaten dat wordt geretourneerd. De standaardwaarde is 0 (geen limiet) als deze niet is opgegeven.

Device

Eigenschappen

  • adres

    tekenreeks

    Het adres van het apparaat, in de indeling XX:XX:XX:XX:XX:XX.

  • batteryPercentage

    number optioneel

    Chrome 77+

    De resterende batterijlading van het apparaat.

  • koppelbaar

    booleaans optioneel

    Chrome 48+

    Geeft aan of het apparaat kan worden verbonden.

  • verbonden

    booleaans optioneel

    Geeft aan of het apparaat op dit moment is verbonden met het systeem.

  • verbinding maken

    booleaans optioneel

    Chrome 48+

    Geeft aan of het apparaat op dit moment verbinding maakt met het systeem.

  • deviceClass

    number optioneel

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

  • deviceId

    number optioneel

  • inquiryRssi

    number optioneel

    Chrome 44+

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

  • inquiryTxPower

    number optioneel

    Chrome 44+

    Het uitgezonden vermogensniveau. Dit veld is alleen beschikbaar voor LE-apparaten die dit veld in AD bevatten. Deze is alleen beschikbaar en geldig tijdens de ontdekking.

  • name

    tekenreeks optioneel

    De door mensen leesbare naam van het apparaat.

  • gekoppeld

    booleaans optioneel

    Geeft aan of het apparaat is gekoppeld aan het systeem.

  • productId

    number optioneel

  • transport

    Transport optioneel

    Chrome 76+

    Het transporttype van het bluetooth-apparaat.

  • type

    DeviceType optioneel

    Het type apparaat, als dit wordt herkend door Chrome. Deze wordt verkregen uit het veld deviceClass en vertegenwoordigt maar een kleine fractie van de mogelijke apparaattypen. Als je twijfelt, gebruik je het veld deviceClass rechtstreeks.

  • uuids

    string[] optioneel

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

  • vendorId

    number optioneel

  • vendorIdSource

    VendorIdSource optioneel

    De apparaat-ID van het apparaat, indien beschikbaar.

DeviceType

Veelvoorkomende apparaattypen die door Chrome worden herkend.

Enum

"computer"

"phone"

modem

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

gamepad

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67+

Typen om bluetooth-apparaten te filteren.

Enum

"all"

"known"

Transport

Chrome 76+

Transporttype van het bluetooth-apparaat.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Toewijzingsinstanties voor leverancier-ID's.

Enum

"bluetooth"

"usb"

Methoden

getAdapterState()

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

Informatie over de bluetooth-adapter krijgen.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (adapterInfo: AdapterState) => void

Retourzendingen

  • Promise<AdapterState>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getDevice()

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

Informatie krijgen over een bluetooth-apparaat dat bekend is bij het systeem.

Parameters

  • deviceAddress

    tekenreeks

    Adres van het apparaat dat je wilt ophalen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (deviceInfo: Device) => void

    • deviceInfo

      Apparaat

      Object met de apparaatgegevens.

Retourzendingen

  • Promise<Device>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getDevices()

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

Een lijst met bluetooth-apparaten ophalen die bekend zijn bij het systeem, waaronder gekoppelde en onlangs gevonden apparaten.

Parameters

  • filter

    BluetoothFilter optioneel

    Chrome 67+

    Enkele 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. Op dit moment wordt dit alleen ondersteund in ChromeOS. Voor andere platforms wordt een volledige lijst geretourneerd.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Apparaat[]

      Matrix van object met apparaatgegevens.

Retourzendingen

  • Promise<Device[]>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

startDiscovery()

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

Start de ontdekking. Nieuw ontdekte apparaten worden geretourneerd via de gebeurtenis onDeviceAdded. Eerder ontdekte apparaten die al bekend zijn bij de adapter, moeten worden opgehaald met getDevices en worden alleen geüpdatet met de gebeurtenis onDeviceChanged als de informatie over de apparaten verandert.

De detectie kan niet worden gestart als deze app startDiscovery al heeft aangeroepen. Ontdekken kan veel resources vereisen: stopDiscovery moet zo snel mogelijk worden aangeroepen.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

stopDiscovery()

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

Stop de detectie.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onAdapterStateChanged

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

Wordt geactiveerd als de status van de bluetooth-adapter verandert.

Parameters

onDeviceAdded

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

Wordt geactiveerd als er informatie over een nieuw bluetooth-apparaat beschikbaar is.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (device: Device) => void

onDeviceChanged

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

Wordt geactiveerd als de informatie over een bekend bluetooth-apparaat is gewijzigd.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (device: Device) => void

onDeviceRemoved

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

Wordt geactiveerd als een bluetooth-apparaat dat eerder is gevonden, zo lang buiten bereik is geweest dat het weer als niet beschikbaar wordt beschouwd en als een gekoppeld apparaat wordt verwijderd.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (device: Device) => void