chrome.bluetoothLowEnergy

Descripción

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

Disponibilidad

Solo en ChromeOS

Manifiesto

Las siguientes claves se deben declarar en el manifiesto para usar esta API.

"bluetooth"

Tipos

Advertisement

Chrome 47 y versiones posteriores

Propiedades

  • manufacturerData

    ManufacturerData[] opcional

    Es la lista de datos específicos del fabricante que se incluirán en los campos "Manufacturer Specific Data" de los datos de anuncios.

  • serviceData

    ServiceData[] opcional

    Es la lista de datos de servicio que se incluirán en los campos "Datos de servicio" de los datos de publicidad.

  • serviceUuids

    string[] opcional

    Es la lista de UUID que se incluirán en el campo "UUID de servicio" de los datos de publicidad. Estos UUID pueden tener los formatos de 16, 32 o 128 bits.

  • solicitUuids

    string[] opcional

    Es la lista de UUID que se incluirán en el campo "Solicit UUIDs" de los datos de publicidad. Estos UUID pueden tener los formatos de 16, 32 o 128 bits.

  • Es el tipo de anuncio.

AdvertisementType

Chrome 47 y versiones posteriores

Es el tipo de anuncio. Si se elige "transmisión", el tipo de anuncio enviado será ADV_NONCONN_IND y el dispositivo transmitirá con una dirección MAC aleatoria. Si se establece en "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

"broadcast"

"peripheral"

Characteristic

Propiedades

  • instanceId

    string opcional

    Devuelve el identificador asignado a esta característica. Usa el ID de instancia para distinguir entre las características de un periférico con el mismo UUID y para realizar llamadas a funciones que toman un identificador de característica. Presente, si esta instancia representa una característica remota.

  • propiedades

    CharacteristicProperty[]

    Son las propiedades de esta característica.

  • servicio

    Service opcional

    Es el servicio de GATT al que pertenece esta característica.

  • uuid

    string

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

  • valor

    ArrayBuffer opcional

    Es el valor de la 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

Son valores que representan las posibles propiedades de una característica. Los permisos de las características se infieren de estas propiedades. Consulta la especificación de Bluetooth 4.x para ver el significado de cada propiedad individual.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propiedades

  • persistente

    booleano

    Marca que indica si se deja abierta una conexión al dispositivo 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..

Descriptor

Propiedades

  • característica

    Característica opcional

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

  • instanceId

    string opcional

    Devuelve el identificador asignado a este descriptor. Usa el ID de instancia para distinguir entre los descriptores de un periférico con el mismo UUID y para realizar llamadas a funciones que toman un identificador de descriptor. Presente, si esta instancia representa una característica remota.

  • Chrome 52 y versiones posteriores

    Son los permisos de este descriptor.

  • uuid

    string

    Es el UUID del descriptor de la característica, p.ej., 00002902-0000-1000-8000-00805f9b34fb.

  • valor

    ArrayBuffer opcional

    Es 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

Son valores que representan los permisos posibles para un descriptor. Consulta la especificación de Bluetooth 4.x para conocer el significado de cada permiso individual.

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 y versiones posteriores

Propiedades

  • dirección

    string

    Es la dirección del dispositivo, en el formato "XX:XX:XX:XX:XX:XX".

  • deviceClass

    number 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 legible por humanos del dispositivo.

ManufacturerData

Chrome 47 y versiones posteriores

Propiedades

  • datos

    number[]

  • id

    número

Notification

Chrome 52 y versiones posteriores

Propiedades

  • shouldIndicate

    booleano opcional

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

  • valor

    ArrayBuffer

    Es el valor nuevo de la característica.

NotificationProperties

Propiedades

  • persistente

    booleano

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

    Es el dispositivo que envía esta solicitud.

  • requestId

    número

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

  • valor

    ArrayBuffer opcional

    Es el valor que se escribirá (si se trata de una solicitud de escritura).

Response

Chrome 52 y versiones posteriores

Propiedades

  • isError

    booleano

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

  • requestId

    número

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

  • valor

    ArrayBuffer opcional

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

Service

Propiedades

  • deviceAddress

    string opcional

    Es la dirección del dispositivo del periférico remoto al que pertenece el servicio de GATT. Está presente si esta instancia representa un servicio remoto.

  • instanceId

    string opcional

    Devuelve el identificador asignado a este servicio. Usa el ID de instancia para distinguir entre los servicios de un periférico con el mismo UUID y para realizar llamadas a funciones que toman un identificador de servicio. Está presente si esta instancia representa un servicio remoto.

  • isPrimary

    booleano

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

  • uuid

    string

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

ServiceData

