chrome.bluetoothLowEnergy

Descrizione

L'API chrome.bluetoothLowEnergy viene utilizzata per comunicare con i dispositivi Bluetooth Smart (Low Energy) utilizzando il profilo attributo generico (GATT).

Manifest

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

"bluetooth"

Tipi

Advertisement

Chrome 47+

Proprietà

  • manufacturerData

    ManufacturerData[] facoltativo

    Elenco dei 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

    string[] facoltativo

    Elenco degli UUID da includere nel campo "UUID dei servizi" dei dati pubblicitari. Questi UUID possono essere in formato a 16 bit, 32 bit o 128 bit.

  • solicitUuids

    string[] facoltativo

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

  • Tipo di pubblicità.

AdvertisementType

Chrome 47+

Tipo di pubblicità. Se viene scelta l'opzione "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"

"periferica"

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 funzione che accettano un identificatore di caratteristica. 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

    Flag che indica se una connessione al dispositivo viene lasciata aperta quando la pagina dell'evento dell'applicazione viene scaricata (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 ed effettuare chiamate di funzione che accettano un identificatore di descrittore. Presente, se questa istanza rappresenta una caratteristica remota.

  • autorizzazioni

    DescriptorPermission[]

    Chrome 52 o 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 o versioni successive

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

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 o 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+

Proprietà

  • dati

    number[]

  • id

    numero

Notification

Chrome 52 o versioni successive

Proprietà

  • shouldIndicate

    booleano facoltativo

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

  • valore

    ArrayBuffer

    Il nuovo valore della caratteristica.

NotificationProperties

Proprietà

  • persistente

    booleano

    Flag che 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 o versioni successive

Proprietà

  • dispositivo

    Dispositivo

    Il dispositivo che ha inviato 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 o 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 questa risposta.

  • valore

    ArrayBuffer facoltativo

    Valore di risposta. Le richieste di scrittura e le risposte di errore 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 ed 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 questo servizio è principale o secondario.

  • uuid

    stringa

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

ServiceData

Chrome 47+

Proprietà

  • dati

    number[]

  • uuid

    stringa

Metodi

connect()

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

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

    Proprietà di connessione (facoltative).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

createCharacteristic()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

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 per l'app sono impostate su true le autorizzazioni bluetooth:low_energy e bluetooth:peripheral. 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (characteristicId: string) => void

    • characteristicId

      stringa

Resi

  • Promise<string>

    Chrome 91+

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

createDescriptor()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

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 per l'app sono impostate su true le autorizzazioni bluetooth:low_energy e bluetooth:peripheral. L'autorizzazione per le periferiche potrebbe non essere disponibile per tutte le app.

Parametri

  • descrittore

    Descriptor

    Il descrittore da creare.

  • characteristicId

    stringa

    ID della caratteristica per cui creare questo descrittore.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (descriptorId: string) => void

    • descriptorId

      stringa

Resi

  • Promise<string>

    Chrome 91+

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

createService()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

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

Parametri

  • servizio

    Servizio

    Il servizio da creare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (serviceId: string) => void

    • serviceId

      stringa

Resi

  • Promise<string>

    Chrome 91+

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

disconnect()

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

Chiude la connessione dell'app al dispositivo con l'indirizzo specificato. Tieni presente che questo non distruggerà sempre il collegamento fisico stesso, poiché potrebbero esserci altre app con connessioni aperte.

Parametri

  • deviceAddress

    stringa

    L'indirizzo Bluetooth del dispositivo remoto.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

getCharacteristic()

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

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

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT richiesta.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promise<Characteristic>

    Chrome 91+

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

getCharacteristics()

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

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

Parametri

  • serviceId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic[]) => void

Resi

  • Promise<Characteristic[]>

    Chrome 91+

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

getDescriptor()

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

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

Parametri

  • descriptorId

    stringa

    L'ID istanza del descrittore della caratteristica GATT richiesto.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor) => void

Resi

  • Promise<Descriptor>

    Chrome 91+

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

getDescriptors()

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

Ottieni un elenco di descrittori delle caratteristiche GATT appartenenti alla caratteristica specificata.

Parametri

  • characteristicId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor[]) => void

Resi

  • Promise<Descriptor[]>

    Chrome 91+

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

getIncludedServices()

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

Visualizza un elenco dei servizi GATT inclusi nel servizio specificato.

Parametri

  • serviceId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service[]) => void

Resi

  • Promise<Service[]>

    Chrome 91+

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

getService()

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

Recupera il servizio GATT con l'ID istanza specificato.

Parametri

  • serviceId

    stringa

    L'ID istanza del servizio GATT richiesto.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service) => void

Resi

  • Promise<Service>

    Chrome 91+

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

getServices()

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

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

Nota:se il rilevamento dei servizi non è ancora completato sul dispositivo, questa API restituirà un sottoinsieme (possibilmente vuoto) di servizi. Una soluzione alternativa consiste nell'aggiungere un ritardo basato sul tempo e/o chiamare ripetutamente finché non viene restituito il numero previsto di servizi.

Parametri

  • deviceAddress

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service[]) => void

