chrome.bluetoothLowEnergy

Description

L'API chrome.bluetoothLowEnergy est utilisée pour communiquer avec les appareils Bluetooth Smart (à basse consommation) à l'aide du Generic Attribute Profile (GATT).

Fichier manifeste

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

"bluetooth"

Types

Advertisement

Chrome 47 et versions ultérieures

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 de service à inclure dans les champs "Données de service" des données publicitaires.

  • serviceUuids

    string[] facultatif

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

  • solicitUuids

    string[] facultatif

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

  • Type de publicité.

AdvertisementType

Chrome 47 et versions ultérieures

Type de publicité. Si l'option "broadcast" est sélectionnée, le type d'annonce envoyé sera ADV_NONCONN_IND et l'appareil diffusera avec une adresse MAC aléatoire. Si la valeur est définie sur &39;peripheral', le type d'annonce sera ADV_IND ou ADV_SCAN_IND, et l'appareil diffusera l'adresse MAC de l'adaptateur Bluetooth réel.

Énumération

"broadcast"

"peripheral"

Characteristic

Propriétés

  • instanceId

    chaîne facultative

    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 prennent en compte un identifiant de caractéristique. Présent si cette instance représente une caractéristique distante.

  • properties

    CharacteristicProperty[]

    Propriétés de cette caractéristique.

  • service

    Service facultatif

    Service GATT auquel appartient cette caractéristique.

  • 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 les spécifications Bluetooth 4.x pour connaître la signification de chaque propriété.

Énumération

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriétés

  • SSD

    booléen

    Indicateur indiquant si une connexion à l'appareil est laissée ouverte lorsque la page d'événement de l'application est déchargée (voir Gérer le cycle de vie de l'application). La valeur par défaut est false..

Descriptor

Propriétés

  • caractéristique

    Caractéristique facultatif

    Caractéristique GATT à laquelle appartient ce descripteur.

  • instanceId

    chaîne facultative

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

  • autorisations

    DescriptorPermission[]

    Chrome 52 et versions ultérieures

    Autorisations de ce descripteur.

  • uuid

    chaîne

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

  • valeur

    ArrayBuffer facultatif

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

DescriptorPermission

Chrome 52 et versions ultérieures

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

Énumération

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 et versions ultérieures

Propriétés

  • adresse

    chaîne

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

  • deviceClass

    number facultatif

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

  • nom

    chaîne facultative

    Nom lisible de l'appareil.

ManufacturerData

Chrome 47 et versions ultérieures

Propriétés

  • données

    number[]

  • id

    Total

Notification

Chrome 52 et versions ultérieures

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

    booléen

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

Request

Chrome 52 et versions ultérieures

Propriétés

  • appareil

    Appareil

    Appareil ayant envoyé cette requête.

  • requestId

    Total

    ID unique pour cette demande. Utilisez cet ID lorsque vous répondez à cette demande.

  • valeur

    ArrayBuffer facultatif

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

Response

Chrome 52 et versions ultérieures

Propriétés

  • isError

    booléen

    Si la réponse est une réponse d'erreur, cette valeur doit être définie sur "true".

  • requestId

    Total

    ID de la requête à laquelle cette réponse se rapporte.

  • valeur

    ArrayBuffer facultatif

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

Service

Propriétés

  • deviceAddress

    chaîne facultative

    Adresse de l'appareil du périphérique distant auquel appartient le service GATT. Présent si cette instance représente un service à distance.

  • instanceId

    chaîne facultative

    Renvoie l'identifiant attribué à ce service. Utilisez l'ID d'instance pour faire la distinction entre les services d'un périphérique ayant le même UUID et pour effectuer des appels de fonction qui prennent en compte un identifiant de service. Présent si cette instance représente un service à distance.

  • isPrimary

    booléen

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

Propriétés

  • données

    number[]

  • uuid

    chaîne

Méthodes

connect()

Promise 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

