chrome.bluetoothLowEnergy

Description

L'API chrome.bluetoothLowEnergy permet de communiquer avec les appareils Bluetooth Smart (à basse consommation) à l'aide du profil d'attribut générique (GATT).

Manifest

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

"bluetooth"

Types

Advertisement

Chrome 47 ou version ultérieure

Propriétés

  • manufacturerData

    ManufacturerData[] facultatif

    Liste des données spécifiques au fabricant à inclure dans les champs "Données spécifiques au fabricant" des données publicitaires.

  • serviceData

    ServiceData[] facultatif

    Liste des données des services à inclure dans les champs "Données des services" des données publicitaires.

  • serviceUuids

    string[] facultatif

    Liste des UUID à inclure dans le champ "UUID du service" des données publicitaires. Ces UUID peuvent être au format 16 bits, 32 bits ou 128.

  • solicitUuids

    string[] facultatif

    Liste des UUID à inclure dans le champ "UUID de contact" des données publicitaires. Ces UUID peuvent être au format 16 bits, 32 bits ou 128.

  • Type de publicité.

AdvertisementType

Chrome 47 ou version ultérieure

Type de publicité. Si l'option "broadcast" est sélectionnée, le type d'annonce envoyée est ADV_NONCONN_IND, et l'appareil diffuse une annonce avec une adresse MAC aléatoire. Si elle est définie sur "périphérique", le type d'annonce sera ADV_IND ou ADV_SCAN_IND, et l'appareil diffusera une annonce avec l'adresse MAC de l'adaptateur Bluetooth réel.

Enum

"broadcast"

Characteristic

Propriétés

  • instanceId

    string facultatif

    Renvoie l'identifiant attribué à cette caractéristique. Utilisez l'ID d'instance pour distinguer les caractéristiques d'un périphérique ayant le même UUID et pour effectuer des appels de fonction qui reçoivent un identifiant de caractéristique. Présent, si cette instance représente une caractéristique distante.

  • Propriétés de cette caractéristique.

  • service

    Service facultatif

    Service GATT auquel cette caractéristique appartient.

  • uuid

    chaîne

    UUID de la caractéristique, par exemple 00002a37-0000-1000-8000-00805f9b34fb.

  • valeur

    ArrayBuffer facultatif

    Valeur de caractéristique actuellement mise en cache. Cette valeur est mise à jour lorsque la valeur de la caractéristique est lue ou mise à jour via une notification ou une indication.

CharacteristicProperty

Valeurs représentant les propriétés possibles d'une caractéristique. Les autorisations caractéristiques sont déduites de ces propriétés. Veuillez consulter la spécification Bluetooth 4.x pour connaître la signification de chaque propriété.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriétés

  • SSD

    boolean

    Indique si une connexion à l'appareil est restée ouverte lorsque la page d'événements de l'application est déchargée (voir Gérer le cycle de vie des applications). La valeur par défaut est false..

Descriptor

Propriétés

  • caractéristique

    Caractéristique facultatif

    La caractéristique GATT à laquelle appartient ce descripteur.

  • instanceId

    string facultatif

    Renvoie l'identifiant attribué à ce descripteur. Utilisez l'ID d'instance pour distinguer les descripteurs d'un périphérique ayant le même UUID et pour effectuer des appels de fonction qui reçoivent un identifiant de descripteur. Présent, si cette instance représente une caractéristique distante.

  • autorisations

    DescriptorPermission[]

    Chrome 52 ou version ultérieure

    Autorisations de ce descripteur.

  • uuid

    chaîne

    UUID du descripteur de caractéristique, par exemple 00002902-0000-1000-8000-00805f9b34fb.

  • valeur

    ArrayBuffer facultatif

    Valeur de descripteur actuellement mise en cache. Cette valeur est mise à jour lorsque la valeur du descripteur est lue.

DescriptorPermission

Chrome 52 ou version ultérieure

Valeurs représentant les autorisations possibles pour un descripteur. Veuillez consulter la spécification Bluetooth 4.x pour connaître la signification de chaque autorisation.

Enum

"read"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ou version ultérieure

Propriétés

  • adresse

    chaîne

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

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

  • name

    string facultatif

    Nom lisible de l'appareil.

