chrome.bluetooth

Descripción

Usa la API de chrome.bluetooth para conectarte a un dispositivo Bluetooth. Todas las funciones informan fallas a través de chrome.runtime.lastError.

Manifiesto

Para usar esta API, se deben declarar las siguientes claves en el manifiesto.

"bluetooth"

Tipos

AdapterState

Propiedades

  • dirección

    string

    La dirección del adaptador, en formato "XX:XX:XX:XX:XX:XX".

  • disponible

    boolean

    Indica si el adaptador está disponible (es decir, habilitado).

  • descubrir

    boolean

    Indica si el adaptador está detectando o no.

  • nombre

    string

    Es el nombre legible del adaptador.

  • encendido

    boolean

    Indica si el adaptador tiene alimentación o no.

BluetoothFilter

Chrome 67 y versiones posteriores

Propiedades

  • filterType

    FilterType opcional

    Es el tipo de filtro que se aplicará a la lista de dispositivos. Todas.

  • límite

    número opcional

    Cantidad máxima de dispositivos Bluetooth que se mostrarán. Si no se especifica, el valor predeterminado es 0 (sin límite).

Device

Propiedades

  • dirección

    string

    La dirección del dispositivo, en formato "XX:XX:XX:XX:XX:XX".

  • batteryPercentage

    número opcional

    Chrome 77 y versiones posteriores

    La batería restante del dispositivo.

  • conectable

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si el dispositivo es conectable.

  • Conectado

    booleano opcional

    Indica si el dispositivo está conectado al sistema actualmente.

  • Conectar

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si el dispositivo se está conectando al sistema actualmente.

  • deviceClass

    número opcional

    La clase del dispositivo, un campo de bits definido por http://www.bluetooth.org/en-us/specification/Assigned-numbers/baseband.

  • deviceId

    número opcional

  • inquiryRssi

    número opcional

    Chrome 44 y versiones posteriores

    La intensidad de la señal recibida, en dBm. Este campo está disponible y válido solo durante el descubrimiento. Fuera del descubrimiento, no se especifica su valor.

  • inquiryTxPower

    número opcional

    Chrome 44 y versiones posteriores

    Es el nivel de potencia que se transmite. Este campo solo está disponible para dispositivos LE que lo incluyan en AD. Está disponible y es válido solo durante el descubrimiento.

  • nombre

    string opcional

    Es el nombre del dispositivo en lenguaje natural.

  • vinculado

    booleano opcional

    Indica si el dispositivo está vinculado con el sistema o no.

  • productId

    número opcional

  • transporte

    Transporte opcional

    Chrome 76 y versiones posteriores

    Es el tipo de transporte del dispositivo Bluetooth.

  • tipo

    DeviceType opcional

    Es el tipo de dispositivo, si Chrome lo reconoce. Se obtiene del campo deviceClass y solo representa una pequeña fracción de los tipos de dispositivos posibles. Si tienes dudas, usa directamente el campo deviceClass.

  • uuids

    string[] opcional

    UUID de protocolos, perfiles y servicios anunciados por el dispositivo. Para los dispositivos Bluetooth clásicos, esta lista se obtiene de los datos de EIR y de las tablas del SDP. Para los dispositivos de bajo consumo, esta lista se obtiene de los servicios principales de AD y GATT. En el caso de los dispositivos de modo dual, esto se puede obtener de ambos.

  • vendorId

    número opcional

  • vendorIdSource

    VendorIdSource (opcional)

    El registro de ID de dispositivo del dispositivo, si está disponible.

DeviceType

Tipos de dispositivos comunes reconocidos por Chrome

Enum

“computadora”

“teléfono”

“modem”

“audio”

“carAudio”

“video”

“periférico”

“joystick”

"control de juegos"

“teclado”

“mouse”

“tablet”

“tecladoMouseCombo”

FilterType

Chrome 67 y versiones posteriores

Tipos para filtrar dispositivos Bluetooth.

Enum

“todos”

“conocido”

Transport

Chrome 76 y versiones posteriores

Tipo de transporte del dispositivo Bluetooth.

Enum

“no válido”

“clásico”

“le”

“dual”

VendorIdSource

Autoridades de asignación para los IDs de proveedores.

Enum

"Bluetooth"

“usb”

Métodos

getAdapterState()

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

Obtén información sobre el adaptador Bluetooth.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objeto que contiene la información del adaptador.

Muestra

  • Promise<AdapterState>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getDevice()

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

Obtener información sobre un dispositivo Bluetooth conocido por el sistema

Parámetros

  • deviceAddress

    string

    Dirección del dispositivo que se debe obtener.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (deviceInfo: Device) => void

    • deviceInfo

      Dispositivo

      Objeto que contiene la información del dispositivo.

Muestra

  • Promise<Device>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getDevices()

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

Obtén una lista de los dispositivos Bluetooth que el sistema conoce, incluidos los dispositivos vinculados y descubiertos recientemente.

Parámetros

  • filter

    BluetoothFilter opcional

    Chrome 67 y versiones posteriores

    Algunos criterios para filtrar la lista de dispositivos Bluetooth que se muestran. Si no estableces el filtro o la estableces como {}, la lista de dispositivos que se muestren contendrá todos los dispositivos Bluetooth. En este momento, esto solo es compatible con ChromeOS. Para otras plataformas, se muestra una lista completa.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Dispositivo

      Array de objeto que contiene información del dispositivo.

Muestra

  • Promesa<Dispositivo[]>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

startDiscovery()

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

Comienza el descubrimiento. Los dispositivos recién detectados se devolverán a través del evento onDeviceAdded. Los dispositivos descubiertos anteriormente que ya conocen el adaptador deben obtenerse con getDevices y solo se actualizarán con el evento onDeviceChanged si cambia la información sobre ellos.

La detección no se iniciará si esta aplicación ya llamó a startDiscovery. El descubrimiento puede requerir muchos recursos: se debe llamar a stopDiscovery lo antes posible.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

stopDiscovery()

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

Detener descubrimiento.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

Eventos

onAdapterStateChanged

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

Se activa cuando cambia el estado del adaptador de Bluetooth.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (state: AdapterState) => void

onDeviceAdded

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

Se activa cuando hay información disponible sobre un nuevo dispositivo Bluetooth.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (device: Device) => void

onDeviceChanged

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

Se activa cuando cambia la información sobre un dispositivo Bluetooth conocido.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (device: Device) => void

onDeviceRemoved

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

Se activa cuando un dispositivo Bluetooth detectado previamente permanece fuera de alcance durante el tiempo suficiente como para volver a considerarse no disponible y cuando se quita un dispositivo vinculado.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (device: Device) => void