Établit une connexion entre l'application et l'appareil à l'adresse indiquée. Un appareil peut déjà être connecté et ses services GATT 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 les services GATT de l'appareil 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.

  • properties

    ConnectProperties facultatif

    Propriétés de connexion (facultatif).

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

createCharacteristic()

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

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 sera 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • caractéristique

    Caractéristique

    Caractéristique à créer.

  • ID du service

    chaîne

    ID du service pour lequel créer cette caractéristique.

  • callback

    function facultatif

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

    (characteristicId: string) => void

    • characteristicId

      chaîne

Renvoie

  • Promise<string>

    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.

createDescriptor()

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

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, lastError sera 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • descripteur

    Descriptor

    Descripteur à créer.

  • characteristicId

    chaîne

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

  • callback

    function facultatif

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

    (descriptorId: string) => void

    • descriptorId

      chaîne

Renvoie

  • Promise<string>

    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.

createService()

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

Créez 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • service

    Service

    Service à créer.

  • callback

    function facultatif

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

    (serviceId: string) => void

    • ID du service

      chaîne

Renvoie

  • Promise<string>

    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.

disconnect()

Promise 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

Ferme la connexion de l'application à l'appareil avec l'adresse donnée. Notez que cela ne détruira pas toujours le lien physique lui-même, car il peut y avoir d'autres applications avec des connexions ouvertes.

Paramètres

  • deviceAddress

    chaîne

    Adresse Bluetooth de l'appareil distant.

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

getCharacteristic()

Promise 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Obtenez la caractéristique GATT avec l'ID d'instance donné qui appartient au service GATT donné, si la caractéristique existe.

Paramètres

  • characteristicId

    chaîne

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

  • callback

    function facultatif

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

getCharacteristics()

Promise 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

Obtenez la liste de toutes les caractéristiques GATT découvertes qui appartiennent au service donné.

Paramètres

  • ID du service

    chaîne

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

  • callback

    function facultatif

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

getDescriptor()

Promise 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Obtenez 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é.

  • callback

    function facultatif

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

getDescriptors()

Promise 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

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

  • callback

    function facultatif

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

getIncludedServices()

Promise 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

Obtenez la liste des services GATT inclus dans le service donné.

Paramètres

  • ID du service

    chaîne

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

  • callback

    function facultatif

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

getService()

Promise 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

Obtenez le service GATT avec l'ID d'instance donné.

Paramètres

  • ID du service

    chaîne

    ID d'instance du service GATT demandé.

  • callback

    function facultatif

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

getServices()

Promise 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

Obtenez tous les services GATT découverts sur l'appareil distant avec l'adresse de l'appareil spécifiée.

Remarque : Si la découverte de services n'est pas encore terminée sur l'appareil, cette API renverra un sous-ensemble (éventuellement vide) de services. Pour contourner ce problème, vous pouvez ajouter un délai basé sur le temps et/ou appeler le service à plusieurs reprises jusqu'à ce que le nombre de services attendu soit renvoyé.

Paramètres

  • deviceAddress

    chaîne

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

  • callback

    function facultatif

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

notifyCharacteristicValueChanged()

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

Notifier à un appareil distant une nouvelle valeur pour une caractéristique. Si le flag "shouldIndicate" de l'objet de notification est défini sur "true", une indication sera 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 réussisse. 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • characteristicId

    chaîne

    Caractéristique pour laquelle envoyer la notification.

  • notification

    Notification

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

readCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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.

  • callback

    function facultatif

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

readDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Récupère 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.

  • callback

    function facultatif

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

registerAdvertisement()

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

Créez une annonce et enregistrez-la pour la publicité. 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 le commutateur de ligne de commande "--enable-ble-advertising-in-apps". Consultez https://developer.chrome.com/apps/manifest/bluetooth. Remarque : Sur certains appareils, les modes central et périphérique peuvent être utilisés en même temps. Sur les appareils qui ne le permettent pas, cet appel basculera l'appareil en mode périphérique. Dans le cas d'un matériel qui ne prend pas en charge les modes central et 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 de rôle central de se comporter correctement (y compris la découverte des appareils Bluetooth à basse consommation).