ManufacturerData

Chrome 47 ou version ultérieure

Propriétés

  • data

    nombre[]

  • id

    number

Notification

Chrome 52 ou version ultérieure

Propriétés

  • shouldIndicate

    Booléen facultatif

    Indicateur facultatif permettant d'envoyer une indication au lieu d'une notification.

  • valeur

    ArrayBuffer

    Nouvelle valeur de la caractéristique.

NotificationProperties

Propriétés

  • SSD

    boolean

    Indique si l'application doit recevoir des notifications lorsque la page d'événements de l'application est déchargée (voir Gérer le cycle de vie des applications). La valeur par défaut est false.

Request

Chrome 52 ou version ultérieure

Propriétés

  • appareil

    Appareil

    Appareil qui envoie cette requête.

  • requestId

    number

    Identifiant unique pour cette requête. Utilisez cet ID lorsque vous répondez à cette requête.

  • valeur

    ArrayBuffer facultatif

    Valeur à écrire (s'il s'agit d'une requête d'écriture).

Response

Chrome 52 ou version ultérieure

Propriétés

  • isError

    boolean

    S'il s'agit d'une réponse d'erreur, la valeur doit être "true".

  • requestId

    number

    Identifiant de la requête à laquelle il s'agit d'une réponse.

  • valeur

    ArrayBuffer facultatif

    Valeur de la réponse. Les requêtes d'écriture et les réponses d'erreur ignorent ce paramètre.

Service

Propriétés

  • deviceAddress

    string facultatif

    Adresse de l'appareil distant auquel appartient le service GATT. Présent, si cette instance représente un service distant.

  • instanceId

    string facultatif

    Renvoie l'identifiant attribué à ce service. Utilisez l'ID d'instance pour distinguer les services d'un périphérique ayant le même UUID et pour effectuer des appels de fonction qui reçoivent un identifiant de service. Présent, si cette instance représente un service distant.

  • isPrimary

    boolean

    Indique si le type de ce service est principal ou secondaire.

  • uuid

    chaîne

    UUID du service, par exemple 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 ou version ultérieure

Propriétés

  • data

    nombre[]

  • uuid

    chaîne

Méthodes

connect()

Promesse 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Établit une connexion entre l'application et l'appareil avec l'adresse donnée. Il est possible qu'un appareil soit déjà connecté et que ses services GATT soient disponibles sans appeler connect. Toutefois, une application qui souhaite accéder aux services GATT d'un appareil doit appeler cette fonction pour s'assurer qu'une connexion à l'appareil est maintenue. Si l'appareil n'est pas connecté, tous ses services GATT seront détectés après un appel réussi à connect.

Paramètres

  • deviceAddress

    chaîne

    Adresse Bluetooth de l'appareil distant auquel une connexion GATT doit être ouverte.

  • du bucket

    ConnectProperties facultatif

    Propriétés de connexion (facultatif).

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

createCharacteristic()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Créez une caractéristique GATT hébergée localement. Cette caractéristique doit être hébergée par un service valide. Si l'ID de service n'est pas valide, lastError est défini. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • caractéristique

    Caractéristique

    La caractéristique à créer.

  • serviceId

    chaîne

    ID du service pour lequel cette caractéristique sera créée.

  • rappel

    fonction facultative

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

    (characteristicId: string)=>void

    • characteristicId

      chaîne

Renvoie

  • Promesse<chaîne>

    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.

createDescriptor()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Créez un descripteur GATT hébergé localement. Ce descripteur doit être hébergé sous une caractéristique valide. Si l'ID de caractéristique n'est pas valide, la valeur lastError est définie. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • descripteur

    Descripteur

    Descripteur à créer.

  • characteristicId

    chaîne

    ID de la caractéristique pour laquelle créer ce descripteur.

  • rappel

    fonction facultative

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

    (descriptorId: string)=>void

    • descriptorId

      chaîne

Renvoie

  • Promesse<chaîne>

    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.

createService()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Créer un service GATT hébergé localement Ce service peut être enregistré pour être disponible sur un serveur GATT local. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • service

    Service

    Service à créer.

  • rappel

    fonction facultative

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

    (serviceId: string)=>void

    • serviceId

      chaîne

