chrome.bluetoothLowEnergy

Descrizione

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

Manifest

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

"bluetooth"

Tipi

Advertisement

Chrome 47 e versioni successive .

Proprietà

  • manufacturerData

    ManufacturerData[] facoltativo

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

  • serviceData

    ServiceData[] facoltativo

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

  • serviceUuids

    string[] facoltativo

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

  • solicitUuids

    string[] facoltativo

    Elenco di UUID da includere negli "UUID solicit" dei dati pubblicitari. Questi UUID possono essere a 16 bit, 32 bit o 128.

  • Tipo di pubblicità.

AdvertisementType

Chrome 47 e versioni successive .

Tipo di pubblicità. Se "trasmetti" viene scelto, 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

"trasmissione"

"periferica"

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 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 caratteristiche vengono dedotte da queste proprietà. Consulta le specifiche Bluetooth 4.x per conoscere il significato di ogni singola proprietà.

Enum

"trasmissione"

"leggi"

"writeWithoutResponse"

"scrivere"

"notifica"

"indica"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Proprietà

  • persistente

    booleano

    Flag che indica se rimane aperta una connessione al dispositivo quando viene scaricata la pagina degli eventi dell'applicazione (vedi Gestione del ciclo di vita delle 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 di una periferica con lo stesso UUID ed effettuare chiamate di 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 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 le specifiche Bluetooth 4.x per conoscere il significato di ogni singola autorizzazione.

Enum

"leggi"

"scrivere"

"cryptRead"

"EncryptWrite"

"cryptAuthenticatedRead"

