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

Les clés suivantes doivent être déclarées dans le fichier manifeste pour utiliser cette API.

"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é).

  • découvrir

    booléen

    Indique si l'adaptateur est 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 et versions ultérieures

Propriétés

  • filterType

    FilterType facultatif

    Type de filtre à appliquer à la liste des appareils. La valeur par défaut est "all" (tous).

  • limite

    number facultatif

    Nombre maximal d'appareils Bluetooth à renvoyer. La valeur par défaut est 0 (aucune limite) si aucune valeur n'est 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

    Batterie restante 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 est en cours de connexion 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 et versions ultérieures

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

  • inquiryTxPower

    number facultatif

    Chrome 44 et versions ultérieures

    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 facultative

    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 et versions ultérieures

    Type de transport de l'appareil Bluetooth.

  • type

    DeviceType facultatif

    Type d'appareil, s'il est reconnu par Chrome. Cette valeur est obtenue à 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 à basse consommation, cette liste est obtenue à partir des services principaux AD et GATT. Pour les appareils à double mode, il peut être obtenu à 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"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 et versions ultérieures

Types pour filtrer les appareils Bluetooth.

Énumération

"all"

known

Transport

Chrome 76 et versions ultérieures

Type de transport de l'appareil Bluetooth.

Énumération

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Autorités d'attribution des ID de fournisseur.

Énumération

"bluetooth"

"usb"

Méthodes

getAdapterState()

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

Obtenez des informations sur l'adaptateur Bluetooth.

Paramètres

  • callback

    function facultatif

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objet contenant les informations de l'adaptateur.

Renvoie

  • Promise<AdapterState>

    Chrome 91 et versions ultérieures

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

getDevice()

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

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

Paramètres

  • deviceAddress

    chaîne

    Adresse de l'appareil à obtenir.

  • callback

    function 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 et versions ultérieures

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

getDevices()

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

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

Paramètres

  • filtre

    BluetoothFilter facultatif

    Chrome 67 et versions ultérieures

    Critères permettant de 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 dans ChromeOS. Pour les autres plates-formes, une liste complète est renvoyée.

  • callback

    function 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 et versions ultérieures

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

startDiscovery()

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

Lancez l'exploration. Les nouveaux appareils détectés seront renvoyés via l'événement onDeviceAdded. Les appareils précédemment détectés 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 des 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. Il est donc recommandé d'appeler stopDiscovery dès que possible.

Paramètres

  • callback

    function facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 91 et versions ultérieures

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

stopDiscovery()

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

Arrêtez la découverte.

Paramètres

  • callback

    function facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 91 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les 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

  • callback

    fonction

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

    (state: AdapterState) => void

onDeviceAdded

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

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

Paramètres

  • callback

    fonction

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

    (device: Device) => void

onDeviceChanged

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

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

Paramètres

  • callback

    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 depuis suffisamment longtemps pour être considéré comme indisponible, et lorsqu'un appareil associé est supprimé.

Paramètres

  • callback

    fonction

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

    (device: Device) => void