Chrome 47 y versiones posteriores

Propiedades

  • datos

    number[]

  • uuid

    string

Métodos

connect()

Promise 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

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

Parámetros

  • deviceAddress

    string

    Es la dirección de Bluetooth del dispositivo remoto al que se debe abrir una conexión GATT.

  • propiedades

    ConnectProperties opcional

    Son las propiedades de la conexión (opcional).

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

createCharacteristic()

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

Crea una característica de GATT alojada de forma local. Esta característica debe alojarse en un servicio válido. Si el ID de servicio no es válido, se establecerá lastError. Esta función solo está disponible si la app tiene los permisos bluetooth:low_energy y bluetooth:peripheral establecidos como verdaderos. 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 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

  • Promise<string>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

createDescriptor()

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

Crea un descriptor de GATT alojado de forma local. Este descriptor debe alojarse en una característica válida. Si el ID de la característica no es válido, se establecerá lastError. Esta función solo está disponible si la app tiene los permisos bluetooth:low_energy y bluetooth:peripheral establecidos como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • descriptor

    Descriptor

    Es el descriptor que se creará.

  • characteristicId

    string

    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

      string

Muestra

  • Promise<string>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

createService()

Promise Chrome 52 y versiones posteriores 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

Crea un servicio de GATT alojado de forma local. Este servicio se puede registrar para que esté 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 como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • servicio

    Servicio

    Es 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

  • Promise<string>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

disconnect()

Promise 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

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

Parámetros

  • deviceAddress

    string

    Es la dirección de Bluetooth del dispositivo remoto.

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

getCharacteristic()

Promise 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Obtiene la característica de GATT con el ID de instancia determinado que pertenece al servicio de GATT especificado, si existe la característica.

Parámetros

  • characteristicId

    string

    Es el ID de instancia de la característica de GATT solicitada.

  • callback

    función opcional

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

    (result: Characteristic) => void

Muestra

  • Promise<Characteristic>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getCharacteristics()

Promise 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

Obtiene una lista de todas las características de GATT descubiertas que pertenecen al servicio determinado.

Parámetros

  • serviceId

    string

    Es el ID de instancia del servicio de GATT cuyas características se deben devolver.

  • callback

    función opcional

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

    (result: Characteristic[]) => void

Muestra

  • Promise<Characteristic[]>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getDescriptor()

Promise 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Obtiene el descriptor de características de GATT con el ID de instancia determinado.

Parámetros

  • descriptorId

    string

    Es el ID de instancia del descriptor de características de GATT solicitado.

  • callback

    función opcional

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

    (result: Descriptor) => void

Muestra

  • Promise<Descriptor>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getDescriptors()

Promise 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

Obtiene una lista de descriptores de características de GATT que pertenecen a la característica determinada.

Parámetros

  • characteristicId

    string

    Es el ID de instancia de la característica de GATT cuyos descriptores se deben devolver.

  • callback

    función opcional

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

    (result: Descriptor[]) => void

Muestra

  • Promise<Descriptor[]>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getIncludedServices()

Promise 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

Obtiene una lista de los servicios de GATT que incluye el servicio determinado.

Parámetros

  • serviceId

    string

    Es el ID de instancia del servicio de GATT cuyos servicios incluidos se deben devolver.

  • callback

    función opcional

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

    (result: Service[]) => void

Muestra

  • Promise<Service[]>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getService()

Promise 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

Obtiene el servicio de GATT con el ID de instancia determinado.

Parámetros

  • serviceId

    string

    Es el ID de instancia del servicio de GATT solicitado.

  • callback

    función opcional

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

    (result: Service) => void

Muestra

  • Promise<Service>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getServices()

Promise 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

Obtiene todos los servicios de GATT que se descubrieron en el dispositivo remoto con la dirección de dispositivo proporcionada.

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

Parámetros

  • deviceAddress

    string

    Es la dirección de Bluetooth del dispositivo remoto cuyos servicios de GATT se deben devolver.

  • callback

    función opcional

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

    (result: Service[]) => void

Muestra

  • Promise<Service[]>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

notifyCharacteristicValueChanged()

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

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 la propiedad "notify" o "indicate" 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 como verdaderos. Es posible que el permiso de periféricos no esté disponible para todas las apps.

Parámetros

  • characteristicId

    string

    Es la característica para la que se enviará la notificación.

  • notificación

    Notificación

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

readCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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

Parámetros

  • characteristicId

    string

    Es el ID de instancia de la característica de 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

  • Promise<Characteristic>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

readDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

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

Parámetros

  • descriptorId

    string

    Es el ID de instancia del descriptor de características de 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<Descriptor>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

