chrome.bluetooth

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

Chrome 67 e versioni successive

Proprietà

  • filterType

    FilterType facoltativo

    Tipo di filtro da applicare all'elenco dei dispositivi. Il valore predefinito è "Tutti".

  • limite

    numero facoltativo

    Numero massimo di dispositivi Bluetoth 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 successive

    La batteria rimanente del dispositivo.

  • collegabile

    booleano facoltativo

    Chrome 48 e versioni successive

    Indica se il dispositivo è collegabile.

  • connesso

    booleano facoltativo

    Indica se il dispositivo è attualmente connesso al sistema.

  • con scali

    booleano facoltativo

    Chrome 48 e versioni successive

    Indica 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 successive

    L'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 successive

    Il 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 successive

    Il 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 campo deviceClass.

  • 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

Chrome 67 e versioni successive

Tipi di filtro dei dispositivi Bluetooth.

Enum

Transport

Chrome 76 e versioni successive

Tipo di trasporto del dispositivo Bluetooth.

Enum

"le"

VendorIdSource

Autorità di allocazione per gli ID fornitore.

Enum

"bluetooth"

"usb"

Metodi

getAdapterState()

Promessa 
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

      AdapterState

      Oggetto contenente le informazioni sull'adattatore.

Ritorni

  • Promise<AdapterState>

    Chrome 91 e versioni successive

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

getDevice()

Promessa 
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

      Dispositivo

      Oggetto contenente le informazioni del dispositivo.

Ritorni

  • Promessa<Dispositivo>

    Chrome 91 e versioni successive

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

getDevices()

Promessa 
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 successive

    Alcuni 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

      Dispositivo[]

      Array di oggetto contenente informazioni sul dispositivo.

Ritorni

  • Promessa<Dispositivo[]>

    Chrome 91 e versioni successive

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

startDiscovery()

Promessa 
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 successive

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

stopDiscovery()

Promessa 
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 successive

    Le 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

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

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

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