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
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
Tipo di pubblicità.
AdvertisementType
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à
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.
-
autorizzazioniChrome 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
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
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
Proprietà
-
dati
numero[]
-
id
numero
Notification
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
Proprietà
-
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
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
Proprietà
-
dati
numero[]
-
uuid
stringa
Metodi
connect()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
createCharacteristic()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
createDescriptor()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
createService()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
disconnect()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getCharacteristic()
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
-
risultato
-
Ritorni
-
Promise<Characteristic>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getCharacteristics()
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
-
risultato
-
Ritorni
-
Promise<Characteristic[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDescriptor()
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
-
risultato
-
Ritorni
-
Promise<Descriptor>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDescriptors()
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
-
risultato
-
Ritorni
-
Promise<Descriptor[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
Recupera un elenco dei servizi GATT inclusi dal servizio in questione.
Parametri
Ritorni
-
Promessa<Servizio[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getService()
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
-
risultato
-
Ritorni
-
Promessa<Servizio>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getServices()
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
Ritorni
-
Promessa<Servizio[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
notifyCharacteristicValueChanged()
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
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
readCharacteristicValue()
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
-
risultato
-
Ritorni
-
Promise<Characteristic>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
readDescriptorValue()
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
-
risultato
-
Ritorni
-
Promise<Descriptor>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
registerAdvertisement()
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à
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
registerService()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
removeService()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
resetAdvertising()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
sendRequestResponse()
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
La risposta alla richiesta.
setAdvertisingInterval()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
startCharacteristicNotifications()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
stopCharacteristicNotifications()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
unregisterAdvertisement()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
unregisterService()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
writeCharacteristicValue()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
writeDescriptorValue()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
Eventi
onCharacteristicReadRequest
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
-
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
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(characteristic: Characteristic) => void
-
caratteristica
-
onCharacteristicWriteRequest
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
-
characteristicId
stringa
-
onDescriptorReadRequest
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
-
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
-
descrittore
-
onDescriptorWriteRequest
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
-
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
-
servizio
-
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
-
servizio
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Attivato quando un servizio GATT precedentemente rilevato su un dispositivo remoto è stato rimosso.