chrome.bluetoothLowEnergy

Descrizione

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

Disponibilità

Solo ChromeOS

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

    string[] facoltativo

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

  • solicitUuids

    string[] facoltativo

    Elenco di UUID da includere nel campo "Solicit UUIDs" (UUID richiesti) dei dati pubblicitari. Questi UUID possono essere nei formati a 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

"trasmetti"

"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 ed eseguire 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

"trasmetti"

"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 degli eventi dell'applicazione viene scaricata (consulta Gestisci il ciclo di vita dell'app). Il valore predefinito è false.

Descriptor

Proprietà

  • caratteristica

    Characteristic facoltativo

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

    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

    boolean facoltativo

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

  • valore

    ArrayBuffer

    Nuovo valore della caratteristica.

NotificationProperties

Proprietà

  • persistente

    booleano

    Flag che indica se l'app deve ricevere notifiche quando la pagina degli eventi dell'applicazione viene scaricata (consulta Gestisci il ciclo di vita delle app). Il valore predefinito è false.

Request

Chrome 52 e versioni successive

Proprietà

  • dispositivo

    Dispositivo

    Dispositivo che ha inviato la 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, il valore deve essere true.

  • requestId

    numero

    ID della richiesta a cui si riferisce questa risposta.

  • valore

    ArrayBuffer facoltativo

    Response value. 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 eseguire chiamate di funzione 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()

Promise 
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 suoi 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 venga mantenuta una connessione al dispositivo. 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 (facoltativo).

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

createCharacteristic()

Promise 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 l'app ha entrambe 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

  • caratteristica

    Caratteristica

    La caratteristica da creare.

  • serviceId

    stringa

    ID del servizio per cui creare questa caratteristica.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (characteristicId: string) => void

    • characteristicId

      stringa

Resi

  • Promise<string>

    Chrome 91 e versioni successive

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

createDescriptor()

Promise 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 della caratteristica non è valido, verrà impostato lastError. Questa funzione è disponibile solo se l'app ha entrambe 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

  • descrittore

    Descriptor

    Il descrittore da creare.

  • characteristicId

    stringa

    ID della caratteristica per cui creare questo descrittore.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (descriptorId: string) => void

    • descriptorId

      stringa

Resi

  • Promise<string>

    Chrome 91 e versioni successive

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

createService()

Promise 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 l'app ha entrambe 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

  • servizio

    Servizio

    Il servizio da creare.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (serviceId: string) => void

    • serviceId

      stringa

Resi

  • Promise<string>

    Chrome 91 e versioni successive

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

disconnect()

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

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

Parametri

  • deviceAddress

    stringa

    L'indirizzo Bluetooth del dispositivo remoto.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

getCharacteristic()

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

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

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promise<Characteristic>

    Chrome 91 e versioni successive

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

getCharacteristics()

Promise 
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 di cui devono essere restituite le caratteristiche.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic[]) => void

Resi

  • Promise<Characteristic[]>

    Chrome 91 e versioni successive

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

getDescriptor()

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

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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor) => void

Resi

  • Promise<Descriptor>

    Chrome 91 e versioni successive

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

getDescriptors()

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

Ottieni un elenco di descrittori di 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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor[]) => void

Resi

  • Promise<Descriptor[]>

    Chrome 91 e versioni successive

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

getIncludedServices()

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

Recupera un elenco di servizi GATT inclusi nel servizio specificato.

Parametri

  • serviceId

    stringa

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

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Service[]) => void

Resi

  • Promise<Service[]>

    Chrome 91 e versioni successive

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

getService()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Service) => void

Resi

  • Promise<Service>

    Chrome 91 e versioni successive

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

getServices()

Promise 
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 Service Discovery non è ancora stato completato sul dispositivo, questa API restituirà un sottoinsieme (probabilmente vuoto) di servizi. Una soluzione alternativa consiste nell'aggiungere un ritardo basato sul tempo e/o chiamare ripetutamente 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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Service[]) => void

Resi

  • Promise<Service[]>

    Chrome 91 e versioni successive

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

notifyCharacteristicValueChanged()

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

Invia una notifica a un dispositivo remoto relativa a 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 l'app ha entrambe 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

  • characteristicId

    stringa

    La caratteristica per cui inviare la notifica.

  • notifica

    Notifica

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

