chrome.bluetoothLowEnergy

Descrizione

L'API chrome.bluetoothLowEnergy viene utilizzata per comunicare con i dispositivi Bluetooth Smart (Low Energy) utilizzando il Generic Attribute Profile (GATT).

Manifest

Per utilizzare questa API, le seguenti chiavi devono essere dichiarate nel file manifest.

"bluetooth"

Tipi

Advertisement

Chrome 47 e versioni successive

Proprietà

  • manufacturerData

    ManufacturerData[] facoltativo

    Elenco di dati specifici del produttore da includere nei campi "Dati specifici del produttore" dei dati pubblicitari.

  • serviceData

    ServiceData[] facoltativo

    Elenco dei dati di servizio da includere nei campi "Dati di servizio" dei dati pubblicitari.

  • serviceUuids

    stringa[] facoltativo

    Elenco di UUID da includere nel campo "UUID di servizio" dei dati pubblicitari. Questi UUID possono essere nei formati 16 bit, 32 bit o 128 bit.

  • solicitUuids

    stringa[] facoltativo

    Elenco di UUID da includere nel campo "Richiedi UUID" dei dati pubblicitari. Questi UUID possono essere nei formati 16 bit, 32 bit o 128 bit.

  • Tipo di pubblicità.

AdvertisementType

Chrome 47 e versioni successive

Tipo di pubblicità. Se viene scelto "broadcast", il tipo di annuncio inviato sarà ADV_NONCONN_IND e il dispositivo trasmetterà con un indirizzo MAC casuale. Se impostato su "peripheral", il tipo di annuncio sarà ADV_IND o ADV_SCAN_IND e il dispositivo trasmetterà con l'indirizzo MAC dell'adattatore Bluetooth reale.

Enum

"broadcast"

"peripheral"

Characteristic

Proprietà

  • instanceId

    stringa facoltativa

    Restituisce l'identificatore assegnato a questa caratteristica. Utilizza l'ID istanza per distinguere le caratteristiche di una periferica con lo stesso UUID e per effettuare chiamate di funzioni che accettano un identificatore di caratteristiche. Presente, se questa istanza rappresenta una caratteristica remota.

  • proprietà

    CharacteristicProperty[]

    Le proprietà di questa caratteristica.

  • servizio

    Servizio facoltativo

    Il servizio GATT a cui appartiene questa caratteristica.

  • UUID

    stringa

    L'UUID della caratteristica, ad esempio 00002a37-0000-1000-8000-00805f9b34fb.

  • valore

    ArrayBuffer facoltativo

    Il valore della caratteristica attualmente memorizzato nella cache. Questo valore viene aggiornato quando il valore della caratteristica viene letto o aggiornato tramite una notifica o un'indicazione.

CharacteristicProperty

