chrome.bluetoothLowEnergy

Descripción

La API de chrome.bluetoothLowEnergy se usa para comunicarse con dispositivos Bluetooth Smart (de bajo consumo) mediante el perfil de atributos genéricos (GATT).

Manifiesto

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

"bluetooth"

Tipos

Advertisement

Chrome 47 y versiones posteriores

Propiedades

  • manufacturerData

    ManufacturerData[] opcional

    Lista de datos específicos del fabricante que se incluirán en “Datos específicos del fabricante” campos de los datos de publicidad.

  • serviceData

    ServiceData[] opcional

    Lista de datos de servicio que se incluirán en “Datos de servicio” campos de los datos de publicidad.

  • serviceUuids

    string[] opcional

    Lista de UUID que se incluirán en “UUID de servicio” de los datos de publicidad. Estos UUID pueden ser de 16 bits, 32 bits o 128 formatos.

  • solicitUuids

    string[] opcional

    Lista de UUID que se deben incluir en la opción "Solicitar UUID" de los datos de publicidad. Estos UUID pueden ser de 16 bits, 32 bits o 128 formatos.

  • Es el tipo de anuncio.

AdvertisementType

Chrome 47 y versiones posteriores

Es el tipo de anuncio. Si se trata de “enviar” , el tipo de anuncio enviado será ADV_NONCONN_IND y el dispositivo transmitirá con una dirección MAC aleatoria. Si se configura como "peripheral", 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

“transmitir”

“periférico”

Characteristic

Propiedades

  • instanceId

    string 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 acepten un identificador de característica. Presente si esta instancia representa una característica remota.

  • properties

    CharacteristicProperty[]

    Son las propiedades de esta característica.

  • servicio

    Servicio opcional

    El servicio GATT al que pertenece esta característica.

  • uuid

    string

    El UUID de la característica, p.ej., 00002a37-0000-1000-8000-00805f9b34fb.

  • valor

    ArrayBuffer opcional

    Es el valor de característica almacenado en caché actualmente. Este valor se actualiza cuando se lee o actualiza el valor de la característica mediante 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 ver el significado de cada propiedad individual.

Enum

“transmitir”

“leer”

"writeWithoutResponse"

“write”

“notify”

“indicar”

"authenticatedSignedWrites"

“extendedProperties”

“reliableWrite”

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propiedades

  • persistentes

    boolean

    Marca que indica si una conexión con el dispositivo queda abierta cuando se descarga la página de eventos de la aplicación (consulta Cómo administrar el ciclo de vida de la app). El valor predeterminado es false..

Descriptor

Propiedades

  • característica

    Característica opcional

    La característica GATT a la que pertenece este descriptor.

  • instanceId

    string 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 acepten un identificador de descriptor. Presente si esta instancia representa una característica remota.

  • Chrome 52 y versiones posteriores

    Los permisos de este descriptor.

  • uuid

    string

    El UUID del descriptor de características, p.ej., 00002902-0000-1000-8000-00805f9b34fb.

  • valor

    ArrayBuffer opcional

    El valor del descriptor almacenado en caché actualmente. Este valor se actualiza cuando se lee el valor del descriptor.

DescriptorPermission

Chrome 52 y versiones posteriores

Valores que representan posibles permisos para un descriptor. Consulta las especificaciones de Bluetooth 4.x para ver el significado de cada permiso individual.

Enum

“leer”

“write”

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 y versiones posteriores

Propiedades

  • dirección

    string

    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.

  • nombre

    string opcional

    Es el nombre del dispositivo en lenguaje natural.

ManufacturerData

Chrome 47 y versiones posteriores

Propiedades

  • datos

    número

  • id

    número

Notification

Chrome 52 y versiones posteriores

Propiedades

  • shouldIndicate

    booleano opcional

    Marca opcional para enviar una indicación en lugar de una notificación.

  • valor

    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 de eventos de la aplicación (consulta Administra el ciclo de vida de la app). El valor predeterminado es false.

Request

Chrome 52 y versiones posteriores

Propiedades

  • dispositivo

    Dispositivo

    Dispositivo que envía esta solicitud.

  • requestId

    número

    Es el ID único de esta solicitud. Usa este ID cuando respondas esta solicitud.

  • valor

    ArrayBuffer opcional

    Valor para escribir (si es una solicitud de escritura).

