Descripción
La API de chrome.bluetoothLowEnergy
se usa para comunicarse con dispositivos Bluetooth Smart (de bajo consumo) a través del perfil de atributo genérico (GATT).
Manifest
Tipos
Advertisement
Propiedades
-
manufacturerData
ManufacturerData[] opcional
Es la lista de datos específicos del fabricante que se incluirán en los campos "Datos específicos del fabricante" de los datos publicitarios.
-
serviceData
ServiceData[] opcional
Es la lista de datos del servicio que se incluirán en los campos de "Datos del servicio" de los datos de publicidad.
-
serviceUuids
string[] opcional
Lista de UUID que se incluirán en el campo "UUID de servicio" de los datos publicitarios. Estos UUID pueden tener los formatos de 16 bits, 32 bits o 128.
-
solicitUuids
string[] opcional
Lista de UUID que se incluirán en el campo "Solicitar UUID" de los datos publicitarios. Estos UUID pueden tener los formatos de 16 bits, 32 bits o 128.
-
tipo
Es el tipo de anuncio.
AdvertisementType
Es el tipo de anuncio. Si se elige "broadcast" (emitir), el tipo de anuncio enviado será ADV_NONCONN_IND y el dispositivo transmitirá con una dirección MAC aleatoria. Si lo estableces como "periférico", el tipo de anuncio será ADV_IND o ADV_SCAN_IND, y el dispositivo transmitirá con la dirección MAC real del adaptador de Bluetooth.
Enum
Characteristic
Propiedades
-
instanceId
cadena opcional
Muestra el identificador asignado a esta característica. Usa el ID de instancia para distinguir entre características de un periférico con el mismo UUID y realizar llamadas a funciones que tengan un identificador de características. Presente si esta instancia representa una característica remota.
-
properties
Son las propiedades de esta característica.
-
servicio
Servicio opcional
El servicio GATT al que pertenece esta característica
-
uuid
cadena
El UUID de la característica, p.ej., 00002a37-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer opcional
El valor de característica almacenado en caché actualmente. Este valor se actualiza cuando el valor de la característica se lee o se actualiza a través de una notificación o indicación.
CharacteristicProperty
Valores que representan las posibles propiedades de una característica Los permisos de características se infieren de estas propiedades. Consulta las especificaciones de Bluetooth 4.x para conocer el significado de cada propiedad individual.
Enum
"writeWithoutResponse"
"authenticatedSignedWrites"
"writableAuxiliaries"
"encryptRead"
"encryptAuthenticatedRead"
"encryptAuthenticatedWrite"
ConnectProperties
Propiedades
-
persistentes
boolean
Marca que indica si una conexión con el dispositivo se deja abierta cuando se descarga la página del evento de la aplicación (consulta Cómo administrar el ciclo de vida de la app). El valor predeterminado es
false.
.
Descriptor
Propiedades
-
característico
Característica opcional
Es la característica GATT a la que pertenece este descriptor.
-
instanceId
cadena opcional
Muestra el identificador asignado a este descriptor. Usa el ID de instancia para distinguir entre descriptores de un periférico con el mismo UUID y realizar llamadas a funciones que tomen un identificador de descriptor. Presente si esta instancia representa una característica remota.
-
permisosChrome 52 y versiones posteriores
Son los permisos de este descriptor.
-
uuid
cadena
El UUID del descriptor de característica, p.ej., 00002902-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer opcional
El valor del descriptor almacenado en caché actualmente. Este valor se actualiza cuando se lee el valor del descriptor.
DescriptorPermission
Valores que representan posibles permisos para un descriptor. Consulta las especificaciones de Bluetooth 4.x para ver el significado de cada permiso individual.
Enum
"encryptedRead"
"encryptedWrite"
"encryptedAuthenticatedRead"
"encryptedAuthenticatedWrite"
Device
Propiedades
-
de la página web.
cadena
Es la dirección del dispositivo en formato "XX:XX:XX:XX:XX:XX".
-
deviceClass
número opcional
La clase del dispositivo, un campo de bits definido por http://www.Bluetooth.org/en-us/specification/assigned-numbers/baseband.
-
name
cadena opcional
Es el nombre legible del dispositivo.
ManufacturerData
Propiedades
-
datos
número
-
id
número
Notification
Propiedades
-
shouldIndicate
booleano opcional
Marca opcional para enviar una indicación en lugar de una notificación.
-
value
ArrayBuffer
Nuevo valor de la característica.
NotificationProperties
Propiedades
-
persistentes
boolean
Marca que indica si la app debe recibir notificaciones cuando se descarga la página del evento de la aplicación (consulta Cómo administrar el ciclo de vida de las apps) El valor predeterminado es
false
.
Request
Propiedades
-
dispositivo
Dispositivo que envía esta solicitud.
-
requestId
número
Es el ID único de esta solicitud. Usa este ID cuando respondas a esta solicitud.
-
value
ArrayBuffer opcional
Valor que se debe escribir (si es una solicitud de escritura).
Response
Propiedades
-
isError
boolean
Si esta es una respuesta de error, debería ser verdadera.
-
requestId
número
ID de la solicitud a la que responde esta solicitud.
-
value
ArrayBuffer opcional
Valor de respuesta. Las solicitudes de escritura y las respuestas de errores ignorarán este parámetro.
Service
Propiedades
-
deviceAddress
cadena opcional
Es la dirección del dispositivo del periférico remoto al que pertenece el servicio GATT. Presente si esta instancia representa un servicio remoto.
-
instanceId
cadena opcional
Muestra el identificador asignado a este servicio. Usa el ID de instancia para distinguir entre servicios de un periférico con el mismo UUID y realizar llamadas a funciones que acepten un identificador de servicio. Presente si esta instancia representa un servicio remoto.
-
isPrimary
boolean
Indica si el tipo de este servicio es principal o secundario.
-
uuid
cadena
El UUID del servicio, p.ej., 0000180d-0000-1000-8000-00805f9b34fb.
ServiceData
Propiedades
-
datos
número
-
uuid
cadena
Métodos
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
Establece una conexión entre la aplicación y el dispositivo con la dirección indicada. Es posible que un dispositivo ya esté conectado y que sus servicios GATT estén disponibles sin llamar a connect
. Sin embargo, una app que desee acceder a los servicios GATT de un dispositivo debe llamar a esta función para asegurarse de que se mantenga la conexión con el dispositivo. Si el dispositivo no está conectado, todos los servicios GATT del dispositivo se detectarán después de una llamada exitosa a connect
.
Parámetros
-
deviceAddress
cadena
Es la dirección Bluetooth del dispositivo remoto con el que se debe abrir una conexión GATT.
-
properties
ConnectProperties opcional
Propiedades de conexión (opcional)
-
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.
createCharacteristic()
chrome.bluetoothLowEnergy.createCharacteristic(
characteristic: Characteristic,
serviceId: string,
callback?: function,
)
Crea una característica GATT alojada localmente. Esta característica se debe alojar en un servicio válido. Si el ID de servicio no es válido, se establece el lastError. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
característico
La característica a crear.
-
serviceId
cadena
ID del servicio para el que se creará esta característica.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(characteristicId: string) => void
-
characteristicId
cadena
-
Devuelve
-
Promesa<string>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
createDescriptor()
chrome.bluetoothLowEnergy.createDescriptor(
descriptor: Descriptor,
characteristicId: string,
callback?: function,
)
Crea un descriptor GATT alojado localmente. Este descriptor se debe alojar bajo una característica válida. Si el ID de característica no es válido, se establece el lastError. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
descriptor
El descriptor que se creará.
-
characteristicId
cadena
Es el ID de la característica para la que se creará este descriptor.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(descriptorId: string) => void
-
descriptorId
cadena
-
Devuelve
-
Promesa<string>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
createService()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
Crear un servicio GATT alojado localmente. Este servicio puede registrarse para estar disponible en un servidor GATT local. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
servicio
El servicio que se creará.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(serviceId: string) => void
-
serviceId
cadena
-
Devuelve
-
Promesa<string>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
Cierra la conexión de la app con el dispositivo de la dirección indicada. Ten en cuenta que esto no siempre destruirá el vínculo físico en sí, ya que podría haber otras apps con conexiones abiertas.
Parámetros
-
deviceAddress
cadena
La dirección Bluetooth del dispositivo remoto.
-
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.
getCharacteristic()
chrome.bluetoothLowEnergy.getCharacteristic(
characteristicId: string,
callback?: function,
)
Obtén la característica GATT con el ID de instancia especificado que pertenece al servicio GATT específico, si existe.
Parámetros
-
characteristicId
cadena
El ID de instancia de la característica GATT solicitada.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Characteristic) => void
-
resultado
-
Devuelve
-
Promise<Characteristic>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getCharacteristics()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
Obtener una lista de todas las características GATT descubiertas que pertenecen al servicio determinado.
Parámetros
-
serviceId
cadena
ID de instancia del servicio GATT cuyas características se deben mostrar.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Characteristic[]) => void
-
resultado
-
Devuelve
-
Promise<Characteristic[]>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
Obtén el descriptor de característica GATT con el ID de instancia determinado.
Parámetros
-
descriptorId
cadena
El ID de instancia del descriptor de características GATT solicitado.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Descriptor) => void
-
resultado
-
Devuelve
-
Promise<Descriptor>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
Obtén una lista de descriptores de características GATT que pertenecen a la característica determinada.
Parámetros
-
characteristicId
cadena
ID de instancia de la característica GATT cuyos descriptores se deben mostrar.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Descriptor[]) => void
-
resultado
-
Devuelve
-
Promise<Descriptor[]>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
Obtén una lista de los servicios GATT que incluye el servicio determinado.
Parámetros
-
serviceId
cadena
Es el ID de la instancia del servicio GATT cuyos servicios incluidos se deben mostrar.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Service[]) => void
-
resultado
-
Devuelve
-
Promesa<Service[]>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
Obtén el servicio GATT con el ID de instancia dado.
Parámetros
-
serviceId
cadena
El ID de la instancia del servicio GATT solicitado.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Service) => void
-
resultado
-
Devuelve
-
Promesa<Service>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
Obtén todos los servicios GATT que se detectaron en el dispositivo remoto con la dirección del dispositivo determinada.
Nota: Si el descubrimiento de servicios aún no está completo en el dispositivo, esta API mostrará un subconjunto (posiblemente vacío) de servicios. Una solución alternativa es agregar un retraso basado en el tiempo o llamar repetidamente hasta que se devuelva la cantidad esperada de servicios.
Parámetros
-
deviceAddress
cadena
Es la dirección Bluetooth del dispositivo remoto cuyos servicios GATT se deben mostrar.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Service[]) => void
-
resultado
-
Devuelve
-
Promesa<Service[]>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
notifyCharacteristicValueChanged()
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
characteristicId: string,
notification: Notification,
callback?: function,
)
Notifica a un dispositivo remoto sobre un nuevo valor para una característica. Si el marcador shouldIndicate en el objeto de notificación es verdadero, se enviará una indicación en lugar de una notificación. Ten en cuenta que la característica debe establecer correctamente la propiedad “notify” o “indicar” durante la creación para que esta llamada tenga éxito. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
characteristicId
cadena
Característica para la que se envía la notificación.
-
notificación
-
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.
readCharacteristicValue()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
Recupera el valor de una característica específica desde un periférico remoto.
Parámetros
-
characteristicId
cadena
ID de instancia de la característica GATT cuyo valor debe leerse desde el dispositivo remoto.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Characteristic) => void
-
resultado
-
Devuelve
-
Promise<Characteristic>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
Recupera el valor de un descriptor de característica especificada desde un periférico remoto.
Parámetros
-
descriptorId
cadena
ID de instancia del descriptor de características GATT cuyo valor debe leerse desde el dispositivo remoto.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: Descriptor) => void
-
resultado
-
Devuelve
-
Promise<Descriptor>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
registerAdvertisement()
chrome.bluetoothLowEnergy.registerAdvertisement(
advertisement: Advertisement,
callback?: function,
)
Crea un anuncio y regístralo para publicidad. Para llamar a esta función, la app debe tener los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Además, esta API solo está disponible para apps iniciadas automáticamente en modo kiosco o mediante la configuración del interruptor de línea de comandos “--enable-ble-advertising-in-apps”. Visita https://developer.chrome.com/apps/manifest/Bluetooth Nota: En algunos modos de hardware, centrales y periféricos al mismo tiempo se admiten, pero en hardware que no lo admite, al realizar esta llamada, se cambiará el dispositivo al modo periférico. En el caso del hardware que no admita tanto el modo central como el periférico, intentar utilizar el dispositivo en ambos modos dará como resultado un comportamiento indefinido o evitará que otras aplicaciones de función central se comporten correctamente (incluido el descubrimiento de dispositivos Bluetooth de bajo consumo).
Parámetros
-
anuncio
Es el anuncio que se anunciará.
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(advertisementId: number) => void
-
advertisementId
número
-
Devuelve
-
Promesa<number>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
registerService()
chrome.bluetoothLowEnergy.registerService(
serviceId: string,
callback?: function,
)
Registra el servicio determinado con el servidor GATT local. Si el ID de servicio no es válido, se establecerá el lastError. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
serviceId
cadena
ID único de un servicio creado.
-
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.
removeService()
chrome.bluetoothLowEnergy.removeService(
serviceId: string,
callback?: function,
)
Quitar el servicio especificado y cancelar el registro si estaba registrado. Si el ID de servicio no es válido, se establecerá el lastError. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
serviceId
cadena
ID único de un servicio registrado actualmente.
-
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.
resetAdvertising()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
Restablece la publicidad en el dispositivo actual. Se cancelará el registro de todos los anuncios existentes y se detendrán.
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.
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
Envía una respuesta para una solicitud de lectura/escritura de característica o descriptor. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
respuesta
La respuesta a la solicitud.
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
El valor establecido es el intervalo entre dos anuncios consecutivos. Nota: Realizamos este mejor esfuerzo. El intervalo real puede variar considerablemente con respecto a los intervalos solicitados. En algunos hardware, hay un intervalo mínimo de 100 ms. Los valores mínimo y máximo no pueden exceder el rango permitido por la especificación Bluetooth 4.2.
Parámetros
-
minInterval
número
Intervalo mínimo entre anuncios (en milisegundos) No puede ser inferior a 20 ms (según las especificaciones).
-
maxInterval
número
Intervalo máximo entre anuncios (en milisegundos) Esto no puede superar los 10,240 ms (según la especificación).
-
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.
startCharacteristicNotifications()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
Habilita las notificaciones/indicaciones de valores a partir de la característica especificada. Una vez habilitada, una aplicación puede escuchar notificaciones con el evento onCharacteristicValueChanged
.
Parámetros
-
characteristicId
cadena
El ID de instancia de la característica GATT en la que deben habilitarse las notificaciones.
-
properties
NotificationProperties opcional
Propiedades de la sesión de notificaciones (opcional).
-
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.
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
Inhabilita las notificaciones o las indicaciones de valor de la característica especificada. Después de una llamada exitosa, la aplicación dejará de recibir notificaciones o indicaciones de esta característica.
Parámetros
-
characteristicId
cadena
El ID de instancia de la característica GATT en la que se debe detener la sesión de notificación de esta app
-
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.
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
Cancela el registro de un anuncio y detiene su publicidad. Si el anuncio no cancela el registro, la única forma de dejar de publicar anuncios podría ser reiniciar el dispositivo.
Parámetros
-
advertisementId
número
Es el ID del anuncio para cancelar el registro.
-
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.
unregisterService()
chrome.bluetoothLowEnergy.unregisterService(
serviceId: string,
callback?: function,
)
Cancela el registro del servicio determinado en el servidor GATT local. Si el ID de servicio no es válido, se establecerá el lastError. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
serviceId
cadena
ID único de un servicio registrado actualmente.
-
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.
writeCharacteristicValue()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
Escribe el valor de una característica específica desde un periférico remoto.
Parámetros
-
characteristicId
cadena
Es el ID de instancia de la característica GATT en el que se debe escribir el valor.
-
value
ArrayBuffer
El valor que se debe enviar a la característica remota como parte de la solicitud de escritura.
-
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.
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
Escribe el valor de un descriptor de característica especificada desde un periférico remoto.
Parámetros
-
descriptorId
cadena
El ID de instancia del descriptor de característica GATT en el que se debe escribir el valor.
-
value
ArrayBuffer
El valor que se debe enviar al descriptor remoto como parte de la solicitud de escritura.
-
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
onCharacteristicReadRequest
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
callback: function,
)
Se activa cuando un dispositivo central conectado solicita leer el valor de una característica registrada en el servidor GATT local. Si no respondes a esta solicitud durante mucho tiempo, es posible que se produzca una desconexión. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(request: Request, characteristicId: string) => void
-
request
-
characteristicId
cadena
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
Se activa cuando cambia el valor de una característica GATT remota, ya sea como resultado de una solicitud de lectura o una notificación o indicación de cambio de valor. Este evento solo se envía si la app habilitó las notificaciones llamando a startCharacteristicNotifications
.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(characteristic: Characteristic) => void
-
característico
-
onCharacteristicWriteRequest
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
Se activa cuando un dispositivo central conectado solicita escribir el valor de una característica registrada en el servidor GATT local. Si no respondes a esta solicitud durante mucho tiempo, es posible que se produzca una desconexión. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(request: Request, characteristicId: string) => void
-
request
-
characteristicId
cadena
-
onDescriptorReadRequest
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
callback: function,
)
Se activa cuando un dispositivo central conectado solicita leer el valor de un descriptor registrado en el servidor GATT local. Si no respondes a esta solicitud durante mucho tiempo, es posible que se produzca una desconexión. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(request: Request, descriptorId: string) => void
-
request
-
descriptorId
cadena
-
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
Se activa cuando cambia el valor de un descriptor de característica GATT remoto, generalmente como resultado de una solicitud de lectura. Este evento existe principalmente por motivos prácticos y siempre se enviará después de una llamada exitosa a readDescriptorValue
.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(descriptor: Descriptor) => void
-
descriptor
-
onDescriptorWriteRequest
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
callback: function,
)
Se activa cuando un dispositivo central conectado solicita escribir el valor de un descriptor registrado en el servidor GATT local. Si no respondes a esta solicitud durante mucho tiempo, es posible que se produzca una desconexión. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:periférico configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(request: Request, descriptorId: string) => void
-
request
-
descriptorId
cadena
-
onServiceAdded
chrome.bluetoothLowEnergy.onServiceAdded.addListener(
callback: function,
)
Se activó cuando se descubrió un nuevo servicio GATT en un dispositivo remoto.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(service: Service) => void
-
servicio
-
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
Se activa cuando cambia el estado de un servicio GATT remoto. Esto incluye cualquier característica o descriptor que se agregue o quite del servicio, así como notificaciones de "ServiceChanged" del dispositivo remoto.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(service: Service) => void
-
servicio
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Se activa cuando se quita un servicio GATT que se había descubierto anteriormente en un dispositivo remoto.