chrome.bluetoothLowEnergy

Descrizione

L'API chrome.bluetoothLowEnergy viene utilizzata per comunicare con i dispositivi Bluetooth Smart (Low Energy) tramite il Profilo Attributi Generico (GATT).

Manifest

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

"bluetooth"

Tipi

Advertisement

Chrome 47 e versioni successive

Proprietà

  • manufacturerData

    Facoltativo ManufacturerData[]

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

  • serviceData

    ServiceData[] facoltativo

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

  • serviceUuids

    string[] facoltativo

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

  • solicitUuids

    string[] facoltativo

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

  • Tipo di pubblicità.

AdvertisementType

Chrome 47 e versioni successive

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

Enum

Characteristic

Proprietà

  • instanceId

    stringa facoltativo

    Restituisce l'identificatore assegnato a questa caratteristica. Utilizza l'ID istanza per distinguere tra le caratteristiche di una periferica con lo stesso UUID ed effettuare chiamate di funzione che contengono un identificatore della 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 es. 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 relative alle caratteristiche vengono dedotte da queste proprietà. Controlla le specifiche Bluetooth 4.x per controllare il significato di ogni singola proprietà.

Enum

"writeWithoutResponse"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Proprietà

  • permanente

    boolean

    Flag che indica se una connessione al dispositivo rimane aperta quando viene scaricata la pagina dell'evento dell'applicazione (vedi Gestione del ciclo di vita dell'app). Il valore predefinito è false.

Descriptor

Proprietà

  • caratteristica

    Caratteristica facoltativa

    La caratteristica GATT a cui appartiene questo descrittore.

  • instanceId

    stringa facoltativo

    Restituisce l'identificatore assegnato al descrittore. Utilizza l'ID istanza per distinguere tra descrittori da una periferica con lo stesso UUID ed effettuare chiamate a funzione che accettano un identificatore 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 caratteristico, 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. Leggi le specifiche Bluetooth 4.x per conoscere il significato di ogni singola autorizzazione.

Enum

Device

Chrome 52 e versioni successive

Proprietà

  • indirizzo

    stringa

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

  • deviceClass

    numero facoltativo

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

  • nome

    stringa facoltativo

    Il nome leggibile del dispositivo.

ManufacturerData

Chrome 47 e versioni successive

Proprietà

  • dati

    numero[]

  • id

    numero

Notification

Chrome 52 e versioni successive

Proprietà

  • shouldIndicate

    booleano facoltativo

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

  • valore

    ArrayBuffer

    Nuovo valore della caratteristica.

NotificationProperties

Proprietà

  • permanente

    boolean

    Flag che indica se l'app deve ricevere notifiche quando la pagina dell'evento dell'applicazione viene scaricata (vedi Gestione del ciclo di vita delle 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

    boolean

    Se si tratta di una risposta di errore, dovrebbe essere vero.

  • requestId

    numero

    ID della richiesta a cui è una risposta.

  • valore

    ArrayBuffer facoltativo

    Valore della risposta. Le richieste di scrittura e le risposte di errore ignoreranno questo parametro.

Service

Proprietà

  • deviceAddress

    stringa facoltativo

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

  • instanceId

    stringa facoltativo

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

  • isPrimary

    boolean

    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 e versioni successive

Proprietà

  • dati

    numero[]

  • 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 dovrebbe 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 a connect riuscita.

Parametri

  • deviceAddress

    stringa

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

  • proprietà

    ConnectProperties facoltativo

    Proprietà di connessione (facoltativo).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

createCharacteristic()

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

Creare una caratteristica GATT ospitata localmente. Questa caratteristica deve essere ospitata su un servizio valido. Se l'ID servizio non è valido, verrà impostato il valore lastError. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (characteristicId: string)=>void

    • characteristicId

      stringa

Ritorni

  • Promessa<string>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 sotto una caratteristica valida. Se l'ID caratteristica non è valido, verrà impostato il valore lastError. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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 cui creare questo descrittore.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (descriptorId: string)=>void

    • descriptorId

      stringa

Ritorni

  • Promessa<string>

    Chrome 91 e versioni successive

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

createService()

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

Creare un servizio GATT in hosting locale. Questo servizio può essere registrato per essere disponibile su un server GATT locale. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (serviceId: string)=>void

    • serviceId

      stringa

Ritorni

  • Promessa<string>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 fornito. Tieni presente che ciò non sempre eliminerà 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

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

getCharacteristic()

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

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

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT richiesta.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic)=>void

Ritorni

  • Promise<Characteristic>

    Chrome 91 e versioni successive

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

getCharacteristics()

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

Recupera 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic[])=>void

Ritorni

  • Promise<Characteristic[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor)=>void

Ritorni

  • Promise<Descriptor>

    Chrome 91 e versioni successive

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

getDescriptors()

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

Ottieni 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor[])=>void

Ritorni

  • Promise<Descriptor[]>

    Chrome 91 e versioni successive

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

getIncludedServices()

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

Recupera un elenco dei servizi GATT inclusi dal servizio in questione.

Parametri

  • serviceId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service[])=>void

Ritorni

  • Promessa<Servizio[]>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service)=>void

Ritorni

  • Promessa<Servizio>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 completo sul dispositivo, questa API restituirà un sottoinsieme (possibilmente vuoto) di servizi. Una soluzione consiste nell'aggiungere un ritardo basato sul tempo e/o una chiamata ripetuta fino a quando non viene restituito il numero previsto di servizi.