Response

Chrome 52 y versiones posteriores

Propiedades

  • isError

    boolean

    Si se trata de una respuesta de error, debe ser verdadero.

  • requestId

    número

    Es el ID de la solicitud a la que se responde.

  • valor

    ArrayBuffer opcional

    Valor de la respuesta. Las solicitudes de escritura y las respuestas de error ignorarán este parámetro.

Service

Propiedades

  • deviceAddress

    string opcional

    La dirección del dispositivo del periférico remoto al que pertenece el servicio GATT. Presente, si la instancia representa un servicio remoto.

  • instanceId

    string opcional

    Devuelve 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 la instancia representa un servicio remoto.

  • esPrincipal

    boolean

    Indica si el tipo de este servicio es principal o secundario.

  • uuid

    string

    El UUID del servicio, p.ej., 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 y versiones posteriores

Propiedades

  • datos

    número

  • uuid

    string

Métodos

connect()

Promesa 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Establece una conexión entre la aplicación y el dispositivo con la dirección dada. Es posible que un dispositivo ya esté conectado y sus servicios GATT estén disponibles sin llamar a connect. Sin embargo, una app que quiera 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, se detectarán todos los servicios GATT del dispositivo después de una llamada exitosa a connect.

Parámetros

  • deviceAddress

    string

    Es la dirección Bluetooth del dispositivo remoto al 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

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

createCharacteristic()

Promesa Chrome 52 y versiones posteriores .
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Crea una característica GATT alojada de forma local. Esta característica se debe alojar en un servicio válido. Si el ID del 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:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • característica

    Característica

    La característica que se debe crear.

  • serviceId

    string

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

      string

Muestra

  • Promesa<string>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

createDescriptor()

Promesa Chrome 52 y versiones posteriores .
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Crea un descriptor GATT alojado localmente. Este descriptor debe estar alojado bajo una característica válida. Si el ID de característica 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:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • descriptor

    Descriptor

    El descriptor que se creará.

  • characteristicId

    string

    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

      string

Muestra

  • Promesa<string>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

createService()

Promesa Chrome 52 y versiones posteriores .
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:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • servicio

    Servicio

    El servicio que se creará.

  • callback

    función opcional

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

    (serviceId: string) => void

    • serviceId

      string

Muestra

  • Promesa<string>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

disconnect()

Promesa 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Cierra la conexión de la app al dispositivo con la dirección dada. Ten en cuenta que esta acción no siempre destruirá el vínculo físico en sí, ya que puede haber otras apps con conexiones abiertas.

Parámetros

  • deviceAddress

    string

    La dirección Bluetooth del dispositivo remoto.

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getCharacteristic()

Promesa 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Obtén la característica GATT con el ID de instancia dado que pertenece al servicio GATT determinado, si la característica existe.

Parámetros

  • characteristicId

    string

    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

Muestra

  • Promesa<Característica>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getCharacteristics()

Promesa 
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

    string

    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

Muestra

  • Promesa<Característica[]>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getDescriptor()

Promesa 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Obtiene el descriptor de característica GATT con el ID de instancia dado.

Parámetros

  • descriptorId

    string

    ID de instancia del descriptor de característica GATT solicitado.

  • callback

    función opcional

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

    (result: Descriptor) => void

Muestra

  • Promise&lt;Descriptor&gt;

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getDescriptors()

Promesa 
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

    string

    El 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

Muestra

  • Promise&lt;Descriptor[]&gt;

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getIncludedServices()

Promesa 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Obtener una lista de los servicios GATT que incluye el servicio determinado

Parámetros

  • serviceId

    string

    Es el ID de 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

Muestra

  • Promesa<Servicio[]>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getService()

Promesa 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

Obtén el servicio GATT con el ID de instancia determinado.

Parámetros

  • serviceId

    string

    ID de instancia del servicio GATT solicitado.

  • callback

    función opcional

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

    (result: Service) => void

Muestra

  • Promise&lt;Service&gt;

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getServices()

Promesa 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Obtén todos los servicios GATT que se descubrieron en el dispositivo remoto con la dirección de dispositivo determinada.

