chroom.bluetooth

Beschrijving

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

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 is (dwz ingeschakeld).

  • ontdekken

    Booleaans

    Geeft aan of de adapter momenteel aan het ontdekken is.

  • naam

    snaar

    De voor mensen leesbare naam van de adapter.

  • aangedreven

    Booleaans

    Geeft aan of de adapter stroom krijgt of niet.

BluetoothFilter

Chroom 67+

Eigenschappen

  • filterType

    FilterType optioneel

    Type filter dat op de apparaatlijst 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

    Chroom 77+

    De resterende batterij van het apparaat.

  • koppelbaar

    Booleaans optioneel

    Chroom 48+

    Geeft aan of het apparaat aansluitbaar is.

  • aangesloten

    Booleaans optioneel

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

  • verbinden

    Booleaans optioneel

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

  • apparaatID

    nummer optioneel

  • aanvraagRssi

    nummer optioneel

    Chroom 44+

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

  • aanvraagTxPower

    nummer optioneel

    Chroom 44+

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

  • naam

    tekenreeks optioneel

    De voor mensen leesbare naam van het apparaat.

  • gepaard

    Booleaans optioneel

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

  • productId

    nummer optioneel

  • vervoer

    Transport optioneel

    Chroom 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 moet u rechtstreeks het veld deviceClass gebruiken.

  • uids

    tekenreeks[] optioneel

    UUID's van protocollen, profielen en diensten die door het apparaat worden geadverteerd. Voor klassieke Bluetooth-apparaten wordt deze lijst verkregen uit EIR-gegevens en SDP-tabellen. Voor Low Energy-apparaten wordt deze lijst verkregen van de primaire diensten AD en GATT. Voor dual-mode-apparaten kan dit bij beide worden verkregen.

  • leverancierId

    nummer optioneel

  • leverancierIdSource

    VendorIdSource optioneel

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

DeviceType

Veelvoorkomende apparaattypen herkend door Chrome.

Enum

"computer"

"telefoon"

"modem"

"audio"

"autoAudio"

"video"

"perifeer"

"joystick"

"gamepad"

"toetsenbord"

"muis"

"tablet"

"toetsenbordmuiscombo"

FilterType

Chroom 67+

Typen voor het filteren van Bluetooth-apparaten.

Enum

"alle"

"bekend"

Transport

Chroom 76+

Transporttype van het Bluetooth-apparaat.

Enum

"ongeldig"

"klassiek"

"le"

"dubbel"

VendorIdSource

Toewijzingsautoriteiten voor leveranciers-ID's.

Enum

"Bluetooth"

"usb"

Methoden

getAdapterState()

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

Krijg informatie over de Bluetooth-adapter.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      Adapterstatus

      Object dat de adapterinformatie bevat.

Retouren

  • Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getDevice()

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

Krijg informatie over een Bluetooth-apparaat dat bekend is bij het systeem.

Parameters

  • apparaatAdres

    snaar

    Adres van het te verkrijgen apparaat.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (deviceInfo: Device) => void

    • apparaatinfo

      Apparaat

      Object dat de apparaatinformatie bevat.

Retouren

  • Beloof < Apparaat >

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getDevices()

Belofte
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Ontvang een lijst met Bluetooth-apparaten die bij het systeem bekend zijn, inclusief gekoppelde en onlangs ontdekte apparaten.

Parameters

  • filter

    BluetoothFilter optioneel

    Chroom 67+

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

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (deviceInfos: Device[]) => void

    • apparaatinfo

      Apparaat []

      Array van objecten met apparaatinformatie.

Retouren

  • Beloof < Apparaat []>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

startDiscovery()

Belofte
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Ontdekking starten. Nieuw ontdekte apparaten worden geretourneerd via de onDeviceAdded-gebeurtenis. Eerder ontdekte apparaten die al bekend zijn bij de adapter moeten worden verkregen met behulp van getDevices en zullen alleen worden bijgewerkt met behulp van de onDeviceChanged gebeurtenis als de informatie erover verandert.

Discovery start niet als deze toepassing startDiscovery al heeft aangeroepen. Discovery kan veel resources vergen: stopDiscovery moet zo snel mogelijk worden aangeroepen.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

stopDiscovery()

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

Stop met ontdekken.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

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 informatie over een nieuw Bluetooth-apparaat beschikbaar is.

Parameters

  • terugbellen

    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

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (device: Device) => void

onDeviceRemoved

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

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

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (device: Device) => void