Renvoie

  • Promesse<chaîne>

    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.

disconnect()

Promesse 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Ferme la connexion de l'application à l'appareil associé à l'adresse indiquée. Notez que cette opération n'entraîne pas toujours la destruction du lien physique lui-même, car d'autres applications peuvent avoir des connexions ouvertes.

Paramètres

  • deviceAddress

    chaîne

    Adresse Bluetooth de l'appareil distant.

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

getCharacteristic()

Promesse 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Récupère la caractéristique GATT avec l'ID d'instance donné qui appartient au service GATT donné, le cas échéant.

Paramètres

  • characteristicId

    chaîne

    ID d'instance de la caractéristique GATT demandée.

  • rappel

    fonction facultative

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

    (result: Characteristic)=>void

Renvoie

  • Promise<Characteristic>

    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.

getCharacteristics()

Promesse 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

Permet d'obtenir la liste de toutes les caractéristiques GATT détectées qui appartiennent au service donné.

Paramètres

  • serviceId

    chaîne

    ID d'instance du service GATT dont les caractéristiques doivent être renvoyées.

  • rappel

    fonction facultative

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

    (result: Characteristic[])=>void

Renvoie

  • Promise<Characteristic[]>

    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.

getDescriptor()

Promesse 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Récupère le descripteur de caractéristique GATT avec l'ID d'instance donné.

Paramètres

  • descriptorId

    chaîne

    ID d'instance du descripteur de caractéristique GATT demandé.

  • rappel

    fonction facultative

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

    (result: Descriptor)=>void

Renvoie

  • Promise<Descriptor>

    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.

getDescriptors()

Promesse 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

Obtenir la liste des descripteurs de caractéristiques GATT appartenant à la caractéristique donnée.

Paramètres

  • characteristicId

    chaîne

    ID d'instance de la caractéristique GATT dont les descripteurs doivent être renvoyés.

  • rappel

    fonction facultative

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

    (result: Descriptor[])=>void

Renvoie

  • Promise<Descriptor[]>

    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.

getIncludedServices()

Promesse 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Permet d'obtenir la liste des services GATT inclus par le service donné.

Paramètres

  • serviceId

    chaîne

    ID d'instance du service GATT dont les services inclus doivent être renvoyés.

  • rappel

    fonction facultative

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

    (result: Service[])=>void

Renvoie

  • Promesse<Service[]>

    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.

getService()

Promesse 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

Récupère le service GATT avec l'ID d'instance donné.

Paramètres

  • serviceId

    chaîne

    ID d'instance du service GATT demandé.

  • rappel

    fonction facultative

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

    (result: Service)=>void

Renvoie

  • Promise<Service>

    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.

getServices()

Promesse 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Permet d'obtenir tous les services GATT détectés sur l'appareil distant avec l'adresse donnée de l'appareil.

Remarque:Si la détection de services n'est pas encore terminée sur l'appareil, cette API affiche un sous-ensemble de services (éventuellement vide). Pour contourner ce problème, vous pouvez ajouter un délai temporel et/ou effectuer un appel répété jusqu'à ce que le nombre attendu de services soit renvoyé.

Paramètres

  • deviceAddress

    chaîne

    Adresse Bluetooth de l'appareil distant dont les services GATT doivent être renvoyés.

  • rappel

    fonction facultative

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

    (result: Service[])=>void

Renvoie

  • Promesse<Service[]>

    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.

notifyCharacteristicValueChanged()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Informer un appareil distant de la nouvelle valeur d'une caractéristique. Si l'indicateur mustIndicate de l'objet notification est défini sur "true", une indication est envoyée à la place d'une notification. Notez que la caractéristique doit définir correctement la propriété "notify" ou "indicate" lors de la création pour que cet appel aboutisse. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • characteristicId

    chaîne

    Caractéristique pour laquelle la notification doit être envoyée.

  • notification

    Notification

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

readCharacteristicValue()

Promesse 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

Récupérez la valeur d'une caractéristique spécifiée à partir d'un périphérique distant.

