chrome.bluetooth

Descripción

Usa la API de chrome.bluetooth para conectarte a un dispositivo Bluetooth. Todas las funciones informan errores 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

    Dirección del adaptador, con el formato "XX:XX:XX:XX:XX:XX".

  • disponible

    booleano

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

  • descubrir

    booleano

    Indica si el adaptador está buscando dispositivos actualmente.

  • nombre

    string

    Es el nombre del adaptador legible por humanos.

  • alimentado

    booleano

    Indica si el adaptador tiene energía 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. El valor predeterminado es all.

  • límite

    número opcional

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

Device

Propiedades

  • dirección

    string

    Dirección del dispositivo, en el formato "XX:XX:XX:XX:XX:XX".

  • batteryPercentage

    número opcional

    Chrome 77 y versiones posteriores

    Es la batería restante del dispositivo.

  • connectable

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si el dispositivo se puede conectar.

  • Conectado

    booleano opcional

    Indica si el dispositivo está conectado actualmente al sistema.

  • Conectar

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si el dispositivo se está conectando al sistema.

  • deviceClass

    número opcional

    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

    Es la intensidad de la señal recibida, en dBm. Este campo está disponible y es 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 transmitida. Este campo solo está disponible para los dispositivos LE que lo incluyen en AD. Está disponible y es válido solo durante el descubrimiento.

  • nombre

    cadena opcional

    Es el nombre del dispositivo legible por humanos.

  • vinculado

    booleano opcional

    Indica si el dispositivo está vinculado al sistema.

  • 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. Este valor se obtiene del campo deviceClass y solo representa una pequeña fracción de los tipos de dispositivos posibles. En caso de duda, debes usar el campo deviceClass directamente.

  • uuids

    string[] opcional

    Son los UUID de los protocolos, los perfiles y los servicios que anuncia el dispositivo. En el caso de los dispositivos Bluetooth clásicos, esta lista se obtiene de los datos de EIR y las tablas de SDP. En el caso de 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 doble, se puede obtener de ambos.

  • vendorId

    número opcional

  • vendorIdSource

    VendorIdSource opcional

    Es el registro del ID del dispositivo, si está disponible.

DeviceType

Tipos de dispositivos comunes que reconoce Chrome.

Enum

"computadora"

"phone"

"modem"

"audio"

"carAudio"

"video"

"periférico"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 y versiones posteriores

Son los tipos para filtrar dispositivos Bluetooth.

Enum

"all"

"known"

Transport

Chrome 76 y versiones posteriores

Es el tipo de transporte del dispositivo Bluetooth.

Enum

"invalid"

"clásico"

"le"

"dual"

VendorIdSource

Son las autoridades de asignación de los IDs de proveedor.

Enum

"bluetooth"

"usb"

Métodos

getAdapterState()

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

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 se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getDevice()

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

Obtiene información sobre un dispositivo Bluetooth conocido por el sistema.

Parámetros

  • deviceAddress

    string

    Es la dirección del dispositivo que se obtendrá.

  • 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 se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getDevices()

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

Obtener una lista de los dispositivos Bluetooth que conoce el sistema, incluidos los dispositivos vinculados y los que se descubrieron recientemente

Parámetros

  • filtrar

    BluetoothFilter opcional

    Chrome 67 y versiones posteriores

    Son algunos criterios para filtrar la lista de dispositivos Bluetooth devueltos. Si el filtro no está configurado o se establece en {}, la lista de dispositivos devuelta contendrá todos los dispositivos Bluetooth. Por el momento, esta función solo es compatible con ChromeOS. En otras plataformas, se devuelve una lista completa.

  • callback

    función opcional

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      Device[]

      Es un array de objetos que contiene información del dispositivo.

Muestra

  • Promise<Device[]>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

startDiscovery()

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

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

El descubrimiento no se iniciará si esta aplicación ya llamó a startDiscovery. El descubrimiento puede consumir muchos recursos, por lo que 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

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

stopDiscovery()

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

Detiene el descubrimiento.

Parámetros

  • callback

    función opcional

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

    () => void

Muestra

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en 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 que se descubrió anteriormente estuvo fuera del alcance durante el tiempo suficiente como para considerarse no disponible nuevamente 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