Descrizione
Usa l'API chrome.bluetooth
per connetterti a un dispositivo Bluetooth. Tutte le funzioni segnalano errori tramite chrome.runtime.lastError.
Manifest
Per poter utilizzare questa API, le seguenti chiavi devono essere dichiarate nel manifest.
"bluetooth"
Tipi
AdapterState
Proprietà
-
indirizzo
stringa
L'indirizzo dell'adattatore nel formato "XX:XX:XX:XX:XX:XX".
-
disponibile
boolean
Indica se l'adattatore è disponibile (ossia attivo).
-
scoprire
boolean
Indica se l'adattatore è in fase di rilevamento o meno.
-
nome
stringa
Il nome leggibile dell'adattatore.
-
alimentato
boolean
Indica se l'alimentatore è alimentato.
BluetoothFilter
Proprietà
-
filterType
FilterType facoltativo
Tipo di filtro da applicare all'elenco dei dispositivi. Il valore predefinito è "Tutti".
-
limite
numero facoltativo
Numero massimo di dispositivi Bluetooth da restituire. Il valore predefinito è 0 (nessun limite) se non specificato.
Device
Proprietà
-
indirizzo
stringa
L'indirizzo del dispositivo, nel formato "XX:XX:XX:XX:XX:XX".
-
batteryPercentage
numero facoltativo
Chrome 77 e versioni successiveLa batteria rimanente del dispositivo.
-
collegabile
booleano facoltativo
Chrome 48 e versioni successiveIndica se il dispositivo è collegabile.
-
connesso
booleano facoltativo
Indica se il dispositivo è attualmente connesso al sistema.
-
con scali
booleano facoltativo
Chrome 48 e versioni successiveIndica se il dispositivo si sta connettendo al sistema.
-
deviceClass
numero facoltativo
La classe del dispositivo, un campo di bit definito da http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.
-
deviceId
numero facoltativo
-
inquiryRssi
numero facoltativo
Chrome 44 e versioni successiveL'intensità del segnale ricevuto, in dBm. Questo campo è disponibile e valido solo durante il rilevamento. Al di fuori del rilevamento, il suo valore non è specificato.
-
inquiryTxPower
numero facoltativo
Chrome 44 e versioni successiveIl livello di potenza trasmessa. Questo campo è disponibile solo per i dispositivi LE che lo includono in AD. È disponibile e valido solo durante la fase di rilevamento.
-
nome
stringa facoltativo
Il nome leggibile del dispositivo.
-
accoppiato
booleano facoltativo
Indica se il dispositivo è accoppiato o meno al sistema.
-
productId
numero facoltativo
-
trasporto
Trasporto facoltativo
Chrome 76 e versioni successiveIl tipo di trasporto del dispositivo Bluetooth.
-
Tipo
DeviceType facoltativo
Il tipo di dispositivo, se riconosciuto da Chrome. Questo valore è ottenuto dal campo
deviceClass
e rappresenta solo una piccola parte dei tipi di dispositivi possibili. In caso di dubbi, devi utilizzare direttamente il campodeviceClass
. -
uuid
string[] facoltativo
UUID di protocolli, profili e servizi pubblicizzati dal dispositivo. Per i dispositivi Bluetooth classici, questo elenco è ottenuto dai dati EIR e dalle tabelle SDP. Per i dispositivi a bassa energia, questo elenco è ottenuto dai servizi principali AD e GATT. Per i dispositivi in modalità dual-mode, è possibile ottenere l'accesso da entrambi.
-
vendorId
numero facoltativo
-
vendorIdSource
Facoltativo VendorIdSource
Il record dell'ID dispositivo del dispositivo, se disponibile.
DeviceType
Tipi di dispositivi comuni riconosciuti da Chrome.
Enum
"computer"
"modem"
"audio"
"carAudio"
"video"
"joystick"
"gamepad"
"mouse"
"tablet"
FilterType
Tipi di filtro dei dispositivi Bluetooth.
Enum
Transport
Tipo di trasporto del dispositivo Bluetooth.
Enum
"le"
VendorIdSource
Autorità di allocazione per gli ID fornitore.
Enum
"bluetooth"
"usb"
Metodi
getAdapterState()
chrome.bluetooth.getAdapterState(
callback?: function,
)
Trova informazioni sull'adattatore Bluetooth.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(adapterInfo: AdapterState) => void
-
adapterInfo
Oggetto contenente le informazioni sull'adattatore.
-
Ritorni
-
Promise<AdapterState>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDevice()
chrome.bluetooth.getDevice(
deviceAddress: string,
callback?: function,
)
Ottenere informazioni su un dispositivo Bluetooth noto al sistema.
Parametri
-
deviceAddress
stringa
Indirizzo del dispositivo da recuperare.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(deviceInfo: Device) => void
-
deviceInfo
Oggetto contenente le informazioni del dispositivo.
-
Ritorni
-
Promessa<Dispositivo>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDevices()
chrome.bluetooth.getDevices(
filter?: BluetoothFilter,
callback?: function,
)
Ottieni un elenco di dispositivi Bluetooth noti al sistema, inclusi i dispositivi accoppiati e rilevati di recente.
Parametri
-
filter
BluetoothFilter facoltativo
Chrome 67 e versioni successiveAlcuni criteri per filtrare l'elenco dei dispositivi Bluetooth restituiti. Se il filtro non viene impostato o se viene impostato su
{}
, l'elenco dei dispositivi restituito conterrà tutti i dispositivi Bluetooth. Al momento questa funzionalità è supportata solo in ChromeOS; per altre piattaforme, viene restituito un elenco completo. -
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(deviceInfos: Device[]) => void
-
deviceInfos
Array di oggetto contenente informazioni sul dispositivo.
-
Ritorni
-
Promessa<Dispositivo[]>
Chrome 91 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
startDiscovery()
chrome.bluetooth.startDiscovery(
callback?: function,
)
Avvia il rilevamento. I nuovi dispositivi rilevati verranno restituiti tramite l'evento onDeviceDevice. I dispositivi rilevati in precedenza già noti per l'adattatore devono essere ottenuti utilizzando getDevices e verranno aggiornati utilizzando l'evento onDeviceChanged
solo se le relative informazioni cambiano.
Il rilevamento non verrà avviato se questa applicazione ha già chiamato startDiscovery. Il rilevamento può richiedere molte risorse: occorre chiamare stopDiscovery il prima possibile.
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.
stopDiscovery()
chrome.bluetooth.stopDiscovery(
callback?: function,
)
Interrompi rilevamento.
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.
Eventi
onAdapterStateChanged
chrome.bluetooth.onAdapterStateChanged.addListener(
callback: function,
)
Viene attivato quando cambia lo stato dell'adattatore Bluetooth.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(state: AdapterState) => void
-
state
-
onDeviceAdded
chrome.bluetooth.onDeviceAdded.addListener(
callback: function,
)
Viene attivato quando sono disponibili informazioni su un nuovo dispositivo Bluetooth.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(device: Device) => void
-
dispositivo
-
onDeviceChanged
chrome.bluetooth.onDeviceChanged.addListener(
callback: function,
)
Viene attivato quando vengono modificate le informazioni su un dispositivo Bluetooth noto.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(device: Device) => void
-
dispositivo
-
onDeviceRemoved
chrome.bluetooth.onDeviceRemoved.addListener(
callback: function,
)
Si attiva quando un dispositivo Bluetooth precedentemente rilevato è rimasto fuori dal raggio d'azione per un tempo sufficiente a essere considerato di nuovo non disponibile e quando un dispositivo accoppiato viene rimosso.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(device: Device) => void
-
dispositivo
-