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

Fichier manifeste

Pour utiliser cette API, vous devez déclarer les clés suivantes dans le fichier manifeste.

"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 du 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 "Solicit UUIDs" (Demander des UUID) des données publicitaires. Ces UUID peuvent être au format 16 bits, 32 bits ou 128 bits.

  • Type d'annonce.

AdvertisementType

Chrome 47 et versions ultérieures

Type d'annonce. Si vous sélectionnez "broadcast" (diffusion), le type d'annonce envoyé sera ADV_NONCONN_IND et l'appareil diffusera 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 l'adresse MAC de l'adaptateur Bluetooth réel.

Énumération

"broadcast"

"peripheral"

Characteristic

Propriétés

  • instanceId

    chaîne facultatif

    Renvoie l'identifiant attribué à cette caractéristique. Utilisez l'ID d'instance pour distinguer les caractéristiques d'un périphérique avec le même UUID et pour effectuer des appels de fonction qui acceptent 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 la 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 de caractéristique 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"

"indiquer"

"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ésinstallé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 facultatif

    Renvoie l'identifiant attribué à ce descripteur. Utilisez l'ID d'instance pour distinguer les descripteurs d'un périphérique avec 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 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 mise 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.

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

    Nom lisible de l'appareil.

ManufacturerData

Chrome 47 et versions ultérieures

Propriétés

  • données

    number[]

  • id

    Nombre

Notification

Chrome 52 et versions ultérieures

Propriétés

  • shouldIndicate

    booléen facultatif

    Indicateur facultatif pour 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ésinstallé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 qui envoie cette requête.

  • requestId

    Nombre

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

Propriétés

  • isError

    booléen

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

  • requestId

    Nombre

    ID de la requête à laquelle cette réponse fait suite.

  • 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

    chaîne facultatif

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

  • instanceId

    chaîne facultatif

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

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

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

Établit une connexion entre l'application et l'appareil avec l'adresse donné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 sont 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 facultatif

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

    () => void

Renvoie

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

createCharacteristic()

Promise 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 dans 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 sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux 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.

  • rappel

    fonction facultatif

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

    (characteristicId: string) => void

    • characteristicId

      chaîne

Renvoie

  • Promise<string>

    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.

createDescriptor()

Promise 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 la caractéristique n'est pas valide, lastError est défini. Cette fonction n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • descripteur

    Décriteur

    Descripteur à créer.

  • characteristicId

    chaîne

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

  • rappel

    fonction facultatif

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

    (descriptorId: string) => void

    • descriptorId

      chaîne

Renvoie

  • Promise<string>

    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.

createService()

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

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 sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • service

    Service

    Service à créer.

  • rappel

    fonction facultatif

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

    (serviceId: string) => void

    • ID du service

      chaîne

Renvoie

  • Promise<string>

    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.

disconnect()

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

Ferme la connexion de l'application à l'appareil avec l'adresse indiquée. Notez que cela ne détruit pas toujours le 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 facultatif

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

    () => void

Renvoie

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

getCharacteristic()

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

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

  • rappel

    fonction facultatif

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

    (result: Characteristic) => void

Renvoie

  • Promise<Characteristic>

    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.

getCharacteristics()

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

Obtenez la liste de toutes les caractéristiques GATT détectées 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.

  • rappel

    fonction facultatif

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

    (result: Characteristic[]) => void

Renvoie

  • Promise<Characteristic[]>

    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.

getDescriptor()

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

Récupérez 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 facultatif

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

    (result: Descriptor) => void

Renvoie

  • Promise<Descriptor>

    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.

getDescriptors()

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

Récupérez 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 facultatif

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

    (result: Descriptor[]) => void

Renvoie

  • Promise<Descriptor[]>

    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.

getIncludedServices()

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

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

Paramètres

  • ID du service

    chaîne

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

  • rappel

    fonction facultatif

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

    (result: Service[]) => void

Renvoie

  • Promise<Service[]>

    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.

getService()

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

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

Paramètres

  • ID du service

    chaîne

    ID d'instance du service GATT demandé.

  • rappel

    fonction facultatif

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

    (result: Service) => void

Renvoie

  • Promise<Service>

    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.

getServices()

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

Récupérez tous les services GATT découverts sur l'appareil distant avec l'adresse de l'appareil donnée.