"cryptAuthenticatedWrite"

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à

  • persistente

    booleano

    Flag che indica se l'app deve ricevere notifiche quando viene scaricata la pagina degli eventi dell'applicazione (vedi Gestire il 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

    booleano

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

  • requestId

    numero

    ID della richiesta a cui corrisponde una risposta.

  • valore

    ArrayBuffer facoltativo

    Valore della risposta. Le richieste di scrittura e le risposte di errore ignorano 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 al 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.

  • Principale

    booleano

    Indica se il tipo di servizio è primario 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()

Promesso .
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 il numero 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 al numero 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

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

createCharacteristic()

Promesso 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 all'interno di un servizio valido. Se l'ID servizio non è valido, verrà impostato l'ultimo errore. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica potrebbe non essere disponibile per tutte le app.

Parametri

  • caratteristica

    Caratteristica

    La caratteristica di creare.

  • serviceId

    stringa

    ID del servizio per il quale creare questa caratteristica.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (characteristicId: string) => void

    • characteristicId

      stringa

Resi

  • Promise&lt;string&gt;

    Chrome 91 e versioni successive .

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

createDescriptor()

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

Crea un descrittore GATT ospitato in locale. Questo descrittore deve essere ospitato all'interno di una caratteristica valida. Se l'ID caratteristica non è valido, verrà impostato lastError. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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

Resi

  • Promise&lt;string&gt;

    Chrome 91 e versioni successive .

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

createService()

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

Creare un servizio GATT ospitato localmente. Questo servizio può essere registrato per essere disponibile su un server GATT locale. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione delle 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&lt;string&gt;

    Chrome 91 e versioni successive .

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

disconnect()

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

Chiude la connessione dell'app al dispositivo con l'indirizzo specificato. Tieni presente che questo non comporta sempre l'eliminazione del collegamento fisico, in quanto 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

  • Promesso<void>

    Chrome 91 e versioni successive .

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

getCharacteristic()

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

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

Parametri

  • characteristicId

    stringa

    L'ID istanza della caratteristica GATT richiesta.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Characteristic) => void

Resi

  • Promessa<Caratteristica>

    Chrome 91 e versioni successive .

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

getCharacteristics()

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

Recupera un elenco di tutte le caratteristiche GATT scoperte 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

Resi

  • Promesso<Caratteristica[]>

    Chrome 91 e versioni successive .

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

getDescriptor()

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

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&lt;Descriptor&gt;

    Chrome 91 e versioni successive .

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

getDescriptors()

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

Recupera un elenco di descrittori delle caratteristiche GATT che appartengono a quella determinata.

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

Resi

  • Promise&lt;Descriptor[]&gt;

    Chrome 91 e versioni successive .

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

getIncludedServices()

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

Ottieni un elenco dei servizi GATT inclusi dal servizio specificato.

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

Resi

  • Promesso<Servizio[]>

    Chrome 91 e versioni successive .

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

getService()

Promesso .
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

Resi

  • Promise&lt;Service&gt;

    Chrome 91 e versioni successive .

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

getServices()

Promesso .
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 alternativa 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

Resi

  • Promesso<Servizio[]>

    Chrome 91 e versioni successive .

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

notifyCharacteristicValueChanged()

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

Avvisa un dispositivo remoto di un nuovo valore di una caratteristica. Se il flag mustIndicate nell'oggetto notifica è true, verrà inviata un'indicazione anziché una notifica. Tieni presente che la caratteristica deve impostare correttamente "notifica" o "indica" durante la creazione affinché questa chiamata vada a buon fine. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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

  • Promesso<void>

    Chrome 91 e versioni successive .

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

readCharacteristicValue()

Promesso .
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

Resi

  • Promessa<Caratteristica>

    Chrome 91 e versioni successive .

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

readDescriptorValue()

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

Recupera il valore di un descrittore della 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&lt;Descriptor&gt;

    Chrome 91 e versioni successive .

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

registerAdvertisement()

Promesso 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:peripheral impostate su true. Inoltre, questa API è disponibile solo per le app avviate automaticamente in modalità kiosk o impostando "--enable-ble-advertising-in-apps" dalla riga di comando. Visita la pagina https://developer.chrome.com/apps/manifest/bluetooth: su alcuni hardware, le modalità centrale e delle periferiche sono supportate contemporaneamente, ma su hardware che non la supporta, pertanto la chiamata comporterà il passaggio alla modalità periferica sul dispositivo. Nel caso di hardware che non supporta sia la modalità centrale che quella periferica, il tentativo di utilizzare il dispositivo in entrambe le modalità porterà a un comportamento indefinito o impedirà ad altre applicazioni del ruolo centrale di comportarsi correttamente (compreso 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

Resi

  • Promise&lt;number&gt;

    Chrome 91 e versioni successive .

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

registerService()

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

Registra il servizio specificato con il server GATT locale. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione delle 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

  • Promesso<void>

    Chrome 91 e versioni successive .

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

removeService()

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

Rimuovere il servizio specificato, annullando la registrazione se era stato registrato. Se l'ID servizio non è valido, verrà impostato lastError. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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

  • Promesso<void>

    Chrome 91 e versioni successive .

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

resetAdvertising()

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

Reimposta la pubblicità sul dispositivo corrente. La registrazione verrà annullata e tutte le pubblicità esistenti verranno interrotte.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

sendRequestResponse()

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

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

Parametri

  • risposta

    Risposta

    La risposta alla richiesta.

setAdvertisingInterval()

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

Imposta l'intervallo tra due annunci consecutivi. Nota: fai del tuo meglio. L'intervallo effettivo può variare in modo non irrilevante rispetto a quelli richiesti. Su alcuni hardware, c'è 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). Questo valore non può essere inferiore a 20 ms (in base alle specifiche).

  • maxInterval

    numero

    Intervallo massimo tra gli annunci (in millisecondi). Questo valore non può essere superiore a 10.240 ms (in base alle specifiche).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

startCharacteristicNotifications()

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

Attiva le notifiche/indicazioni dei valori in base alla caratteristica specificata. Una volta attivata, l'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 (facoltativo).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

stopCharacteristicNotifications()

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

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

Parametri

  • characteristicId

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

unregisterAdvertisement()

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

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

Parametri

  • advertisementId

    numero

    ID dell'annuncio di cui annullare la registrazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

unregisterService()

Promesso 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 lastError. Questa funzione è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione delle 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

  • Promesso<void>

    Chrome 91 e versioni successive .

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

writeCharacteristicValue()

Promesso .
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 il cui valore deve essere scritto.

  • valore

    ArrayBuffer

    Il valore da inviare alla caratteristica remota come parte della richiesta di scrittura.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

writeDescriptorValue()

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

Scrivere il valore di un descrittore della 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 da inviare al descrittore remoto come parte della richiesta di scrittura.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

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

Eventi

onCharacteristicReadRequest

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

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 causare una disconnessione. Questo evento è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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, in seguito a una richiesta di lettura o a una notifica/indicazione di modifica del valore. Questo evento verrà inviato soltanto 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 causare una disconnessione. Questo evento è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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 di leggere il valore di un descrittore registrato sul server GATT locale. Se non rispondi a questa richiesta per molto tempo, potresti causare una disconnessione. Questo evento è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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 della caratteristica GATT remoto cambia, solitamente in seguito a una richiesta di lettura. Questo evento esiste principalmente per comodità e verrà sempre inviato dopo una chiamata al numero 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,
)

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 causare una disconnessione. Questo evento è disponibile soltanto se le autorizzazioni bluetooth:low_energy e bluetooth:peripheral dell'app sono impostate su true. L'autorizzazione di accesso alla periferica 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é "ServiceChanged". notifiche 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 rilevato in precedenza su un dispositivo remoto è stato rimosso.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (service: Service) => void