Valori che rappresentano le possibili proprietà di una caratteristica. Le autorizzazioni delle caratteristiche vengono dedotte da queste proprietà. Consulta la specifica Bluetooth 4.x per conoscere il significato di ogni singola proprietà.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Proprietà

  • persistente

    booleano

    Indica se una connessione al dispositivo viene lasciata aperta quando viene scaricata la pagina dell'evento dell'applicazione (vedi Gestire il ciclo di vita dell'app). Il valore predefinito è false.

Descriptor

Proprietà

  • caratteristica

    Caratteristica facoltativa

    La caratteristica GATT a cui appartiene questo descrittore.

  • instanceId

    stringa facoltativa

    Restituisce l'identificatore assegnato a questo descrittore. Utilizza l'ID istanza per distinguere i descrittori di una periferica con lo stesso UUID e per effettuare chiamate di funzioni che accettano un identificatore del descrittore. Presente, se questa istanza rappresenta una caratteristica remota.

  • autorizzazioni

    DescriptorPermission[]

    Chrome 52 e versioni successive

    Le autorizzazioni di questo descrittore.

  • UUID

    stringa

    L'UUID del descrittore della caratteristica, ad esempio 00002902-0000-1000-8000-00805f9b34fb.

  • valore

    ArrayBuffer facoltativo

    Il valore del descrittore attualmente memorizzato nella cache. Questo valore viene aggiornato quando viene letto il valore del descrittore.

DescriptorPermission

Chrome 52 e versioni successive

Valori che rappresentano le possibili autorizzazioni per un descrittore. Consulta la specifica Bluetooth 4.x per conoscere il significato di ogni singola autorizzazione.

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 e versioni successive

Proprietà

  • indirizzo

    stringa

    L'indirizzo del dispositivo, nel formato "XX:XX:XX:XX:XX:XX".

  • deviceClass

    number facoltativo

    La classe del dispositivo, un campo di bit definito da http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • nome

    stringa facoltativa

    Il nome leggibile del dispositivo.

ManufacturerData

Chrome 47 e versioni successive

Proprietà

  • dati

    number[]

  • id

    numero

Notification

Chrome 52 e versioni successive

Proprietà

  • shouldIndicate

    booleano facoltativo

    Indicatore facoltativo per l'invio di un'indicazione anziché di una notifica.

  • valore

    ArrayBuffer

    Nuovo valore della caratteristica.

NotificationProperties

Proprietà

  • persistente

    booleano

    Indica se l'app deve ricevere notifiche quando la pagina dell'evento dell'applicazione viene scaricata (vedi Gestire il ciclo di vita dell'app). Il valore predefinito è false.

Request

Chrome 52 e versioni successive

Proprietà

  • dispositivo

    Dispositivo

    Dispositivo che invia questa richiesta.

  • requestId

    numero

    ID univoco per questa richiesta. Utilizza questo ID quando rispondi a questa richiesta.

  • valore

    ArrayBuffer facoltativo

    Valore da scrivere (se si tratta di una richiesta di scrittura).

Response

Chrome 52 e versioni successive

Proprietà

  • isError

    booleano

    Se si tratta di una risposta di errore, questo valore deve essere True.

  • requestId

    numero

    ID della richiesta a cui si riferisce la risposta.

  • valore

    ArrayBuffer facoltativo

    Valore di risposta. Le richieste di scrittura e le risposte agli errori ignoreranno questo parametro.

Service

Proprietà

  • deviceAddress

    stringa facoltativa

    L'indirizzo del dispositivo della periferica remota a cui appartiene il servizio GATT. Presente se questa istanza rappresenta un servizio remoto.

  • instanceId

    stringa facoltativa

    Restituisce l'identificatore assegnato a questo servizio. Utilizza l'ID istanza per distinguere i servizi di una periferica con lo stesso UUID e per effettuare chiamate di funzioni che accettano un identificatore di servizio. Presente se questa istanza rappresenta un servizio remoto.

  • isPrimary

    booleano

    Indica se il tipo di servizio è principale o secondario.

  • UUID

    stringa

    L'UUID del servizio, ad esempio 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 e versioni successive

Proprietà

  • dati

    number[]

  • UUID

    stringa

Metodi

connect()

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

Stabilisce una connessione tra l'applicazione e il dispositivo con l'indirizzo specificato. Un dispositivo potrebbe essere già connesso e i relativi servizi GATT disponibili senza chiamare connect, tuttavia un'app che vuole accedere ai servizi GATT di un dispositivo deve chiamare questa funzione per assicurarsi che la connessione al dispositivo venga mantenuta. Se il dispositivo non è connesso, tutti i servizi GATT del dispositivo verranno rilevati dopo una chiamata riuscita a connect.

Parametri

  • deviceAddress

    stringa

    L'indirizzo Bluetooth del dispositivo remoto a cui deve essere aperta una connessione GATT.

  • proprietà

    ConnectProperties facoltativo

    (Facoltativo) Proprietà di connessione.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