Paramètres

  • publicité

    Publicité

    Publicité à promouvoir.

  • callback

    function facultatif

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

    (advertisementId: number) => void

    • advertisementId

      Total

Renvoie

  • Promise<number>

    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.

registerService()

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

Enregistre le service donné auprès du serveur GATT local. Si l'ID de service n'est pas valide, lastError sera 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    ID unique d'un service créé.

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

removeService()

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

Supprime le service spécifié et annule son enregistrement s'il a été enregistré. Si l'ID de service n'est pas valide, lastError sera 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    ID unique d'un service enregistré.

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

resetAdvertising()

Promise Chrome 61 et versions ultérieures 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

Réinitialise la publicité sur l'appareil actuel. Il désenregistrera et arrêtera toutes les publicités existantes.

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.

sendRequestResponse()

Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

Envoie une réponse pour 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • réponse

    Réponse

    Réponse à la demande.

setAdvertisingInterval()

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

Définit l'intervalle entre deux annonces consécutives. Remarque : Cette opération est effectuée dans la mesure du possible. L'intervalle réel peut varier de manière non triviale par rapport aux intervalles demandés. Sur certains appareils, l'intervalle minimal est de 100 ms. Les valeurs minimale et maximale ne peuvent pas dépasser la plage autorisée par la spécification Bluetooth 4.2.

Paramètres

  • minInterval

    Total

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

  • maxInterval

    Total

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

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

startCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

Activez les notifications/indications de valeur à partir de la caractéristique spécifiée. Une fois activée, 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 pour laquelle les notifications doivent être activées.

  • properties

    NotificationProperties facultatif

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

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

stopCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

Désactive les notifications/indications de valeur de la caractéristique spécifiée. Une fois l'appel terminé, l'application ne recevra plus de notifications ni d'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.

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

unregisterAdvertisement()

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

Annule l'enregistrement d'une publicité et arrête sa diffusion. Si l'annonce ne parvient pas à se désinscrire, le seul moyen d'arrêter la publicité peut être de redémarrer l'appareil.

Paramètres

  • advertisementId

    Total

    ID de la publicité à désenregistrer.

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

unregisterService()

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

Annule l'enregistrement du service donné auprès du serveur GATT local. Si l'ID de service n'est pas valide, lastError sera 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 pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    ID unique d'un service enregistré.

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

writeCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

É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 la requête d'écriture.

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

writeDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

É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 la requête d'écriture.

  • 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

onCharacteristicReadRequest

Chrome 52 et versions ultérieures 
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, votre compte risque d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" pour l'application. Il est possible que l'autorisation pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • callback

    fonction

    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, à la suite d'une demande de lecture ou 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 et versions ultérieures 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande à écrire 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, votre compte risque d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" pour l'application. Il est possible que l'autorisation pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • callback

    fonction

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

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

    • request

      Requête

    • characteristicId

      chaîne

onDescriptorReadRequest

Chrome 52 et versions ultérieures 
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, votre compte risque d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" pour l'application. Il est possible que l'autorisation pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • callback

    fonction

    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 distant change, généralement à la suite d'une demande de lecture. Cet événement existe principalement pour des raisons pratiques et sera toujours envoyé après un appel réussi à readDescriptorValue.

Paramètres

  • callback

    fonction

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 et versions ultérieures 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Événement déclenché lorsqu'un appareil central connecté demande à écrire la valeur d'un descripteur enregistré sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant une longue période, votre compte risque d'être déconnecté. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" pour l'application. Il est possible que l'autorisation pour les périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • callback

    fonction

    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

  • callback

    fonction

    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 inclut toutes les caractéristiques et/ou tous les descripteurs ajoutés ou supprimés du service, ainsi que les notifications "ServiceChanged" de l'appareil distant.

Paramètres

  • callback

    fonction

    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

  • callback

    fonction

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

    (service: Service) => void