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 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 se è attivo).

  • scoprire

    booleano

    Indica se l'adattatore sta rilevando la situazione o meno.

  • nome

    stringa

    Il nome leggibile dell'adattatore.

  • alimentato

    booleano

    Indica se l'alimentatore è 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 è tutto.

  • limite

    numero facoltativo

    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

    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 è attualmente connesso 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 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 includono questo campo in AD. È disponibile e valido solo durante il 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 possibili tipi di dispositivi. In caso di dubbi, utilizza direttamente il campo deviceClass.

  • uuids

    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 dual mode, è possibile farlo da entrambi.

  • vendorId

    numero facoltativo

  • vendorIdSource

    VendorIdSource facoltativo

    Il record ID del dispositivo, se disponibile.

DeviceType

Tipi di dispositivi comuni riconosciuti da Chrome.

Enum

"computer"

"telefono"

"modem"

"audio"

"carAudio"

"video"

"periferica"

"joystick"

"gamepad"

"tastiera"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 e versioni successive .

Tipi per filtrare i dispositivi Bluetooth.

Enum

"tutti"

"noto"

Transport

Chrome 76 e versioni successive .

Tipo di trasporto del dispositivo Bluetooth.

Enum

"non valido"

"classico"

"le"

"doppio"

VendorIdSource

Autorità di allocazione per gli ID fornitore.

Enum

"bluetooth"

"usb"

Metodi

getAdapterState()

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

Resi

  • Promise<AdapterState>

    Chrome 91 e versioni successive .

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

getDevice()

Promesso .
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Consente di ricevere 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 del dispositivo.

Resi

  • Promise<Device>

    Chrome 91 e versioni successive .

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

getDevices()

Promesso .
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Consente di ricevere un elenco di dispositivi Bluetooth noti al sistema, inclusi i dispositivi accoppiati e 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 viene impostato o se viene impostato su {}, l'elenco dei dispositivi restituiti 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.

Resi

  • Prometti <dispositivo[]>

    Chrome 91 e versioni successive .

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

startDiscovery()

Promesso .
chrome.bluetooth.startDiscovery(
  callback?: function,
)

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

Il rilevamento non verrà avviato se l'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

  • Promesso<void>

    Chrome 91 e versioni successive .

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

stopDiscovery()

Promesso .
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Interrompi il rilevamento.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 91 e versioni successive .

    Le promesse 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 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 cambiano 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,
)

Attivato quando un dispositivo Bluetooth rilevato in precedenza è fuori dal raggio d'azione abbastanza a lungo da 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