chrome.bluetooth

Description

Utilisez l'API chrome.bluetooth pour vous connecter à un appareil Bluetooth. Toutes les fonctions signalent des é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 ou non (activé).

  • découvrir

    booléen

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

  • nom

    chaîne

    Nom lisible de l'adaptateur.

  • alimenté

    booléen

    Indique si l'adaptateur est alimenté ou non.

BluetoothFilter

Chrome (version 67 ou ultérieure)

Propriétés

  • filterType

    FilterType facultatif

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

  • limite

    numéro facultatif

    Nombre maximal d'appareils Bluetooth à renvoyer. Si aucune valeur n'est spécifiée, la valeur par défaut est 0 (aucune limite).

Device

Propriétés

  • adresse

    chaîne

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

  • batteryPercentage

    numéro facultatif

    Chrome 77 ou version ultérieure

    Batterie restante de l'appareil.

  • pouvant être connecté

    Booléen facultatif

    Chrome (version 48 ou ultérieure)

    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 (version 48 ou ultérieure)

    Indique si l'appareil est en train de se connecter au système.

  • deviceClass

    numéro facultatif

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

  • deviceId

    numéro facultatif

  • inquiryRssi

    numéro facultatif

    Chrome (version 44 ou ultérieure)

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

  • inquiryTxPower

    numéro facultatif

    Chrome (version 44 ou 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 lors de 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

    numéro 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 information, obtenue à partir du champ deviceClass, ne représente qu'une petite partie des types d'appareils possibles. En cas de doute, vous devez utiliser 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 tableaux SDP. Pour les appareils à basse consommation, cette liste est obtenue auprès des services principaux AD et GATT. Pour les appareils à double mode, cette information peut être obtenue à partir des deux.

  • vendorId

    numéro facultatif

  • vendorIdSource

    VendorIdSource facultatif

    ID de l'appareil, si disponible.

DeviceType

Types d'appareils courants reconnus par Chrome.

Énumération

"ordinateur"

"téléphone"

"modem"

"audio"

"carAudio"

"vidéo"

"périphérique"

"joystick"

"manette de jeu"

"clavier"

"souris"

"tablette"

"keyboardMouseCombo"

FilterType

Chrome (version 67 ou ultérieure)

Types de filtrage des appareils Bluetooth.

Énumération

"tous"

"connu"

Transport

Chrome 76 et versions ultérieures

Type de transport de l'appareil Bluetooth.

Énumération

"non valide"

"classique"

"le"

"dual"

VendorIdSource

Autorités d'allocation pour les ID de fournisseur.

Énumération

"Bluetooth"

"usb"

Méthodes

getAdapterState()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Obtenez des informations sur l'adaptateur Bluetooth.

Paramètres

  • rappel

    function facultatif

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objet contenant les informations sur l'adaptateur

Renvoie

  • Promise&lt;AdapterState&gt;

    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()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Obtenez des informations sur un périphérique Bluetooth connu du système.

Paramètres

  • deviceAddress

    chaîne

    Adresse de l'appareil à récupérer.

  • rappel

    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&lt;Device&gt;

    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()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

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

Paramètres

  • filtre

    BluetoothFilter facultatif

    Chrome (version 67 ou ultérieure)

    Quelques 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 d'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.

  • rappel

    function facultatif

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      Appareil[]

      Tableau d'objets contenant des informations sur les appareils.

Renvoie

  • Promesse<Appareil[]>

    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()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Lancez la découverte. Les appareils récemment 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 les informations les concernant changent.

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

Paramètres

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<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()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Arrêter la découverte.

Paramètres

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<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 relatives à un appareil Bluetooth connu ont été modifiées.

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écouvert est hors de portée depuis 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