chrome.bluetooth

Descripción

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

Manifest

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

"bluetooth"

Tipos

AdapterState

Propiedades

  • de la página web.

    cadena

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

  • name

    cadena

    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

    Tipo de filtro que se aplicará a la lista de dispositivos. La opción predeterminada es Todas.

  • límite

    número opcional

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

Device

Propiedades

  • de la página web.

    cadena

    Es 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 se puede conectar.

  • Conectado

    booleano opcional

    Indica si el dispositivo está conectado actualmente al sistema.

  • con conexión

    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 es válido solo durante el descubrimiento. Fuera del descubrimiento, no se especifica su valor.

  • inquiryTxPower

    número opcional

    Chrome 44 y versiones posteriores

    El nivel de potencia transmitida. Este campo solo está disponible para los dispositivos LE que incluyen este campo en AD. Están disponibles y son válidas solo durante el descubrimiento.

  • name

    cadena opcional

    Es el nombre legible del dispositivo.

  • vinculado

    booleano opcional

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

  • productId

    número opcional

  • transport

    Transporte opcional

    Chrome 76 y versiones posteriores

    Es el tipo de transporte del dispositivo Bluetooth.

  • tipo

    DeviceType opcional

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

  • uuid

    string[] opcional

    UUID de protocolos, perfiles y servicios que anuncia el dispositivo Para 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 dual, esto se puede obtener de ambos.

  • vendorId

    número opcional

  • vendorIdSource

    VendorIdSource opcional

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

DeviceType

Tipos de dispositivos comunes reconocidos por Chrome.

Enum

"carAudio"

"mouse"

FilterType

Chrome 67 y versiones posteriores

Tipos para filtrar dispositivos Bluetooth.

Enum

Transport

Chrome 76 y versiones posteriores

Tipo de transporte del dispositivo Bluetooth.

Enum

VendorIdSource

Autoridades de asignación para los IDs de proveedor.

Enum

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

Devuelve

  • 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 que el sistema conoce

Parámetros

  • deviceAddress

    cadena

    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

      Es el objeto que contiene la información del dispositivo.

Devuelve

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

getDevices()

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

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

Parámetros

  • filter

    BluetoothFilter opcional

    Chrome 67 y versiones posteriores

    Algunos criterios para filtrar la lista de dispositivos Bluetooth mostrados Si el filtro no se establece o se establece como {}, la lista de dispositivos que se devuelve contendrá todos los dispositivos Bluetooth. Por el 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

      Arreglo de objetos que contiene información del dispositivo.

Devuelve

  • Promesa<Device[]>

    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 descubiertos recientemente se devolverán a través del evento onDeviceAdded. Los dispositivos descubiertos anteriormente que ya conoce el adaptador deben obtenerse con getDevices y solo se actualizarán con el evento onDeviceChanged si cambia su información.

La detección no se iniciará si esta aplicación ya llamó a startDiscovery. El descubrimiento puede requerir 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

Devuelve

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

Devuelve

  • Promise<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 Bluetooth.

Parámetros

  • callback

    la 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

    la 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 de un dispositivo Bluetooth conocido.

Parámetros

  • callback

    la 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 para que se considere no disponible nuevamente y cuando se quita un dispositivo vinculado.

Parámetros

  • callback

    la función

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

    (device: Device)=>void