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

"bluetooth"

Typen

AdapterState

Eigenschappen

  • adres

    snaar

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

  • beschikbaar

    Booleaanse

    Geeft aan of de adapter beschikbaar is (d.w.z. ingeschakeld).

  • ontdekken

    Booleaanse

    Geeft aan of de adapter momenteel aan het ontdekken is.

  • naam

    snaar

    De voor mensen leesbare naam van de adapter.

  • aangedreven

    Booleaanse

    Geeft aan of de adapter stroom heeft.

BluetoothFilter

Chroom 67+

Eigenschappen

  • filterType

    FilterType optioneel

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

  • beperken

    nummer optioneel

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

Device

Eigenschappen

  • adres

    snaar

    Het adres van het apparaat, in de vorm 'XX:XX:XX:XX:XX:XX'.

  • batterijpercentage

    nummer optioneel

    Chroom 77+

    De resterende batterijduur van het apparaat.

  • aansluitbaar

    boolean optioneel

    Chroom 48+

    Geeft aan of het apparaat verbinding kan maken.

  • aangesloten

    boolean optioneel

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

  • verbinden

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

  • apparaat-ID

    nummer optioneel

  • onderzoekRssi

    nummer optioneel

    Chroom 44+

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

  • onderzoekTxPower

    nummer optioneel

    Chroom 44+

    Het verzonden vermogensniveau. Dit veld is alleen beschikbaar voor LE-apparaten die dit veld in AD hebben. 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 wel of niet is gekoppeld aan het systeem.

  • product-ID

    nummer optioneel

  • vervoer

    Transport optioneel

    Chroom 76+

    Het transporttype van het Bluetooth-apparaat.

  • type

    DeviceType 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 beste het veld deviceClass rechtstreeks 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 Low Energy-apparaten wordt deze lijst verkregen uit primaire AD- en GATT-services. Voor dual-mode-apparaten kan deze lijst van beide worden verkregen.

  • leveranciers-ID

    nummer optioneel

  • leveranciers-IDbron

    VendorIdSource optioneel

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

DeviceType

Veelvoorkomende apparaattypen die door Chrome worden herkend.

Enum

"computer"

"telefoon"

"modem"

"audio"

"autoAudio"

"video"

"perifeer"

"joystick"

"gamepad"

"toetsenbord"

"muis"

"tablet"

"toetsenbordmuiscombinatie"

FilterType

Chroom 67+

Typen voor het filteren van Bluetooth-apparaten.

Enum

"alle"

"bekend"

Transport

Chroom 76+

Transporttype van het Bluetooth-apparaat.

Enum

"ongeldig"

"klassiek"

"de"

"dubbel"

VendorIdSource

Toewijzingsbevoegdheden voor leveranciers-ID's.

Enum

"Bluetooth"

"usb"

Methoden

getAdapterState()

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

Informatie over de Bluetooth-adapter.

Parameters

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterStatus

      Object dat de adapterinformatie bevat.

Retourneren

  • Belofte< AdapterState >

    Chroom 91+

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

getDevice()

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

Informatie opvragen over een Bluetooth-apparaat dat bekend is bij het systeem.

Parameters

  • apparaatadres

    snaar

    Adres van het apparaat dat u wilt ophalen.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (deviceInfo: Device) => void

    • apparaatInfo

      Apparaat

      Object dat de apparaatgegevens bevat.

Retourneren

  • Promise< Apparaat >

    Chroom 91+

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

getDevices()

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

Ontvang een lijst met Bluetooth-apparaten die bekend zijn bij het systeem, inclusief gekoppelde en recent 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 apparatenlijst alle Bluetooth-apparaten. Momenteel wordt dit alleen ondersteund in ChromeOS; voor andere platforms wordt een volledige lijst geretourneerd.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (deviceInfos: Device[]) => void

    • apparaatInfos

      Apparaat []

      Een reeks objecten die apparaatinformatie bevatten.

Retourneren

  • Belofte< Apparaat []>

    Chroom 91+

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

startDiscovery()

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

Detectie starten. 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 bijgewerkt met de gebeurtenis onDeviceChanged als de informatie over deze apparaten verandert.

Discovery kan niet worden gestart als deze applicatie startDiscovery al heeft aangeroepen. Discovery kan resource-intensief zijn: stopDiscovery moet zo snel mogelijk worden aangeroepen.

Parameters

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

stopDiscovery()

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

Stop met ontdekken.

Parameters

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 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 wanneer de status van de Bluetooth-adapter verandert.

Parameters

onDeviceAdded

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

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

Parameters

  • terugbellen

    functie

    De callback 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 ziet er als volgt uit: 

    (device: Device) => void

onDeviceRemoved

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

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

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (device: Device) => void