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

  • scoprire

    booleano

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

  • nome

    stringa

    Il nome leggibile dell'adattatore.

  • alimentato

    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 di dispositivi. Il valore predefinito è tutto.

  • limite

    number 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

    number facoltativo

    Chrome 77 e versioni successive

    La batteria rimanente del dispositivo.

  • collegabile

    booleano facoltativo

    Chrome 48 o versioni successive

    Indica se il dispositivo è connettibile.

  • connesso

    booleano facoltativo

    Indica se il dispositivo è attualmente connesso al sistema.

  • con scali

    booleano facoltativo

    Chrome 48 o versioni successive

    Indica se il dispositivo è attualmente connesso 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 e versioni successive

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

  • inquiryTxPower

    number facoltativo

    Chrome 44 e versioni successive

    Il livello di potenza trasmessa. Questo campo è disponibile solo per i dispositivi LE che lo includono nell'annuncio. È disponibile e valido solo durante la scoperta.

  • nome

    stringa facoltativa

    Il nome leggibile del dispositivo.

  • accoppiato

    booleano facoltativo

    Indica se il dispositivo è accoppiato o meno con il sistema.

  • productId

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

  • uuids

    stringa[] 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, è possibile ottenerli 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"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 e versioni successive

Tipi per filtrare i dispositivi Bluetooth.

Enum

"all"

"known"

Transport

Chrome 76 e versioni successive

Tipo di trasporto del dispositivo Bluetooth.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Autorizzazioni di allocazione per gli ID fornitore.

Enum

"bluetooth"

"usb"

Metodi

getAdapterState()

Promessa 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Visualizza le informazioni sull'adattatore Bluetooth.

Parametri

  • callback

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

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

Visualizza le informazioni su un dispositivo Bluetooth noto al sistema.

Parametri

  • deviceAddress

    stringa

    Indirizzo del dispositivo da recuperare.

  • callback

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

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

Visualizza un elenco dei 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 è impostato o è impostato su {}, l'elenco dei dispositivi restituiti conterrà tutti i dispositivi Bluetooth. Al momento questa funzionalità è supportata solo su ChromeOS. Per le altre piattaforme viene restituito un elenco completo.

  • callback

    function 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 e versioni successive

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

startDiscovery()

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

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

La ricerca non verrà avviata se questa applicazione ha già chiamato startDiscovery. La ricerca può richiedere molte risorse: stopDiscovery deve essere chiamata il prima possibile.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<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()

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

Interrompi il rilevamento.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

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

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

Viene attivato quando un dispositivo Bluetooth rilevato in precedenza è fuori portata per un periodo di tempo sufficientemente 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