chrome.bluetooth

Description

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

Manifest

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

    boolean

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

  • découvrir

    boolean

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

  • name

    chaîne

    Nom lisible de l'adaptateur.

  • alimenté

    boolean

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

    Batterie restante de l'appareil.

  • connecté

    Booléen facultatif

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

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

  • deviceClass

    numéro facultatif

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

    numéro facultatif

    Chrome 44 ou version ultérieure

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

  • name

    string 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, si Chrome le reconnaît. Elle 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.

  • UID

    string[] facultatif

    UUID des protocoles, des profils et des 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 en mode double, vous pouvez obtenir cette information à partir des deux.

  • vendorId

    numéro facultatif

  • vendorIdSource

    VendorIdSource facultatif

    Enregistrement de l'ID de l'appareil, lorsqu'il est disponible.

DeviceType

Types d'appareils courants reconnus par Chrome.

Enum

"phone"

"modem"

"audio"

"carAudio"

"video"

"joystick"

FilterType

Chrome 67 et versions ultérieures

Types de filtrage des appareils Bluetooth.

Enum

"all"

Transport

Chrome 76 et versions ultérieures

Type de transport de l'appareil Bluetooth.

Enum

"invalid"

"le"

"dual"

VendorIdSource

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

Enum

"bluetooth"

"usb"

Méthodes

getAdapterState()

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

Obtenez des informations sur l'adaptateur Bluetooth.

Paramètres

  • rappel

    fonction facultative

    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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getDevice()

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

Obtenez des informations à propos d'un appareil Bluetooth connu du système.

Paramètres

  • deviceAddress

    chaîne

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

  • rappel

    fonction facultative

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

    (deviceInfo: Device)=>void

    • deviceInfo

      Appareil

      Objet contenant les informations sur l'appareil.

Renvoie

  • Promettre<Appareil>

    Chrome 91 et versions ultérieures

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

    Critères pour filtrer la liste des appareils Bluetooth renvoyés. Si le filtre n'est pas défini ou s'il est défini sur {}, la liste d'appareils renvoyée contiendra tous les appareils Bluetooth. Pour le moment, cette fonctionnalité n'est compatible qu'avec ChromeOS. Pour les autres plates-formes, la liste complète s'affiche.

  • rappel

    fonction facultative

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

    (deviceInfos: Device[])=>void

    • deviceInfos

      Appareil[]

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

Renvoie

  • Promesse<Appareil[]>

    Chrome 91 et versions ultérieures

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

Commencez 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étection ne démarrera pas si cette application a déjà appelé startDiscovery. La détection peut nécessiter beaucoup de ressources: stopDiscovery doit être appelé dès que possible.

Paramètres

  • rappel

    fonction facultative

    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 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 facultative

    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 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 concernant un nouvel appareil Bluetooth sont disponibles

Paramètres

  • rappel

    function

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

    (device: Device)=>void

onDeviceChanged

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

Déclenché lorsque les informations concernant un appareil Bluetooth connu sont modifiées

Paramètres

  • rappel

    function

    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é se trouve hors de portée depuis suffisamment longtemps pour être considéré à nouveau comme indisponible, et lorsqu'un appareil associé est retiré.

Paramètres

  • rappel

    function

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

    (device: Device)=>void