chrome.bluetooth

Descrizione

Utilizza l'API chrome.bluetooth per connetterti a un dispositivo Bluetooth. Tutte le funzioni segnalano gli errori tramite chrome.runtime.lastError.

Disponibilità

Solo ChromeOS

Manifest

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

"bluetooth"

Tipi

AdapterState

Proprietà

  • indirizzo

    stringa

    L'indirizzo dell'adattatore, nel formato "XX:XX:XX:XX:XX:XX".

  • disponibile

    booleano

    Indica se l'adattatore è disponibile (ovvero abilitato).

  • In fase di rilevamento

    booleano

    Indica se l'adattatore è attualmente in fase di rilevamento.

  • nome

    stringa

    Il nome leggibile dell'adattatore.

  • powered

    booleano

    Indica se l'adattatore è alimentato o meno.

BluetoothFilter

Chrome 67 e versioni successive

Proprietà

  • filterType

    FilterType facoltativo

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

  • limite

    number optional

    Il numero massimo di dispositivi Bluetooth da restituire. Se non specificato, il valore predefinito è 0 (nessun limite).

Device

Proprietà

  • indirizzo

    stringa

    L'indirizzo del dispositivo nel formato "XX:XX:XX:XX:XX:XX".

  • batteryPercentage

    number optional

    Chrome 77 e versioni successive

    La batteria rimanente del dispositivo.

  • collegabile

    boolean facoltativo

    Chrome 48 e versioni successive

    Indica se il dispositivo è collegabile.

  • connesso

    boolean facoltativo

    Indica se il dispositivo è attualmente connesso al sistema.

  • connettersi

    boolean facoltativo

    Chrome 48 e versioni successive

    Indica se il dispositivo si sta connettendo al sistema.

  • deviceClass

    number optional

    La classe del dispositivo, un campo di bit definito da http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • deviceId

    number optional

  • inquiryRssi

    number optional

    Chrome 44 e versioni successive

    L'intensità del segnale ricevuto, in dBm. Questo campo è disponibile e valido solo durante il discovery. Al di fuori del discovery, il suo valore non è specificato.

  • inquiryTxPower

    number optional

    Chrome 44 e versioni successive

    Il livello di potenza trasmesso. Questo campo è disponibile solo per i dispositivi LE che lo includono nell'AD. È disponibile e valido solo durante il rilevamento.

  • nome

    stringa facoltativa

    Il nome leggibile del dispositivo.

  • accoppiato

    boolean facoltativo

    Indica se il dispositivo è accoppiato o meno al sistema.

  • productId

    number optional

  • trasporto

    Transport 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 viene ottenuto dal campo deviceClass e rappresenta solo una piccola parte dei possibili tipi di dispositivi. In caso di dubbi, utilizza direttamente il campo deviceClass.

  • uuid

    string[] facoltativo

    UUID di protocolli, profili e servizi pubblicizzati dal dispositivo. Per i dispositivi Bluetooth classici, questo elenco viene ottenuto dai dati EIR e dalle tabelle SDP. Per i dispositivi Low Energy, questo elenco viene ottenuto dai servizi principali AD e GATT. Per i dispositivi dual mode, questo può essere ottenuto da entrambi.

  • vendorId

    number optional

  • vendorIdSource

    VendorIdSource facoltativo

    Il record dell'ID dispositivo, se disponibile.

DeviceType

Tipi di dispositivi comuni riconosciuti da Chrome.

Enum

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 e versioni successive

Tipi per il filtro dei dispositivi Bluetooth.

Enum

"all"

"known"

Transport

Chrome 76 e versioni successive

Tipo di trasporto del dispositivo Bluetooth.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Autorità di allocazione per gli ID fornitore.

Enum

"bluetooth"

"usb"

Metodi

getAdapterState()

Promise 
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

Ottenere informazioni sull'adattatore Bluetooth.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Oggetto contenente le informazioni sull'adattatore.

Resi

  • Promise<AdapterState>

    Chrome 91 e versioni successive

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

getDevice()

Promise 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

Ricevere informazioni su un dispositivo Bluetooth noto al sistema.

Parametri

  • deviceAddress

    stringa

    Indirizzo del dispositivo da recuperare.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (deviceInfo: Device) => void

    • deviceInfo

      Dispositivo

      Oggetto contenente le informazioni sul dispositivo.

Resi

  • Promise<Device>

    Chrome 91 e versioni successive

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

getDevices()

Promise 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

Recupera un elenco di dispositivi Bluetooth noti al sistema, inclusi i dispositivi accoppiati e quelli rilevati di recente.

Parametri

  • filtro

    BluetoothFilter facoltativo

    Chrome 67 e versioni successive

    Alcuni criteri per filtrare l'elenco dei dispositivi Bluetooth restituiti. Se il filtro non è impostato o è impostato su {}, l'elenco dei dispositivi restituito conterrà tutti i dispositivi Bluetooth. Al momento, questa funzionalità è supportata solo in ChromeOS. Per le altre piattaforme, viene restituito un elenco completo.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Dispositivo[]

      Array di oggetti contenenti informazioni sul dispositivo.

Resi

  • Promise<Device[]>

    Chrome 91 e versioni successive

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

startDiscovery()

Promise 
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

Avvia il rilevamento. I dispositivi appena rilevati verranno restituiti tramite l'evento onDeviceAdded. I dispositivi rilevati in precedenza e già noti all'adattatore devono essere ottenuti utilizzando getDevices e verranno aggiornati utilizzando l'evento onDeviceChanged solo se le informazioni che li riguardano cambiano.

Il rilevamento non verrà avviato se questa applicazione ha già chiamato startDiscovery. Il rilevamento può richiedere un utilizzo intensivo delle risorse: stopDiscovery deve essere chiamato il prima possibile.

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.

stopDiscovery()

Promise 
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

Interrompi il rilevamento.

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.

Eventi

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

Attivato quando lo stato dell'adattatore Bluetooth cambia.

Parametri

onDeviceAdded

chrome.bluetooth.onDeviceAdded.addListener(
  callback: function,
)

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,
)

Attivato quando le informazioni su un dispositivo Bluetooth noto sono cambiate.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (device: Device) => void

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

Attivato quando un dispositivo Bluetooth precedentemente rilevato è fuori portata da un tempo sufficiente per essere considerato nuovamente non disponibile e quando un dispositivo accoppiato viene rimosso.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (device: Device) => void