Paramètres

  • characteristicId

    chaîne

    ID d'instance de la caractéristique GATT dont la valeur doit être lue à partir de l'appareil distant.

  • rappel

    fonction facultative

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

    (result: Characteristic)=>void

Renvoie

  • Promise<Characteristic>

    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.

readDescriptorValue()

Promesse 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Récupérez la valeur d'un descripteur de caractéristique spécifié à partir d'un périphérique distant.

Paramètres

  • descriptorId

    chaîne

    ID d'instance du descripteur de caractéristique GATT dont la valeur doit être lue à partir de l'appareil distant.

  • rappel

    fonction facultative

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

    (result: Descriptor)=>void

Renvoie

  • Promise<Descriptor>

    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.

registerAdvertisement()

Promesse Chrome 47 et versions ultérieures 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Créez une annonce et enregistrez-la pour y diffuser des annonces. Pour appeler cette fonction, les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application doivent être définies sur "true". De plus, cette API n'est disponible que pour les applications lancées automatiquement en mode Kiosque ou en définissant l'option de ligne de commande "--enable-ble-advertising-in-apps". Consultez https://developer.chrome.com/apps/manifest/bluetooth Remarque: Sur certains matériels, le mode central et le mode périphérique sont pris en charge simultanément, mais sur le matériel non compatible, cet appel fera passer l'appareil en mode périphérique. Dans le cas d'un matériel qui ne prend pas en charge à la fois le mode central et le mode périphérique, toute tentative d'utilisation de l'appareil dans les deux modes entraînera un comportement indéfini ou empêchera d'autres applications centrales de se comporter correctement (y compris la découverte d'appareils Bluetooth à basse consommation).

Paramètres

  • publicité

    Publicité

    Publicité à diffuser.

  • rappel

    fonction facultative

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

    (advertisementId: number)=>void

    • advertisementId

      number

Renvoie

  • Promesse<number>

    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.

registerService()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Enregistre le service donné auprès du serveur GATT local. Si l'ID de service n'est pas valide, lastError est défini. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • serviceId

    chaîne

    ID unique d'un service créé.

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

removeService()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Supprime le service spécifié et annule son enregistrement s'il était enregistré. Si l'ID de service n'est pas valide, lastError est défini. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • serviceId

    chaîne

    ID unique d'un service actuellement enregistré.

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

resetAdvertising()

Promettre Chrome 61 et versions ultérieures 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Réinitialise la publicité sur l'appareil actuel. L'enregistrement sera annulé et toutes les publicités existantes seront arrêtées.

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.

sendRequestResponse()

Chrome 52 ou version ultérieure 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Envoie une réponse à une requête de lecture/écriture de caractéristique ou de descripteur. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • réponse

    Réponse

    Réponse à la requête.

setAdvertisingInterval()

Promesse Chrome 55 et versions ultérieures 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

"Set" correspond à l'intervalle entre deux annonces consécutives. Remarque: Nous faisons tout notre possible. L'intervalle réel peut varier de manière significative par rapport aux intervalles demandés. Sur certains matériels, l'intervalle minimal est de 100 ms. Les valeurs minimale et maximale ne doivent pas dépasser la plage autorisée par la spécification Bluetooth 4.2.

Paramètres

  • minInterval

    number

    Intervalle minimal entre les annonces (en millisecondes). Cette valeur ne peut pas être inférieure à 20 ms (conformément aux spécifications).

  • maxInterval

    number

    Intervalle maximal entre les annonces (en millisecondes). La valeur ne peut pas dépasser 10 240 ms (conformément aux spécifications).

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

startCharacteristicNotifications()

Promesse 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

Active les notifications/indications de valeur à partir de la caractéristique spécifiée. Une fois activé, une application peut écouter les notifications à l'aide de l'événement onCharacteristicValueChanged.

Paramètres

  • characteristicId

    chaîne

    ID d'instance de la caractéristique GATT sur laquelle les notifications doivent être activées.

  • du bucket

    NotificationProperties facultatif

    Propriétés de la session de notification (facultatif).

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

stopCharacteristicNotifications()

Promesse 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Désactiver les notifications/indications de valeur pour la caractéristique spécifiée. Une fois l'appel réussi, l'application ne recevra plus de notifications/indications de cette caractéristique.