Remarque:Si la découverte de services n'est pas encore terminée sur l'appareil, cette API renvoie 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 plusieurs fois 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.

  • rappel

    fonction facultatif

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

    (result: Service[]) => void

Renvoie

  • Promise<Service[]>

    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.

notifyCharacteristicValueChanged()

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

Notifiez à un appareil distant une nouvelle valeur pour une caractéristique. Si l'indicateur shouldIndicate de l'objet de notification est défini sur "true", une indication est envoyée au lieu 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 sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux 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

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

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 facultatif

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

    (result: Characteristic) => void

Renvoie

  • Promise<Characteristic>

    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.

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 facultatif

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

    (result: Descriptor) => void

Renvoie

  • Promise<Descriptor>

    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.

registerAdvertisement()

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

Créez une annonce et enregistrez-la pour la publicité. Pour appeler cette fonction, les autorisations bluetooth:low_energy et bluetooth:peripheral 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 la page https://developer.chrome.com/apps/manifest/bluetooth. Remarque: Sur certains appareils, les modes central et périphérique sont compatibles en même temps. Toutefois, sur les appareils qui ne le sont pas, cet appel met l'appareil en mode périphérique. Si le matériel n'est pas compatible avec les modes central et périphérique, tenter d'utiliser 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 d'appareils Bluetooth à basse consommation).

Paramètres

  • publicité

    Publicité

    L'annonce à promouvoir.

  • rappel

    fonction facultatif

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

    (advertisementId: number) => void

    • advertisementId

      Nombre

Renvoie

  • Promise<number>

    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.

registerService()

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

Enregistrez 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 sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    Identifiant unique d'un service créé.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

removeService()

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

Supprimez le service spécifié et annulez 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 sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    Identifiant unique d'un service actuellement enregistré.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

resetAdvertising()

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

Réinitialise la publicité sur l'appareil actuel. Toutes les annonces existantes seront dissociées et arrêtées.

Paramètres

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

sendRequestResponse()

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

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

Paramètres

  • réponse

    Response (Réponse)

    Réponse à la requête.

setAdvertisingInterval()

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

Définit l'intervalle entre deux annonces consécutives. Remarque: Nous faisons de notre mieux pour que cela soit le cas. L'intervalle réel peut varier de manière non triviale par rapport aux intervalles demandés. Sur certains appareils, l'intervalle minimum 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

    Nombre

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

  • maxInterval

    Nombre

    Intervalle maximal entre les annonces (en millisecondes). Cette valeur ne doit pas dépasser 10 240 ms (selon les spécifications).

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

startCharacteristicNotifications()

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

Activez les notifications/indications de valeur 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.

  • du bucket

    NotificationProperties facultatif

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

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

stopCharacteristicNotifications()

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

Désactivez les notifications/indications de valeur de la caractéristique spécifiée. Une fois l'appel réussi, l'application ne reçoit 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 facultatif

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

    () => void

Renvoie

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

unregisterAdvertisement()

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

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

Paramètres

  • advertisementId

    Nombre

    Identifiant de l'annonce à désenregistrer.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

unregisterService()

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

Désenregistrer 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 sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    Identifiant unique d'un service actuellement enregistré.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

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

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

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

  • rappel

    fonction facultatif

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

    () => void

Renvoie

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

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. Ne pas répondre à cette requête pendant une longue période peut entraîner une déconnexion. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • rappel

    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, soit à la suite d'une requête de lecture, soit à la suite d'une notification/indication de modification 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. Ne pas répondre à cette requête pendant une longue période peut entraîner une déconnexion. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • rappel

    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. Ne pas répondre à cette requête pendant une longue période peut entraîner une déconnexion. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • rappel

    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 requête de lecture. Cet événement existe principalement pour des raisons de commodité et est toujours envoyé après un appel réussi à readDescriptorValue.

Paramètres

  • rappel

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

Déclenché lorsqu'un appareil central connecté demande à écrire la valeur d'un descripteur enregistré sur le serveur GATT local. Ne pas répondre à cette requête pendant une longue période peut entraîner une déconnexion. Cet événement n'est disponible que si les autorisations bluetooth:low_energy et bluetooth:peripheral sont définies sur "true" dans l'application. Il est possible que l'autorisation d'accès aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • rappel

    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

  • rappel

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

Paramètres

  • rappel

    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écouvert sur un appareil distant a été supprimé.

Paramètres

  • rappel

    fonction

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

    (service: Service) => void