chrome.bluetooth

Descrizione

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

Manifest

Per 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

    booleano

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

  • scoprire

    booleano

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

  • nome

    stringa

    Il nome leggibile dell'adattatore.

  • alimentato

    booleano

    Indica se l'alimentatore è alimentato.

BluetoothFilter

Chrome 67+

Proprietà

  • filterType

    FilterType facoltativo

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

  • limite

    number (facoltativo)

    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 (facoltativo)

    Chrome 77+

    La batteria rimanente del dispositivo.

  • collegabile

    booleano facoltativo

    Chrome 48+

    Indica se il dispositivo è connettibile.

  • connesso

    booleano facoltativo

    Indica se il dispositivo è attualmente connesso al sistema.

  • con scali

    booleano facoltativo

    Chrome 48+

    Indica se il dispositivo è attualmente in fase di connessione al sistema.

  • deviceClass

    number (facoltativo)

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

  • deviceId

    number (facoltativo)

  • inquiryRssi

    number (facoltativo)

    Chrome 44+

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

  • inquiryTxPower

    number (facoltativo)

    Chrome 44+

    Il livello di potenza trasmessa. Questo campo è disponibile solo per i dispositivi LE che lo includono nella pubblicità. È disponibile e valido solo durante l'esplorazione.

  • nome

    stringa facoltativa

    Il nome leggibile del dispositivo.

  • accoppiato

    booleano facoltativo

    Indica se il dispositivo è accoppiato al sistema.

  • productId

    number (facoltativo)

  • trasporto

    Trasporto facoltativo

    Chrome 76+

    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 frazione dei possibili tipi di dispositivi. In caso di dubbi, devi utilizzare direttamente il campo deviceClass.

  • uuids

    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 a basso consumo energetico, questo elenco viene ottenuto dai servizi principali AD e GATT. Per i dispositivi dual mode, questo valore può essere ottenuto da entrambi.

  • vendorId

    number (facoltativo)

  • 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"

"periferica"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67+

Tipi per il filtraggio dei dispositivi Bluetooth.

Enum

"all"

"known"

Transport

Chrome 76+

Tipo di trasporto del dispositivo Bluetooth.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Autorità di allocazione per gli ID fornitore.

Enum

"bluetooth"

"usb"

Metodi

getAdapterState()

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

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

Resi

  • Promise<AdapterState>

    Chrome 91+

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

getDevice()

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

Recupera informazioni su un dispositivo Bluetooth noto al sistema.

Parametri

  • deviceAddress

    stringa

    Indirizzo del dispositivo da ottenere.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (deviceInfo: Device) => void

    • deviceInfo

      Dispositivo

      Oggetto contenente le informazioni sul dispositivo.

Resi

  • Promise<Device>

    Chrome 91+

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

getDevices()

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

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

Parametri

  • filtro

    BluetoothFilter facoltativo

    Chrome 67+

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Dispositivo[]

      Array di oggetti contenenti informazioni sul dispositivo.

Resi

  • Promise<Device[]>

    Chrome 91+

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

startDiscovery()

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

Avvia il rilevamento. I dispositivi appena scoperti 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.

L'avvio del rilevamento non andrà a buon fine se questa applicazione ha già chiamato startDiscovery. Il rilevamento può richiedere molte risorse: stopDiscovery deve essere chiamato il prima possibile.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

stopDiscovery()

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

Interrompi il rilevamento.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91+

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

Eventi

onAdapterStateChanged

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

Attivato quando cambia lo stato dell'adattatore Bluetooth.

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 rilevato in precedenza è fuori dal raggio di azione per un periodo di tempo sufficiente a essere considerato di nuovo non disponibile e quando viene rimosso un dispositivo accoppiato.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (device: Device) => void