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
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
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 posterioresLa batería restante del dispositivo.
-
conectable
booleano opcional
Chrome 48 y versiones posterioresIndica si el dispositivo es conectable.
-
Conectado
booleano opcional
Indica si el dispositivo está conectado al sistema actualmente.
-
Conectar
booleano opcional
Chrome 48 y versiones posterioresIndica 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 posterioresLa 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 posterioresEs 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 posterioresEs 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 campodeviceClass
. -
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
Tipos para filtrar dispositivos Bluetooth.
Enum
“todos”
“conocido”
Transport
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()
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
Objeto que contiene la información del adaptador.
-
Muestra
-
Promise<AdapterState>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getDevice()
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
Objeto que contiene la información del dispositivo.
-
Muestra
-
Promise<Device>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getDevices()
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 posterioresAlgunos 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
Array de objeto que contiene información del dispositivo.
-
Muestra
-
Promesa<Dispositivo[]>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
startDiscovery()
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 posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
stopDiscovery()
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 posterioresLas 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
-
state
-
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
-
dispositivo
-
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
-
dispositivo
-
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
-
dispositivo
-