createCharacteristic()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Crea una caratteristica GATT ospitata localmente. Questa caratteristica deve essere ospitata in un servizio valido. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • caratteristica

    Caratteristica

    La caratteristica da creare.

  • serviceId

    stringa

    ID del servizio per cui creare questa caratteristica.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (characteristicId: string) => void

    • characteristicId

      stringa

Resi

  • Promise<string>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

createDescriptor()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Crea un descrittore GATT ospitato localmente. Questo descrittore deve essere ospitato in una caratteristica valida. Se l'ID caratteristica non è valido, verrà impostato lastError. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • descrittore

    Descrittore

    Il descrittore da creare.

  • characteristicId

    stringa

    ID della caratteristica per la quale creare questo descrittore.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (descriptorId: string) => void

    • descriptorId

      stringa

Resi

  • Promise<string>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

createService()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Crea un servizio GATT ospitato localmente. Questo servizio può essere registrato per essere disponibile su un server GATT locale. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • servizio

    Servizio

    Il servizio da creare.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (serviceId: string) => void

    • serviceId

      stringa

Resi

  • Promise<string>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

disconnect()

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

Chiude la connessione dell'app al dispositivo con l'indirizzo specificato. Tieni presente che questo non distrugge sempre il link fisico stesso, poiché potrebbero essere presenti altre app con connessioni aperte.

Parametri

  • deviceAddress

    stringa

    L'indirizzo Bluetooth del dispositivo remoto.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getCharacteristic()

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

Recupera la caratteristica GATT con l'ID istanza specificato che appartiene al servizio GATT specificato, se la caratteristica esiste.

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT richiesta.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promise<Characteristic>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getCharacteristics()

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

Visualizza un elenco di tutte le caratteristiche GATT rilevate che appartengono al servizio specificato.

Parametri

  • serviceId

    stringa

    L'ID istanza del servizio GATT di cui devono essere restituite le caratteristiche.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic[]) => void

Resi

  • Promise<Characteristic[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getDescriptor()

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

Recupera il descrittore della caratteristica GATT con l'ID istanza specificato.

Parametri

  • descriptorId

    stringa

    L'ID istanza del descrittore della caratteristica GATT richiesto.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor) => void

Resi

  • Promise<Descriptor>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getDescriptors()

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

Recupera un elenco di descrittori delle caratteristiche GATT che appartengono alla caratteristica specificata.

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT di cui devono essere restituiti i descrittori.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor[]) => void

