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.

Disponibilidad

Solo en ChromeOS

Manifiesto

Las siguientes claves se deben declarar en el manifiesto para usar esta API.

"bluetooth"

Tipos

AdapterState

Propiedades

  • dirección

    string

    Es la dirección del adaptador, en el formato "XX:XX:XX:XX:XX:XX".

  • disponible

    booleano

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

  • descubrimiento

    booleano

    Indica si el adaptador está realizando un descubrimiento en este momento.

  • nombre

    string

    Es el nombre legible por humanos del adaptador.

  • potenciado

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

  • límite

    number opcional

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

Device

Propiedades

  • dirección

    string

    Es la dirección del dispositivo, en el formato "XX:XX:XX:XX:XX:XX".

  • batteryPercentage

    number opcional

    Chrome 77 y versiones posteriores

    La batería restante del dispositivo.

  • connectable

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si se puede conectar el dispositivo.

  • Conectado

    booleano opcional

    Indica si el dispositivo está conectado al sistema en este momento.

  • Conectar

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si el dispositivo se está conectando al sistema en este momento.

  • deviceClass

    number opcional

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

  • deviceId

    number opcional

  • inquiryRssi

    number 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

    number opcional

    Chrome 44 y versiones posteriores

    Es el nivel de potencia transmitido. 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

    string opcional

    Es el nombre legible por humanos del dispositivo.

  • vinculado

    booleano opcional

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

  • productId

    number opcional

  • transporte

    Transport opcional

    Chrome 76 o versiones posteriores

    Es el tipo de transporte del dispositivo Bluetooth.

  • tipo

    DeviceType opcional

    Es el tipo de dispositivo, si Chrome lo reconoce. Esto se obtiene del campo deviceClass y solo representa una pequeña fracción de los posibles tipos de dispositivos. En caso de duda, debes usar el campo deviceClass directamente.

  • uuids

    string[] opcional

    Son los UUID de los protocolos, perfiles y 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

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

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 y versiones posteriores

Tipos para filtrar dispositivos Bluetooth.

Enum

"all"

"known"

Transport

Chrome 76 o versiones posteriores

Es el tipo de transporte del dispositivo Bluetooth.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Son las autoridades de asignación de IDs de proveedores.

Enum

"bluetooth"

"usb"

Métodos

getAdapterState()

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

Obtener información sobre el adaptador de Bluetooth

Parámetros

  • callback

    función opcional

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Es el 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()

Promise 
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

      Es un 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()

Promise 
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 descubiertos recientemente

Parámetros

  • filter

    BluetoothFilter opcional

    Chrome 67 y versiones posteriores

    Son algunos criterios para filtrar la lista de dispositivos Bluetooth que se muestran. Si no se establece el filtro o se establece en {}, la lista de dispositivos devuelta contendrá todos los dispositivos Bluetooth. Por el momento, esto solo se admite en ChromeOS. Para 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

      Dispositivo[]

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

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

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

Detener 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 de alcance durante el tiempo suficiente como para que se considere no disponible de nuevo 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