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 el formato "XX:XX:XX:XX:XX:XX"

  • disponible

    booleano

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

  • descubrir

    booleano

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

  • nombre

    string

    Es el nombre legible del adaptador.

  • con la tecnología de

    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

    número opcional

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

Device

Propiedades

  • dirección

    string

    La dirección del dispositivo, en el 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.

  • Conectar

    booleano opcional

    Chrome 48 y versiones posteriores

    Indica si el dispositivo se está conectando al sistema.

  • deviceClass

    número opcional

    Es 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

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

  • nombre

    cadena opcional

    Es el nombre legible del dispositivo.

  • vinculado

    booleano opcional

    Indica si el dispositivo está vinculado o no con el 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. Esto 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

    UUIDs 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 del EIR y las tablas del 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 con modo dual, se puede obtener de ambos.

  • vendorId

    número opcional

  • vendorIdSource

    VendorIdSource: Opcional

    El registro de ID de dispositivo, si está disponible

DeviceType

Tipos de dispositivos comunes que reconoce Chrome.

Enum

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 y versiones posteriores

Son tipos para filtrar dispositivos Bluetooth.

Enum

"all"

"known"

Transport

Chrome 76 y versiones posteriores

Es el tipo de transporte del dispositivo Bluetooth.

Enum

"invalid"

"classic"

"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 se admiten para 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

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

getDevices()

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

Obtener una lista de los dispositivos Bluetooth conocidos por el sistema, incluidos los dispositivos vinculados y 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 el filtro no está establecido o se establece en {}, la lista de dispositivos que se muestra contendrá todos los dispositivos Bluetooth. Por el momento, esta función solo es compatible con ChromeOS. En el caso de 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

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

startDiscovery()

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

Inicia el descubrimiento. Los dispositivos descubiertos recientemente se mostrará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 ser intensivo en 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 para Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

stopDiscovery()

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

Detén 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 para 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

    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 de 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 para que se vuelva a considerar 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