Resi

  • Promise<Descriptor[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getIncludedServices()

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

Visualizza un elenco di servizi GATT inclusi dal servizio specificato.

Parametri

  • serviceId

    stringa

    L'ID istanza del servizio GATT di cui devono essere restituiti i servizi inclusi.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service[]) => void

Resi

  • Promise<Service[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getService()

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

Recupera il servizio GATT con l'ID istanza specificato.

Parametri

  • serviceId

    stringa

    L'ID istanza del servizio GATT richiesto.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service) => void

Resi

  • Promise<Service>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getServices()

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

Recupera tutti i servizi GATT rilevati sul dispositivo remoto con l'indirizzo del dispositivo specificato.

Nota:se il rilevamento dei servizi non è ancora stato completato sul dispositivo, questa API restituirà un sottoinsieme (eventualmente vuoto) di servizi. Una soluzione alternativa è aggiungere un ritardo basato sul tempo e/o chiamare ripetutamente fino a quando non viene restituito il numero di servizi previsto.

Parametri

  • deviceAddress

    stringa

    L'indirizzo Bluetooth del dispositivo remoto di cui devono essere restituiti i servizi GATT.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service[]) => void

Resi

  • Promise<Service[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

notifyCharacteristicValueChanged()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Invia una notifica a un dispositivo remoto di un nuovo valore per una caratteristica. Se il flag shouldIndicate nell'oggetto della notifica è true, verrà inviata un'indicazione anziché una notifica. Tieni presente che, per la riuscita di questa chiamata, la caratteristica deve impostare correttamente la proprietà "notify" o "indicate" durante la creazione. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • characteristicId

    stringa

    La caratteristica per cui inviare la notifica.

  • notifica

    Notifica

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

readCharacteristicValue()

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

Recupera il valore di una caratteristica specificata da una periferica remota.

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT di cui deve essere letto il valore dal dispositivo remoto.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promise<Characteristic>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

readDescriptorValue()

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

Recupera il valore di un descrittore di caratteristiche specificato da una periferica remota.

Parametri

  • descriptorId

    stringa

    L'ID istanza del descrittore della caratteristica GATT di cui deve essere letto il valore dal dispositivo remoto.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor) => void

Resi

  • Promise<Descriptor>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

registerAdvertisement()

Promessa Chrome 47 e versioni successive 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Creare un annuncio e registrarlo per la pubblicità. Per chiamare questa funzione, l'app deve avere le autorizzazioni bluetooth:low_energy e bluetooth:peripheral impostate su true. Inoltre, questa API è disponibile solo per le app con avvio automatico in modalità Kiosk o impostando l'opzione a riga di comando "--enable-ble-advertising-in-apps". Consulta la pagina https://developer.chrome.com/apps/manifest/bluetooth. Nota: su alcuni hardware sono supportate contemporaneamente le modalità centrale e periferica, ma su hardware che non le supporta, questa chiamata imposterà il dispositivo in modalità periferica. Nel caso di hardware che non supporta sia la modalità centrale che quella periferica, il tentativo di utilizzare il dispositivo in entrambe le modalità comporterà un comportamento non definito o impedirà ad altre applicazioni con ruolo centrale di funzionare correttamente (inclusa la rilevazione dei dispositivi Bluetooth Low Energy).

Parametri

  • pubblicità

    Annunci

    La pubblicità da pubblicizzare.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (advertisementId: number) => void

    • advertisementId

      numero

Resi

  • Promise<number>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

registerService()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Registra il servizio specificato con il server GATT locale. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • serviceId

    stringa

    ID univoco di un servizio creato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeService()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Rimuovi il servizio specificato, annullandone la registrazione se è stato registrato. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • serviceId

    stringa

    ID univoco di un servizio attualmente registrato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

resetAdvertising()

Promessa Chrome 61 e versioni successive 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Reimposta la pubblicità sul dispositivo attuale. Verranno annullate la registrazione e l'interruzione di tutti gli annunci esistenti.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

sendRequestResponse()

Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Invia una risposta per una richiesta di lettura/scrittura di una caratteristica o di un descrittore. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • risposta

    Risposta

    La risposta alla richiesta.

setAdvertisingInterval()

Promessa Chrome 55 e versioni successive 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Imposta l'intervallo tra due annunci consecutivi. Nota: si tratta di un impegno massimo. L'intervallo effettivo potrebbe variare in modo non banale rispetto agli intervalli richiesti. Su alcuni hardware è presente un intervallo minimo di 100 ms. I valori minimo e massimo non possono superare l'intervallo consentito dalla specifica Bluetooth 4.2.

Parametri

  • minInterval

    numero

    Intervallo minimo tra gli annunci (in millisecondi). Non può essere inferiore a 20 ms (come da specifiche).

  • maxInterval

    numero

    Intervallo massimo tra gli annunci (in millisecondi). Non deve superare i 10240 ms (come da specifiche).

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

startCharacteristicNotifications()

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

Attiva le notifiche/indicazioni dei valori della caratteristica specificata. Una volta attivata, un'applicazione può ascoltare le notifiche utilizzando l'evento onCharacteristicValueChanged.

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT su cui devono essere attivate le notifiche.

  • proprietà

    NotificationProperties facoltativo

    (Facoltativo) Proprietà della sessione di notifica.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

stopCharacteristicNotifications()

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

Disattiva le notifiche/indicazioni dei valori della caratteristica specificata. Dopo una chiamata andata a buon fine, l'applicazione smetterà di ricevere notifiche/indicazioni da questa caratteristica.

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT su cui deve essere interrotta la sessione di notifica di questa app.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

unregisterAdvertisement()

Promessa Chrome 47 e versioni successive 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Annullare la registrazione di un annuncio e interrompere la relativa pubblicità. Se la registrazione della pubblicità non va a buon fine, l'unico modo per interrompere la pubblicità potrebbe essere riavviare il dispositivo.

Parametri

  • advertisementId

    numero

    ID della pubblicità da annullare.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

unregisterService()

Promessa Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Annullare la registrazione del servizio specificato con il server GATT locale. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile solo se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • serviceId

    stringa

    ID univoco di un servizio attualmente registrato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

writeCharacteristicValue()

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

Scrivere il valore di una caratteristica specificata da una periferica remota.

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT di cui deve essere scritto il valore.

  • valore

    ArrayBuffer

    Il valore da inviare alla caratteristica remota nell'ambito della richiesta di scrittura.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

writeDescriptorValue()

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

Scrive il valore di un descrittore di caratteristiche specificato da una periferica remota.

Parametri

  • descriptorId

    stringa

    L'ID istanza del descrittore della caratteristica GATT di cui deve essere scritto il valore.

  • valore

    ArrayBuffer

    Il valore da inviare al descrittore remoto nell'ambito della richiesta di scrittura.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onCharacteristicReadRequest

Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Viene attivato quando un dispositivo centrale connesso richiede di leggere il valore di una caratteristica registrata sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, la connessione potrebbe essere interrotta. Questo evento è disponibile solo se l'app ha le autorizzazioni bluetooth:low_energy e bluetooth:peripheral impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • richiesta

      Richiedi

    • characteristicId

      stringa

onCharacteristicValueChanged

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

Viene attivato quando il valore di una caratteristica GATT remota cambia, a seguito di una richiesta di lettura o di una notifica/indicazione di modifica del valore. Questo evento verrà inviato solo se l'app ha attivato le notifiche chiamando startCharacteristicNotifications.

Parametri

onCharacteristicWriteRequest

Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Viene attivato quando un dispositivo centrale connesso richiede di scrivere il valore di una caratteristica registrata sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, la connessione potrebbe essere interrotta. Questo evento è disponibile solo se l'app ha le autorizzazioni bluetooth:low_energy e bluetooth:peripheral impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • richiesta

      Richiedi

    • characteristicId

      stringa

onDescriptorReadRequest

Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Viene attivato quando un dispositivo centrale connesso richiede di leggere il valore di un descrittore registrato sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, la connessione potrebbe essere interrotta. Questo evento è disponibile solo se l'app ha le autorizzazioni bluetooth:low_energy e bluetooth:peripheral impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • richiesta

      Richiedi

    • descriptorId

      stringa

onDescriptorValueChanged

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

Viene attivato quando il valore di un descrittore della caratteristica GATT remota cambia, in genere a seguito di una richiesta di lettura. Questo evento esiste principalmente per praticità e verrà sempre inviato dopo una chiamata riuscita a readDescriptorValue.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 e versioni successive 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Viene attivato quando un dispositivo centrale connesso richiede di scrivere il valore di un descrittore registrato sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, la connessione potrebbe essere interrotta. Questo evento è disponibile solo se l'app ha le autorizzazioni bluetooth:low_energy e bluetooth:peripheral impostate su true. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • richiesta

      Richiedi

    • descriptorId

      stringa

onServiceAdded

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

Viene attivato quando viene rilevato un nuovo servizio GATT su un dispositivo remoto.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (service: Service) => void

onServiceChanged

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

Viene attivato quando cambia lo stato di un servizio GATT remoto. Sono incluse tutte le caratteristiche e/o i descrittori aggiunti o rimossi dal servizio, nonché le notifiche "ServiceChanged" dal dispositivo remoto.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (service: Service) => void

onServiceRemoved

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

Viene attivato quando un servizio GATT precedentemente rilevato su un dispositivo remoto è stato rimosso.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (service: Service) => void