chrome.bluetoothLowEnergy

Description

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

Fichier manifeste

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

"bluetooth"

Types

Advertisement

Chrome (version 47 ou ultérieure)

Propriétés

  • manufacturerData

    ManufacturerData[] facultatif

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

  • serviceData

    ServiceData[] facultatif

    Liste des données de service à inclure dans la section "Données des services" des données publicitaires.

  • serviceUuids

    string[] facultatif

    Liste des UUID à inclure dans "UUID de service" des Données publicitaires. Ces UUID peuvent être aux formats 16, 32 bits ou 128.

  • solicitUuids

    string[] facultatif

    Liste des UUID à inclure dans le champ "UUID Sollicit" des Données publicitaires. Ces UUID peuvent être aux formats 16, 32 bits ou 128.

  • Type de publicité.

AdvertisementType

Chrome (version 47 ou ultérieure)

Type de publicité. Si "diffusion" est choisi, le type d'annonce envoyée 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éelle.

Énumération

"diffusion"

"périphérique"

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

Énumération

"diffusion"

"lecture"

"writeWithoutResponse"

"write"

"notify"

"indiquer"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriétés

  • SSD

    booléen

    Indique si une connexion à l'appareil est laissée ouverte lorsque la page d'événements de l'application est déchargée (voir Gérer le cycle de vie d'une 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 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 (version 52 ou ultérieure)

    Autorisations associées à ce descripteur.

  • uuid

    chaîne

    L'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 (version 52 ou ultérieure)

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

Énumération

"lecture"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome (version 52 ou ultérieure)

Propriétés

  • adresse

    chaîne

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

  • deviceClass

    numéro facultatif

    La classe de l'appareil, un 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 (version 47 ou ultérieure)

Propriétés

  • données

    numéro[]

  • id

    Nombre

Notification

Chrome (version 52 ou 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

    booléen

    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 de l'application). La valeur par défaut est false.

Request

Chrome (version 52 ou ultérieure)

Propriétés

  • appareil

    Appareil

    Appareil qui envoie cette demande.

  • requestId

    Nombre

    Identifiant unique pour cette demande. 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 (version 52 ou ultérieure)

Propriétés

  • isError

    booléen

    S'il s'agit d'une réponse d'erreur, ce champ doit être défini sur "true".

  • requestId

    Nombre

    Identifiant de la requête à laquelle il s'agit.

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

    Affiche 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

    booléen

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

  • uuid

    chaîne

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

ServiceData

Chrome (version 47 ou ultérieure)

Propriétés

  • données

    numéro[]

  • uuid

    chaîne

Méthodes

connect()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Établit une connexion entre l'application et l'appareil associé à l'adresse indiqué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 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 sur lequel une connexion GATT doit être ouverte.

  • du bucket

    ConnectProperties facultatif

    Propriétés de connexion (facultatif).

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Créer une caractéristique GATT hébergée localement Cette caractéristique doit être hébergée sur un service valide. Si l'ID du service 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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • caractéristique

    Caractéristiques

    Caractéristique à créer.

  • ID du service

    chaîne

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

  • rappel

    function facultatif

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

    (characteristicId: string) => void

    • characteristicId

      chaîne

Renvoie

  • Promise&lt;string&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Créer un descripteur GATT hébergé localement Ce descripteur doit être hébergé sous une caractéristique valide. Si l'identifiant 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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • descripteur

    Descripteur

    Descripteur à créer.

  • characteristicId

    chaîne

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

  • rappel

    function facultatif

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

    (descriptorId: string) => void

    • descriptorId

      chaîne

Renvoie

  • Promise&lt;string&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • service

    Service

    Service à créer.

  • rappel

    function facultatif

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

    (serviceId: string) => void

    • ID du service

      chaîne

Renvoie

  • Promise&lt;string&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Ferme la connexion de l'application à l'appareil associé à l'adresse indiquée. Notez que cela ne détruira 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

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Obtenez 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

    function facultatif

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

    (result: Characteristic) => void

Renvoie

  • Promesse<caractéristique>

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

<ph type="x-smartling-placeholder"></ph> 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

    function facultatif

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

    (result: Characteristic[]) => void

Renvoie

  • Promesse<caractéristique[]>

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Permet d'obtenir 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

    function facultatif

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

    (result: Descriptor) => void

Renvoie

  • Promise&lt;Descriptor&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

Permet d'obtenir la liste des descripteurs de caractéristiques GATT associés à une 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

    function facultatif

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

    (result: Descriptor[]) => void

Renvoie

  • Promise&lt;Descriptor[]&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Permet d'obtenir 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

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

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

Paramètres

  • ID du service

    chaîne

    ID d'instance du service GATT demandé.

  • rappel

    function facultatif

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

    (result: Service) => void

Renvoie

  • Promise&lt;Service&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Récupérer tous les services GATT détectés sur l'appareil distant avec l'adresse de l'appareil donné

Remarque:Si la détection de services n'est pas encore terminée sur l'appareil, cette API renvoie un sous-ensemble (peut-être vide) de services. Pour contourner ce problème, vous pouvez ajouter un délai basé sur l'heure et/ou effectuer un appel répété 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

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Informer un appareil distant de la nouvelle valeur d'une caractéristique. Si l'indicateur doitIndicate dans l'objet de notification est défini sur "true", une indication est envoyée à la place d'une notification. Notez que la caractéristique doit être correctement définie sur l'attribut 'notify' ou "indiquer" 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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • characteristicId

    chaîne

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

  • notification

    Notification

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> 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

    function facultatif

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

    (result: Characteristic) => void

Renvoie

  • Promesse<caractéristique>

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

<ph type="x-smartling-placeholder"></ph> 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 la caractéristique GATT dont la valeur doit être lue à partir de l'appareil distant.

  • rappel

    function facultatif

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

    (result: Descriptor) => void

Renvoie

  • Promise&lt;Descriptor&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 47 ou ultérieure) 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Créez une publicité et enregistrez-la. 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 si vous définissez l'option "--enable-ble-advertising-in-apps". un commutateur de ligne de commande. Consultez la page https://developer.chrome.com/apps/manifest/bluetooth. Remarque: Sur certains appareils, les modes central et périphérique sont pris en charge simultanément. Sur le matériel qui ne le prend pas en charge, cet appel fait passer l'appareil en mode périphérique. Dans le cas d'un matériel qui n'est pas compatible à la fois en mode central et périphérique, toute tentative d'utilisation de l'appareil dans les deux modes entraînera un comportement non défini ou empêchera les autres applications du rôle central de se comporter correctement (y compris la découverte d'appareils Bluetooth à basse consommation).

Paramètres

  • publicité

    Publicité

    Publicité à promouvoir.

  • rappel

    function facultatif

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

    (advertisementId: number) => void

    • advertisementId

      Nombre

Renvoie

  • Promise&lt;number&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

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

Paramètres

  • ID du service

    chaîne

    ID unique d'un service créé.

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Supprimer le service spécifié et annuler son enregistrement s'il était déjà enregistré Si l'ID du service 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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    ID unique d'un service enregistré actuellement.

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 61 ou ultérieure) 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

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