Paramètres

  • characteristicId

    chaîne

    ID d'instance de la caractéristique GATT sur laquelle la session de notification de cette application doit être arrêtée.

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

unregisterAdvertisement()

Promesse Chrome 47 et versions ultérieures 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Annule l'enregistrement d'une annonce et arrête sa diffusion. Si l'annonce n'est pas désenregistrée, le seul moyen d'arrêter la diffusion de la publicité peut être de redémarrer l'appareil.

Paramètres

  • advertisementId

    number

    Identifiant de l'annonce dont l'enregistrement doit être annulé.

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

unregisterService()

Promesse Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Annulez l'enregistrement du service donné auprès du serveur GATT local. Si l'ID de service n'est pas valide, lastError est défini. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • serviceId

    chaîne

    ID unique d'un service actuellement enregistré.

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

writeCharacteristicValue()

Promesse 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

Écrivez la valeur d'une caractéristique spécifiée à partir d'un périphérique distant.

Paramètres

  • characteristicId

    chaîne

    ID d'instance de la caractéristique GATT dont la valeur doit être écrite.

  • valeur

    ArrayBuffer

    Valeur à envoyer à la caractéristique distante dans le cadre de la requête d'écriture.

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

writeDescriptorValue()

Promesse 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

Écrivez la valeur d'un descripteur de caractéristique spécifié à partir d'un périphérique distant.

Paramètres

  • descriptorId

    chaîne

    ID d'instance du descripteur de caractéristique GATT dont la valeur doit être écrite.

  • valeur

    ArrayBuffer

    Valeur à envoyer au descripteur distant dans le cadre de la requête d'écriture.

  • 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

onCharacteristicReadRequest

Chrome 52 ou version ultérieure 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande à lire la valeur d'une caractéristique enregistrée sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant une longue période, vous risquez d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • rappel

    function

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

    (request: Request,characteristicId: string)=>void

    • request

      Requête

    • characteristicId

      chaîne

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

Déclenché lorsque la valeur d'une caractéristique GATT distante change, soit à la suite d'une requête de lecture, soit à la suite d'une notification/indication de changement de valeur. Cet événement n'est envoyé que si l'application a activé les notifications en appelant startCharacteristicNotifications.

Paramètres

onCharacteristicWriteRequest

Chrome 52 ou version ultérieure 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande l'écriture de la valeur d'une caractéristique enregistrée sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant une longue période, vous risquez d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • rappel

    function

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

    (request: Request,characteristicId: string)=>void

    • request

      Requête

    • characteristicId

      chaîne

onDescriptorReadRequest

Chrome 52 ou version ultérieure 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande à lire la valeur d'un descripteur enregistré sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant une longue période, vous risquez d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • rappel

    function

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

    (request: Request,descriptorId: string)=>void

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

Déclenché lorsque la valeur d'un descripteur de caractéristique GATT distante est modifiée, généralement à la suite d'une requête de lecture. Cet événement est principalement destiné à des fins de commodité et est toujours envoyé après un appel réussi à readDescriptorValue.

Paramètres

  • rappel

    function

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

    (descriptor: Descriptor)=>void

onDescriptorWriteRequest

Chrome 52 ou version ultérieure 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande l'écriture de la valeur d'un descripteur enregistré sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant une longue période, vous risquez d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral de l'application sont définies sur "true". Il est possible que l'autorisation d'accès au périphérique ne soit pas disponible pour toutes les applis.

Paramètres

  • rappel

    function

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

    (request: Request,descriptorId: string)=>void

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

Déclenché lorsqu'un nouveau service GATT a été découvert sur un appareil distant

Paramètres

  • rappel

    function

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

    (service: Service)=>void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

Déclenché lorsque l'état d'un service GATT distant change Cela implique toutes les caractéristiques et/ou les descripteurs qui sont ajoutés ou supprimés du service, ainsi que les notifications "ServiceChanged" de l'appareil distant.

Paramètres

  • rappel

    function

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

    (service: Service)=>void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

Déclenché lorsqu'un service GATT précédemment détecté sur un appareil distant a été supprimé.

Paramètres

  • rappel

    function

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

    (service: Service)=>void