registerAdvertisement()

Promise Chrome 47 y versiones posteriores 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Crea un anuncio y regístralo para publicarlo. Para llamar a esta función, la app debe tener los permisos bluetooth:low_energy y bluetooth:peripheral establecidos como verdaderos. Además, esta API solo está disponible para las apps que se inician automáticamente en el modo kiosco o si se configura el interruptor de línea de comandos "--enable-ble-advertising-in-apps". Consulta https://developer.chrome.com/apps/manifest/bluetooth Nota: En algunos dispositivos de hardware, se admiten los modos central y periférico al mismo tiempo, pero en el hardware que no lo admite, realizar esta llamada cambiará el dispositivo al modo periférico. En el caso del hardware que no admite los modos central y periférico, intentar usar el dispositivo en ambos modos generará un comportamiento indefinido o impedirá que otras aplicaciones de rol central se comporten correctamente (incluido el descubrimiento de dispositivos Bluetooth de bajo consumo).

Parámetros

  • anuncio

    Anuncio

    El anuncio que se publicará.

  • callback

    función opcional

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

    (advertisementId: number) => void

    • advertisementId

      número

Muestra

  • Promise<number>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

registerService()

Promise Chrome 52 y versiones posteriores 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Registra el servicio determinado con el servidor GATT local. Si el ID de servicio no es válido, se establecerá lastError. Esta función solo está disponible si la app tiene los permisos bluetooth:low_energy y bluetooth:peripheral establecidos 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 creado.

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

removeService()

Promise Chrome 52 y versiones posteriores 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Quita el servicio especificado y cancela su registro si estaba registrado. Si el ID de servicio no es válido, se establecerá lastError. Esta función solo está disponible si la app tiene los permisos bluetooth:low_energy y bluetooth:peripheral establecidos 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 actual.

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

resetAdvertising()

Promise Chrome 61 y versiones posteriores 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

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

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

sendRequestResponse()

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

Envía una respuesta para una solicitud de lectura o escritura de una característica o un descriptor. Esta función solo está disponible si la app tiene los permisos bluetooth:low_energy y bluetooth:peripheral establecidos como verdaderos. 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()

Promise Chrome 55 y versiones posteriores 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

Establece el intervalo entre dos anuncios consecutivos. Nota: Esta es una operación de mejor esfuerzo. El intervalo real puede variar de forma no trivial con respecto a los intervalos solicitados. En algunos tipos de hardware, hay un intervalo mínimo de 100 ms. Los valores mínimo y máximo no pueden superar 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 la especificación).

  • maxInterval

    número

    Es el intervalo máximo entre anuncios (en milisegundos). No puede ser superior a 10,240 ms (según la especificación).

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

startCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

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

Parámetros

  • characteristicId

    string

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

  • propiedades

    NotificationProperties opcional

    Son las 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

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

stopCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

Inhabilita las notificaciones o 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

    string

    Es el ID de instancia de la característica de GATT en la que se debe detener la sesión de notificaciones de esta app.

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

unregisterAdvertisement()

Promise Chrome 47 y versiones posteriores 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

Cancela el registro de un anuncio y detiene su publicación. Si el anuncio no se puede cancelar, 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

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

unregisterService()

Promise Chrome 52 y versiones posteriores 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Cancela el registro del servicio determinado con el servidor GATT local. Si el ID de servicio no es válido, se establecerá lastError. Esta función solo está disponible si la app tiene los permisos bluetooth:low_energy y bluetooth:peripheral establecidos 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 actual.

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

writeCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

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

Parámetros

  • characteristicId

    string

    Es el ID de instancia de la característica de GATT en la que se debe escribir el valor.

  • valor

    ArrayBuffer

    Es 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

Muestra

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

writeDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

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

Parámetros

  • descriptorId

    string

    Es el ID de instancia del descriptor de características de GATT cuyo valor se debe escribir.

  • valor

    ArrayBuffer

    Es 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

Muestra

  • Promise<void>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en 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 a 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 establecidos 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

    • solicitud

      Solicitud

    • characteristicId

      string

onCharacteristicValueChanged

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

Se activa cuando cambia el valor de una característica de 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 a 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 establecidos 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

    • solicitud

      Solicitud

    • characteristicId

      string

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 a 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 establecidos 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 de GATT remoto, por lo general, como resultado de una solicitud de lectura. Este evento existe principalmente por conveniencia 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 a 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 establecidos 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 activa cuando se descubre un nuevo servicio de 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 de GATT remoto. Esto incluye cualquier característica o descriptor que se agregue o quite del servicio, así como las notificaciones "ServiceChanged" 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 de 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