Paramètres

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<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 (version 52 ou 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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • réponse

    Réponse

    Réponse à la requête.

setAdvertisingInterval()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 55 ou ultérieure) 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Set est l'intervalle entre deux annonces consécutives. Remarque: Nous nous efforçons d'y parvenir dans la mesure du possible. L'intervalle réel peut être très différent des intervalles demandés. Sur certains matériels, 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

    Nombre

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

  • maxInterval

    Nombre

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

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

Active les notifications/indications de valeur pour 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 pour laquelle les notifications doivent être activées.

  • du bucket

    NotificationProperties facultatif

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

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Désactiver les notifications/indications de valeur pour la caractéristique spécifiée. Après un appel réussi, l'application cessera de recevoir des notifications/indications de cette caractéristique.

Paramètres

  • characteristicId

    chaîne

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

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 47 ou ultérieure) 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Annule l'enregistrement d'une publicité et arrête sa diffusion. Si l'annulation de l'enregistrement de l'annonce échoue, le seul moyen d'arrêter de diffuser des annonces est de redémarrer l'appareil.

Paramètres

  • advertisementId

    Nombre

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

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Annulez l'enregistrement du service donné auprès du serveur GATT local. Si l'ID du service 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 aux périphériques ne soit pas disponible pour toutes les applications.

Paramètres

  • ID du service

    chaîne

    ID unique d'un service enregistré actuellement.

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

Paramètres

  • characteristicId

    chaîne

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

  • valeur

    ArrayBuffer

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

  • rappel

    function facultatif

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

    () => void

Renvoie

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

<ph type="x-smartling-placeholder"></ph> 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 dans lequel la valeur doit être écrite.

  • valeur

    ArrayBuffer

    Valeur devant être envoyée au descripteur distant dans la requête d'écriture.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<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 (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande la lecture de la valeur d'une caractéristique enregistrée sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant un long moment, 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 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 changement de valeur. Cet événement n'est envoyé que si l'application a activé les notifications en appelant startCharacteristicNotifications.

Paramètres

onCharacteristicWriteRequest

Chrome (version 52 ou 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 un long moment, 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 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 (version 52 ou ultérieure) 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Déclenché lorsqu'un appareil central connecté demande la lecture de la valeur d'un descripteur enregistré sur le serveur GATT local. Si vous ne répondez pas à cette demande pendant un long moment, 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 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 a pour but principalement de vous simplifier la vie et sera 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 (version 52 ou 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 un long moment, 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 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é parce qu'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 est modifié. Cela concerne toutes les caractéristiques et/ou tous les descripteurs qui sont ajoutés ou supprimés du service, ainsi que "ServiceChanged". notifications 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