Descripción
Usa la API de chrome.bluetooth
para conectarte a un dispositivo Bluetooth. Todas las funciones informan fallas mediante chrome.runtime.lastError.
Manifest
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
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 pueden devolver. 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 posterioresLa batería restante del dispositivo.
-
conectable
booleano opcional
Chrome 48 y versiones posterioresIndica 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 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 es válido solo durante el descubrimiento. Fuera del descubrimiento, no se especifica su valor.
-
inquiryTxPower
número opcional
Chrome 44 y versiones posterioresEl 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 posterioresEs 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 campodeviceClass
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
Tipos para filtrar dispositivos Bluetooth.
Enum
Transport
Tipo de transporte del dispositivo Bluetooth.
Enum
VendorIdSource
Autoridades de asignación para los IDs de proveedor.
Enum
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
-
Devuelve
-
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 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
Es el objeto que contiene la información del dispositivo.
-
Devuelve
-
Promesa<Dispositivo>
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 conoce el sistema, incluidos los dispositivos vinculados y detectados recientemente.
Parámetros
-
filter
BluetoothFilter opcional
Chrome 67 y versiones posterioresAlgunos 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
Arreglo de objetos que contiene información del dispositivo.
-
Devuelve
-
Promesa<Device[]>
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 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 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
Devuelve
-
Promise<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 Bluetooth.
Parámetros
-
callback
la 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
la 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 de un dispositivo Bluetooth conocido.
Parámetros
-
callback
la 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 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
-
dispositivo
-