Nota: Si aún no se completó la detección de servicios en el dispositivo, esta API mostrará un subconjunto (posiblemente vacío) de servicios. Una solución es agregar un retraso basado en tiempo o una llamada repetida hasta que se devuelva la cantidad esperada de servicios.

Parámetros

  • deviceAddress

    string

    La dirección Bluetooth del dispositivo remoto cuyos servicios GATT deben devolverse.

  • callback

    función opcional

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

    (result: Service[]) => void

Muestra

  • Promesa<Servicio[]>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

notifyCharacteristicValueChanged()

Promesa Chrome 52 y versiones posteriores .
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Notifica a un dispositivo remoto sobre un valor nuevo para una característica. Si la marca shouldIndicate en el objeto de notificación es verdadera, se enviará una indicación en lugar de una notificación. Ten en cuenta que la característica debe establecer correctamente el parámetro “notify” o "indicar" durante la creación para que esta llamada se realice correctamente. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • characteristicId

    string

    La característica para la que se envía la notificación.

  • notificación

    Notificación

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

readCharacteristicValue()

Promesa 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

Recupera el valor de una característica especificada desde un periférico remoto.

Parámetros

  • characteristicId

    string

    El ID de instancia de la característica GATT cuyo valor se debe leer desde el dispositivo remoto.

  • callback

    función opcional

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

    (result: Characteristic) => void

Muestra

  • Promesa<Característica>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

readDescriptorValue()

Promesa 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Recupera el valor de un descriptor de característica especificado desde un periférico remoto.

Parámetros

  • descriptorId

    string

    El ID de instancia del descriptor de característica GATT cuyo valor se debe leer desde el dispositivo remoto.

  • callback

    función opcional

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

    (result: Descriptor) => void

Muestra

  • Promise&lt;Descriptor&gt;

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

registerAdvertisement()

Promesa Chrome 47 y versiones posteriores .
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Crear un anuncio y registrarlo para que se publiquen anuncios en él Para llamar a esta función, la app debe tener los permisos Bluetooth:low_energy y Bluetooth:peripheral configurados como verdaderos. Además, esta API solo está disponible para aplicaciones iniciadas automáticamente en modo kiosco o con la configuración del parámetro "--enable-ble-advertising-in-apps" de línea de comandos. Consulta https://developer.chrome.com/apps/manifest/Bluetooth Nota: En algunos dispositivos de hardware, se admiten al mismo tiempo los modos central y periférico, pero en hardware que no lo admite. Si realizas esta llamada, se cambiará el dispositivo al modo periférico. En el caso del hardware que no admita ambos modos tanto en el modo central como en el periférico, intentar usar el dispositivo en ambos modos generará un comportamiento indefinido o evitará que otras aplicaciones de funciones centrales se comporten correctamente (incluido el descubrimiento de dispositivos Bluetooth de bajo consumo).

Parámetros

  • anuncio

    Publicidad

    El anuncio que se va a anunciar.

  • callback

    función opcional

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

    (advertisementId: number) => void

    • advertisementId

      número

Muestra

  • Promise&lt;number&gt;

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

registerService()

Promesa Chrome 52 y versiones posteriores .
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Registra el servicio determinado con el servidor GATT local. Si el ID del 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:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • serviceId

    string

    Es el ID único de un servicio creado.

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

removeService()

Promesa Chrome 52 y versiones posteriores .
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Quita el servicio especificado y cancela el registro si estaba registrado. Si el ID del 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:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • serviceId

    string

    Es el ID único de un servicio registrado actualmente.

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

resetAdvertising()

Promesa Chrome 61 y versiones posteriores .
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Restablece la publicidad en el dispositivo actual. Esto cancelará el registro y detendrá todos los anuncios existentes.

Parámetros

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

sendRequestResponse()

Chrome 52 y versiones posteriores 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Envía una respuesta para una solicitud de lectura/escritura de características o descriptores. Esta función solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:peripheral establecidos en verdadero. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • respuesta

    Respuesta

    Es la respuesta a la solicitud.

setAdvertisingInterval()

Promesa Chrome 55 y versiones posteriores .
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Set es el intervalo entre dos anuncios consecutivos. Nota: Este es el mejor esfuerzo. El intervalo real puede variar de forma no trivial 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 de Bluetooth 4.2.