Parametri

  • deviceAddress

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Service[])=>void

Ritorni

  • Promessa<Servizio[]>

    Chrome 91 e versioni successive

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

notifyCharacteristicValueChanged()

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

Notifica il nuovo valore di una caratteristica a un dispositivo remoto. Se il flag dovrebbeIndicate nell'oggetto notifica è true, verrà inviata un'indicazione anziché una notifica. Tieni presente che, per completare la chiamata, durante la creazione della caratteristica deve essere impostata correttamente la proprietà "notify" o "indicate". Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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 l'avviso.

  • notifica

    Notifica

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 il cui valore deve essere letto dal dispositivo remoto.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic)=>void

Ritorni

  • Promise<Characteristic>

    Chrome 91 e versioni successive

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

readDescriptorValue()

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

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

Ritorni

  • Promise<Descriptor>

    Chrome 91 e versioni successive

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

registerAdvertisement()

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

Crea una pubblicità e registrala per la pubblicità. Per chiamare questa funzione, l'app deve avere le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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". Vedi https://developer.chrome.com/apps/manifest/bluetooth Nota: su alcuni componenti hardware, contemporaneamente sono supportate modalità centrale e periferica, ma su hardware che non supporta questa funzionalità, il dispositivo passerà alla modalità periferica. Nel caso di hardware che non supporta sia la modalità centrale sia quella periferica, il tentativo di utilizzare il dispositivo in entrambe le modalità causerà un comportamento indefinito o impedirà il comportamento corretto di altre applicazioni con ruolo centrale (incluso il rilevamento di dispositivi Bluetooth Low Energy).

Parametri

  • pubblicità

    Pubblicità

    L'annuncio da pubblicizzare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (advertisementId: number)=>void

    • advertisementId

      numero

Ritorni

  • Promessa<numero>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 il valore lastError. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

removeService()

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

Rimuovere il servizio specificato, annullando la relativa registrazione. Se l'ID servizio non è valido, verrà impostato il valore lastError. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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 registrato corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

resetAdvertising()

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

Reimposta la pubblicità sul dispositivo attuale. Verrà annullata la registrazione e verranno interrotti tutti gli annunci esistenti.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 caratteristica o descrittore. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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: questa è la soluzione migliore. L'intervallo effettivo può variare in modo non banale dagli intervalli richiesti. Su alcuni componenti hardware, esiste 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 (secondo le specifiche).

  • maxInterval

    numero

    Intervallo massimo tra gli annunci (in millisecondi). Non può superare i 10.240 ms (secondo le specifiche).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

startCharacteristicNotifications()

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

Attiva notifiche/indicazioni sul valore della caratteristica specificata. Una volta attivato, un'applicazione può ascoltare le notifiche utilizzando l'evento onCharacteristicValueChanged.

Parametri

  • characteristicId

    stringa

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

  • proprietà

    NotificationProperties facoltativo

    Proprietà della sessione di notifica (facoltativo).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

stopCharacteristicNotifications()

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

Disattiva notifiche/indicazioni sul 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

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

unregisterAdvertisement()

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

Consente di annullare la registrazione di un annuncio e di interromperne la pubblicazione. Se la registrazione dell'annuncio non riesce, l'unico modo per interrompere la pubblicità potrebbe essere riavviare il dispositivo.

Parametri

  • advertisementId

    numero

    ID della pubblicità di cui annullare la registrazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

unregisterService()

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

Annulla la registrazione del servizio specificato con il server GATT locale. Se l'ID servizio non è valido, verrà impostato il valore lastError. Questa funzione è disponibile soltanto se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral 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 registrato corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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 scrivere il valore.

  • valore

    ArrayBuffer

    Il valore che deve essere inviato alla caratteristica remota nell'ambito della richiesta di scrittura.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

writeDescriptorValue()

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

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

Parametri

  • descriptorId

    stringa

    L'ID istanza del descrittore della caratteristica GATT di cui scrivere il valore.

  • valore

    ArrayBuffer

    Il valore che deve essere inviato al descrittore remoto nell'ambito della richiesta di scrittura.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 91 e versioni successive

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

Eventi

onCharacteristicReadRequest

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

Attivato quando un dispositivo centrale connesso richiede la lettura del valore di una caratteristica registrata sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, potresti disconnetterti. Questo evento è disponibile solo se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral sono 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, in seguito a una richiesta di lettura o a una notifica/indicazione di modifica del valore. Questo evento viene inviato solo se l'app ha attivato le notifiche chiamando il numero startCharacteristicNotifications.

Parametri

onCharacteristicWriteRequest

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

Attivato quando un dispositivo centrale connesso richiede la scrittura del valore di una caratteristica registrata sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, potresti disconnetterti. Questo evento è disponibile solo se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral sono 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,
)

Attivato quando un dispositivo centrale connesso richiede la lettura del valore di un descrittore registrato sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, potresti disconnetterti. Questo evento è disponibile solo se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral sono 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, solitamente in seguito a una richiesta di lettura. Questo evento è pensato principalmente per comodità e verrà sempre inviato dopo una chiamata a readDescriptorValue riuscita.

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

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, potresti disconnetterti. Questo evento è disponibile solo se nell'app le autorizzazioni bluetooth:low_energy e bluetooth:peipheral sono 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 cambia lo stato di un servizio GATT remoto. Ciò riguarda le caratteristiche e/o i descrittori che vengono 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,
)

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