chrome.bluetooth

Description

Utilisez l'API chrome.bluetooth pour vous connecter à un appareil Bluetooth. Toutes les fonctions signalent les échecs via chrome.runtime.lastError.

Fichier manifeste

Pour utiliser cette API, vous devez déclarer les clés suivantes dans le fichier manifeste.

"bluetooth"

Types

AdapterState

Propriétés

  • adresse

    chaîne

    Adresse de l'adaptateur, au format "XX:XX:XX:XX:XX:XX".

  • disponible

    booléen

    Indique si l'adaptateur est disponible (c'est-à-dire activé) ou non.

  • découvrir

    booléen

    Indique si l'adaptateur est actuellement en cours de découverte.

  • nom

    chaîne

    Nom lisible de l'adaptateur.

  • alimenté

    booléen

    Indique si l'adaptateur est alimenté ou non.

BluetoothFilter

Chrome 67 ou version ultérieure

Propriétés

  • filterType

    FilterType facultatif

    Type de filtre à appliquer à la liste des appareils. La valeur par défaut est "Tout".

  • limite

    number facultatif

    Nombre maximal d'appareils Bluetooth à renvoyer. La valeur par défaut est 0 (pas de limite) si elle n'est pas spécifiée.

Device

Propriétés

  • adresse

    chaîne

    Adresse de l'appareil, au format "XX:XX:XX:XX:XX:XX".

  • batteryPercentage

    number facultatif

    Chrome 77 et versions ultérieures

    Autonomie restante de la batterie de l'appareil.

  • connectable

    booléen facultatif

    Chrome 48 et versions ultérieures

    Indique si l'appareil peut être connecté.

  • connecté

    booléen facultatif

    Indique si l'appareil est actuellement connecté au système.

  • correspondance

    booléen facultatif

    Chrome 48 et versions ultérieures

    Indique si l'appareil se connecte actuellement au système.

  • deviceClass

    number facultatif

    Classe de l'appareil, champ de bits défini par http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • deviceId

    number facultatif

  • inquiryRssi

    number facultatif

    Chrome 44 ou version ultérieure

    Intensité du signal reçu, en dBm. Ce champ n'est disponible et valide que pendant la découverte. En dehors de la découverte, sa valeur n'est pas spécifiée.

  • inquiryTxPower

    number facultatif

    Chrome 44 ou version ultérieure

    Niveau de puissance transmis. Ce champ n'est disponible que pour les appareils LE qui l'incluent dans AD. Il n'est disponible et valide que pendant la découverte.

  • nom

    chaîne facultatif

    Nom lisible de l'appareil.

  • associé

    booléen facultatif

    Indique si l'appareil est associé ou non au système.

  • productId

    number facultatif

  • transport

    Transport facultatif

    Chrome 76 ou version ultérieure

    Type de transport de l'appareil Bluetooth.

  • type

    DeviceType facultatif

    Type de l'appareil, s'il est reconnu par Chrome. Il est obtenu à partir du champ deviceClass et ne représente qu'une petite partie des types d'appareils possibles. En cas de doute, utilisez directement le champ deviceClass.

  • uuids

    string[] facultatif

    UUID des protocoles, profils et services annoncés par l'appareil. Pour les appareils Bluetooth classiques, cette liste est obtenue à partir des données EIR et des tables SDP. Pour les appareils à faible consommation d'énergie, cette liste est obtenue à partir des services principaux AD et GATT. Pour les appareils à double mode, cette information peut être obtenue à partir des deux.

  • vendorId

    number facultatif

  • vendorIdSource

    VendorIdSource facultatif

    Enregistrement de l'ID de l'appareil, le cas échéant.

DeviceType

Types d'appareils courants reconnus par Chrome.

Énumération

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"souris"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 ou version ultérieure

Types de filtrage des appareils Bluetooth.

Énumération

"all"

"known"

Transport

Chrome 76 ou version ultérieure

Type de transport de l'appareil Bluetooth.

Énumération

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Autorités d'allocation des ID de fournisseur.

Énumération

"bluetooth"

"usb"

Méthodes

getAdapterState()

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

Obtenez des informations sur l'adaptateur Bluetooth.

Paramètres

  • rappel

    fonction facultatif

    Le paramètre callback se présente comme suit : 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objet contenant les informations sur l'adaptateur.

Renvoie

  • Promise<AdapterState>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getDevice()

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

Obtenez des informations sur un appareil Bluetooth connu du système.

Paramètres

  • deviceAddress

    chaîne

    Adresse de l'appareil à obtenir.

  • rappel

    fonction facultatif

    Le paramètre callback se présente comme suit : 

    (deviceInfo: Device) => void

    • deviceInfo

      Appareil

      Objet contenant les informations sur l'appareil.

Renvoie

  • Promise<Device>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getDevices()

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

Obtenez la liste des appareils Bluetooth connus du système, y compris les appareils associés et récemment détectés.

Paramètres

  • filtre

    BluetoothFilter facultatif

    Chrome 67 ou version ultérieure

    Certains critères pour filtrer la liste des appareils Bluetooth renvoyés. Si le filtre n'est pas défini ou est défini sur {}, la liste des appareils renvoyée contient tous les appareils Bluetooth. Pour le moment, cette fonctionnalité n'est disponible que sur ChromeOS. Pour les autres plates-formes, une liste complète est renvoyée.

  • rappel

    fonction facultatif

    Le paramètre callback se présente comme suit : 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Appareil[]

      Tableau d'objets contenant des informations sur l'appareil.

Renvoie

  • Promise<Device[]>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startDiscovery()

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

Lancez l'exploration. Les appareils nouvellement détectés sont renvoyés via l'événement onDeviceAdded. Les appareils précédemment découverts et déjà connus de l'adaptateur doivent être obtenus à l'aide de getDevices et ne seront mis à jour à l'aide de l'événement onDeviceChanged que si les informations les concernant changent.

La découverte ne démarrera pas si cette application a déjà appelé startDiscovery. La découverte peut être gourmande en ressources: stopDiscovery doit être appelé dès que possible.

Paramètres

  • rappel

    fonction facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

stopDiscovery()

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

Arrêtez la découverte.

Paramètres

  • rappel

    fonction facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 91 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onAdapterStateChanged

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

Déclenché lorsque l'état de l'adaptateur Bluetooth change.

Paramètres

onDeviceAdded

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

Déclenché lorsque des informations sur un nouvel appareil Bluetooth sont disponibles.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit : 

    (device: Device) => void

onDeviceChanged

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

Déclenché lorsque les informations sur un appareil Bluetooth connu ont changé.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit : 

    (device: Device) => void

onDeviceRemoved

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

Déclenché lorsqu'un appareil Bluetooth précédemment détecté est hors de portée pendant suffisamment longtemps pour être considéré comme indisponible à nouveau et lorsqu'un appareil associé est supprimé.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit : 

    (device: Device) => void