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
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 à retourner. 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érieuresBatterie restante de l'appareil.
-
connecté
Booléen facultatif
Chrome 48 ou version ultérieureIndique 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érieureIndique 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érieureIntensité 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érieureNiveau 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érieuresType 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 champdeviceClass
. -
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
Types de filtrage des appareils Bluetooth.
Enum
"all"
Transport
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()
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
Objet contenant les informations de l'adaptateur.
-
Renvoie
-
Promise<AdapterState>
Chrome 91 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getDevice()
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
Objet contenant les informations sur l'appareil.
-
Renvoie
-
Promettre<Appareil>
Chrome 91 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getDevices()
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érieuresCritè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érieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
startDiscovery()
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érieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
stopDiscovery()
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érieuresLes 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
-
rappel
function
Le paramètre
callback
se présente comme suit :(state: AdapterState) => void
-
state
-
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
-
appareil
-
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
-
appareil
-
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é.