readCharacteristicValue()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promise<Characteristic>

    Chrome 91 e versioni successive

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

readDescriptorValue()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: Descriptor) => void

Resi

  • Promise<Descriptor>

    Chrome 91 e versioni successive

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

registerAdvertisement()

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

Crea un annuncio e registralo per l'advertising. 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, sono supportate contemporaneamente le modalità centrale e periferica, ma sull'hardware che non supporta questa funzionalità, l'esecuzione di questa chiamata farà passare il dispositivo alla modalità periferica. Nel caso di hardware che non supporta entrambe le modalità centrale e periferica, il tentativo di utilizzare il dispositivo in entrambe le modalità comporterà un comportamento non definito o impedirà il corretto funzionamento di altre applicazioni con ruolo centrale (incluso il rilevamento di dispositivi Bluetooth Low Energy).

Parametri

  • pubblicità

    Advertisement

    La pubblicità da pubblicizzare.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (advertisementId: number) => void

    • advertisementId

      numero

Resi

  • Promise<number>

    Chrome 91 e versioni successive

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

registerService()

Promise 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 l'app ha entrambe 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

  • serviceId

    stringa

    ID univoco di un servizio creato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

removeService()

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

Rimuove il servizio specificato, annullandone la registrazione se era registrato. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile solo se l'app ha entrambe 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

  • serviceId

    stringa

    ID univoco di un servizio attualmente registrato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

resetAdvertising()

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

Reimposta la pubblicità sul dispositivo corrente. Annullerà la registrazione e interromperà tutti gli annunci esistenti.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promise 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,
): void

Invia una risposta per una richiesta di lettura/scrittura di una caratteristica o di un descrittore. Questa funzione è disponibile solo se l'app ha entrambe 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

  • risposta

    Risposta

    La risposta alla richiesta.

setAdvertisingInterval()

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

Imposta l'intervallo tra due annunci consecutivi. Nota: si tratta di un tentativo "best effort". L'intervallo effettivo potrebbe variare in modo non banale rispetto agli intervalli richiesti. Su alcuni hardware, l'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). Questo valore non può essere inferiore a 20 ms (come da specifica).

  • maxInterval

    numero

    Intervallo massimo tra gli annunci (in millisecondi). Questo valore non può essere superiore a 10.240 ms (come da specifica).

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

startCharacteristicNotifications()

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

Attiva le notifiche/indicazioni dei valori 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 su cui devono essere attivate le notifiche.

  • proprietà

    NotificationProperties facoltativo

    Proprietà della sessione di notifica (facoltative).

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

stopCharacteristicNotifications()

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

Disattiva le notifiche/indicazioni dei valori 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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

unregisterAdvertisement()

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

Annulla la registrazione di un annuncio e ne interrompe la pubblicazione. Se l'annuncio non viene annullato, l'unico modo per interromperlo potrebbe essere riavviare il dispositivo.

Parametri

  • advertisementId

    numero

    ID dell'annuncio di cui annullare la registrazione.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

unregisterService()

Promise 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 l'app ha entrambe 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

  • serviceId

    stringa

    ID univoco di un servizio attualmente registrato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

writeCharacteristicValue()

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

Scrivere 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 che deve essere inviato alla caratteristica remota nell'ambito della richiesta di scrittura.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

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

writeDescriptorValue()

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

Scrive 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 scritto.

  • valore

    ArrayBuffer

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

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Le promise 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. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. Questo evento è disponibile solo se l'app ha entrambe 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

      Richiesta

    • 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 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. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. Questo evento è disponibile solo se l'app ha entrambe 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

      Richiesta

    • 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. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. Questo evento è disponibile solo se l'app ha entrambe 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

onDescriptorValueChanged

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

Attivato quando il valore di un descrittore di caratteristica GATT remoto cambia, in genere in seguito a 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 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. La mancata risposta a questa richiesta per un lungo periodo di tempo potrebbe comportare una disconnessione. Questo evento è disponibile solo se l'app ha entrambe 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

onServiceAdded

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

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 lo stato di un servizio GATT remoto cambia. Ciò include tutte 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,
)

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