Parámetros

  • minInterval

    número

    Es el intervalo mínimo entre anuncios (en milisegundos). No puede ser inferior a 20 ms (según las especificaciones).

  • maxInterval

    número

    Es el intervalo máximo entre anuncios (en milisegundos). No puede superar los 10240 ms (según las especificaciones).

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

startCharacteristicNotifications()

Promesa 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

Habilita las notificaciones o indicaciones de valores de la característica especificada. Una vez habilitada, una aplicación puede escuchar las notificaciones mediante el evento onCharacteristicValueChanged.

Parámetros

  • characteristicId

    string

    Es el ID de instancia de la característica GATT en la que se deben habilitar las notificaciones.

  • properties

    NotificationProperties opcional

    Propiedades de la sesión de notificación (opcional)

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

stopCharacteristicNotifications()

Promesa 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Inhabilita las notificaciones/indicaciones de valor de la característica especificada. Si la llamada se realiza correctamente, la aplicación dejará de recibir notificaciones/indicaciones de esta característica.

Parámetros

  • characteristicId

    string

    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

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

unregisterAdvertisement()

Promesa Chrome 47 y versiones posteriores .
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Cancela el registro de un anuncio y deja de publicarlo. Si no se cancela el registro del anuncio, la única forma de detenerlo 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

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

unregisterService()

Promesa Chrome 52 y versiones posteriores .
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Cancela el registro del servicio determinado con el servidor GATT local. Si el ID del 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:peripheral configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • serviceId

    string

    Es el ID único de un servicio registrado actualmente.

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

writeCharacteristicValue()

Promesa 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

Escribe el valor de una característica especificada desde un periférico remoto.

Parámetros

  • characteristicId

    string

    ID de instancia de la característica GATT a cuyo valor se debe escribir.

  • valor

    ArrayBuffer

    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

Muestra

  • Promesa<void>

    Chrome 91 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

writeDescriptorValue()

Promesa 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

Escribe el valor de un descriptor de característica especificado desde un periférico remoto.

Parámetros

  • descriptorId

    string

    ID de instancia del descriptor de característica GATT al que se debe escribir el valor.

  • valor

    ArrayBuffer

    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

Muestra

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

onCharacteristicReadRequest

Chrome 52 y versiones posteriores 
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 esta solicitud durante mucho tiempo, es posible que se desconecte. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:peripheral configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • callback

    función

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

    (request: Request, characteristicId: string) => void

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 de una notificación o indicación de cambio de valor. Este evento solo se enviará si la app habilitó las notificaciones llamando a startCharacteristicNotifications.

Parámetros

  • callback

    función

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 y versiones posteriores 
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 esta solicitud durante mucho tiempo, es posible que se desconecte. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:peripheral configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • callback

    función

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

    (request: Request, characteristicId: string) => void

onDescriptorReadRequest

Chrome 52 y versiones posteriores 
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 esta solicitud durante mucho tiempo, es posible que se desconecte. Este evento solo está disponible si la app tiene los permisos Bluetooth:low_energy y Bluetooth:peripheral configurados como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • callback

    función

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

    (request: Request, descriptorId: string) => void

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

Se activa cuando cambia el valor de un descriptor de característica GATT remoto, por lo general, como resultado de una solicitud de lectura. Este evento existe principalmente para tu comodidad y siempre se enviará después de una llamada exitosa a readDescriptorValue.

Parámetros

  • callback

    función

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 y versiones posteriores 
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 esta solicitud durante mucho tiempo, es posible que se desconecte. Este evento solo está disponible si la app tiene establecidos los permisos Bluetooth:low_energy y bluetooth:peripheral como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • callback

    función

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

    (request: Request, descriptorId: string) => void

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

Se activó cuando se descubrió un nuevo servicio GATT en un dispositivo remoto.

Parámetros

  • callback

    función

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

    (service: Service) => void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

Se activa cuando cambia el estado de un servicio GATT remoto. Esto involucra cualquier característica o descriptores que se agreguen o quiten del servicio, además de "ServiceChanged" notificaciones del dispositivo remoto.

Parámetros

  • callback

    función

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

    (service: Service) => void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

Se activa cuando se quita un servicio GATT que se descubrió anteriormente en un dispositivo remoto.

Parámetros

  • callback

    función

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

    (service: Service) => void