Resi

  • Promise<Service[]>

    Chrome 91+

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

notifyCharacteristicValueChanged()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Notifica a un dispositivo remoto un nuovo valore per una caratteristica. Se il flag shouldIndicate nell'oggetto di notifica è true, verrà inviata un'indicazione anziché una notifica. Tieni presente che la caratteristica deve impostare correttamente la proprietà "notify" o "indicate" durante la creazione affinché questa chiamata vada a buon fine. Questa funzione è disponibile solo se per l'app sono impostate su true le autorizzazioni bluetooth:low_energy e bluetooth:peripheral. 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

readCharacteristicValue()

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

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

Parametri

  • characteristicId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promise<Characteristic>

    Chrome 91+

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

readDescriptorValue()

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

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

Parametri

  • descriptorId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor) => void

Resi

  • Promise<Descriptor>

    Chrome 91+

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

registerAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Crea una pubblicità e registrala 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 avviate automaticamente in modalità Kiosk o impostando l'opzione della riga di comando "--enable-ble-advertising-in-apps". Consulta la pagina https://developer.chrome.com/apps/manifest/bluetooth. Nota: su alcuni hardware, le modalità centrale e periferica sono supportate contemporaneamente, ma su hardware che non le supporta, questa chiamata attiverà la modalità periferica sul dispositivo. Nel caso di hardware che non supporta la modalità centrale e periferica, il tentativo di utilizzare il dispositivo in entrambe le modalità comporterà un comportamento indefinito o impedirà ad altre applicazioni con ruolo centrale di funzionare correttamente (incluso il rilevamento di dispositivi Bluetooth Low Energy).

Parametri

  • pubblicità

    Pubblicità

    La pubblicità da pubblicizzare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (advertisementId: number) => void

    • advertisementId

      numero

Resi

  • Promise<number>

    Chrome 91+

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

registerService()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Parametri

  • serviceId

    stringa

    ID univoco di un servizio creato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

removeService()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Parametri

  • serviceId

    stringa

    ID univoco di un servizio registrato corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

resetAdvertising()

Promise Chrome 61+ 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

Reimposta la pubblicità sul dispositivo attuale. Verrà annullata la registrazione e verranno interrotte tutte le pubblicità esistenti.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

sendRequestResponse()

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

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

Parametri

  • risposta

    Risposta

    La risposta alla richiesta.

setAdvertisingInterval()

Promessa Chrome 55+ 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

Imposta l'intervallo tra due annunci consecutivi. Nota: questo è un tentativo. L'intervallo effettivo può variare in modo non banale rispetto agli intervalli richiesti. Su alcuni hardware, è previsto 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 le pubblicità (in millisecondi). Non può essere inferiore a 20 ms (come da specifica).

  • maxInterval

    numero

    Intervallo massimo tra le pubblicità (in millisecondi). Non può superare i 10240 ms (come da specifica).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

startCharacteristicNotifications()

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

Attiva le notifiche/indicazioni di valore dalla caratteristica specificata. Una volta attivata, un'applicazione può ascoltare le notifiche utilizzando l'evento onCharacteristicValueChanged.

Parametri

  • characteristicId

    stringa

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

  • proprietà

    NotificationProperties facoltativo

    Proprietà della sessione di notifica (facoltative).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

stopCharacteristicNotifications()

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

Disattiva le notifiche/indicazioni di valore dalla caratteristica specificata. Dopo una chiamata riuscita, 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

unregisterAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

Annulla la registrazione di una pubblicità e ne interrompe la pubblicazione. Se la registrazione dell'annuncio 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 la registrazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

unregisterService()

Promessa Chrome 52+ 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Parametri

  • serviceId

    stringa

    ID univoco di un servizio registrato corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

writeCharacteristicValue()

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

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

Parametri

  • characteristicId

    stringa

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

  • valore

    ArrayBuffer

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

writeDescriptorValue()

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

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

Parametri

  • descriptorId

    stringa

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

  • valore

    ArrayBuffer

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

Eventi

onCharacteristicReadRequest

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

Attivato quando un dispositivo centrale connesso richiede di leggere il valore di una caratteristica registrata sul server GATT locale. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. 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,
)

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 viene inviato solo se l'app ha attivato le notifiche chiamando startCharacteristicNotifications.

Parametri

onCharacteristicWriteRequest

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

Attivato quando un dispositivo centrale connesso richiede di scrivere il valore di una caratteristica registrata sul server GATT locale. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. 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 o versioni successive 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Attivato quando un dispositivo centrale connesso richiede di leggere il valore di un descrittore registrato sul server GATT locale. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. 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,
)

Attivato quando il valore di un descrittore di caratteristica GATT remoto cambia, di solito a seguito di una richiesta di lettura. Questo evento esiste principalmente per comodità 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 o versioni successive 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Attivato quando un dispositivo centrale connesso richiede di scrivere il valore di un descrittore registrato sul server GATT locale. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. 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,
)

Attivato quando è stato 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,
)

Attivato quando lo stato di un servizio GATT remoto cambia. Ciò include qualsiasi caratteristica e/o descrittore aggiunto o rimosso 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,
)

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