---
title: bt
slug: develop/es/bt
docTags: 
createdAt: 2025-03-11T07:07:19.526Z
---

El objeto *bt* le permite comprobar si Bluetooth está instalado; establecer, supervisar o recuperar los anuncios BLE actuales; escanear dispositivos Bluetooth; y activar la conexión y desconexión de otro dispositivo.

**IDL de bt**

```javascript
enum BtCentralEventType {
    'advertising-report',
    'device-found',
    'device-lost'
};

interface BtCentralAdvertisingReportEvent {
    attribute String adapter_path;
    attribute String device_address;
    attribute int rssi;
    attribute Array<byte> data;
};

interface BtCentralDeviceFoundEvent {
    attribute String adapter_path;
    attribute String address;
    attribute String alias;
    [optional] attribute String name;
    [optional] attribute int rssi;
    [optional] attribute int tx_power;
    [optional] attribute Array<String> uuids;
    [optional] attribute Array<byte> advertising_flags;
    [optional] attribute Array<Array<int, Array<byte>>> manufacturer_data;
    [optional] attribute Map<String, Array<byte>> service_data;
};

interface BtCentralDeviceLostEvent {
    attribute String adapter_path;
    attribute String address;
};

typedef (BtCentralAdvertisingReportEvent | BtCentralDeviceFoundEvent | BtCentralDeviceLostEvent) BtCentralEvent;

callback BtCentralEventCallback = void (BtCentralEvent event);

interface BtCentral {
    Promise<Array<Adapter>> getAdapters();
    Promise<void> scan(optional ScanParameters);
    Promise<void> stopScan();

    void addEventListener(BtCentralEventType type, BtCentralEventCallback callback);
    void removeEventListener(BtCentralEventType type, BtCentralEventCallback callback);
};

interface Adapter {
    attribute String name;
    attribute bool powered;
};

interface ScanParameters {
    attribute bool advertisingReports;
};
```

## Creación de objetos

Para crear un objeto *bt&#x20;*&#x70;rimero cargue el módulo `brightsign/bt` usando el método `require()` . Luego cree una instancia de la clase *bt&#x20;*&#x20;.

```javascript
var btClass = require("@brightsign/bt");
var bt = new btClass();
```

## BtCentralAdvertisingReportEvent

- `adapter_path` <font color="#704ae0">string</font> <font color="#01a0af">required</font>:  El adaptador al que pertenece el dispositivo de anuncios
- `device_address` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: El identificador de un dispositivo remoto de anuncios
- `rssi` <font color="#704ae0">int</font> <font color="#01a0af">required</font>: La intensidad de señal del dispositivo cuando se informa un anuncio
- `datos` <font color="#704ae0">Array&lt;byte&gt;</font> <font color="#01a0af">required</font>: Datos del anuncio

## BtCentralDeviceFoundEvent

Indica si se encuentra un dispositivo Bluetooth durante el escaneo

- `adapter_path` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: El adaptador al que pertenece el dispositivo de anuncios
- `dirección` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: La dirección Bluetooth única del dispositivo
- `alias` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: Un nombre alternativo para el dispositivo remoto
- `nombre` <font color="#704ae0">string</font> <font color="#01a0af">optional</font>: El nombre del dispositivo Bluetooth
- `rssi` <font color="#704ae0">int</font> <font color="#01a0af">optional</font>: La intensidad de señal del dispositivo
- `tx_power` <font color="#704ae0">int</font> <font color="#01a0af">optional</font>: El nivel de potencia transmitida del dispositivo
- `uuids` <font color="#704ae0">Array&lt;String&gt;</font> <font color="#01a0af">optional</font>: cadenas UUID
- `advertising_flags` <font color="#704ae0">Array&lt;byte&gt;</font> <font color="#01a0af">optional</font>: Las marcas utilizadas para advertising
- `datos_del_fabricante` <font color="#704ae0">Array&lt;Array&lt;int, Array&lt;byte&gt;&gt;&gt;</font> <font color="#01a0af">optional</font>: Los datos de advertising específicos del fabricante indexados por id del fabricante
- `service_data` <font color="#704ae0">Map&lt;String, Array&lt;byte&gt;&gt;</font> <font color="#01a0af">optional</font>: Los datos de advertising del servicio indexados por UUID

## BtCentralDeviceLostEvent

Esto se utiliza para informar cuando se pierde un dispositivo Bluetooth.

- `adapter_path` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: El adaptador al que pertenece el dispositivo de advertising
- `dirección` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: La dirección Bluetooth única del dispositivo

## BtCentral

Utilice esta interfaz para realizar acciones en conexiones de streaming Bluetooth.

**getAdapters()**

:::BlockQuote
Promise\<Array\<Adapter>> getAdapters()
:::

Devuelve una matriz de cadenas de identidad del adaptador. El número de elementos en la matriz es el número de adaptadores Bluetooth instalados.

**scan()**

:::BlockQuote
Promise\<void> scan(optional ScanParameters)
:::

Informa sobre nuevos dispositivos Bluetooth a medida que se descubren. También es posible supervisar informes de advertising sin procesar.

- `ScanParameters` <font color="#01a0af">optional</font>:

**stopScan()**

:::BlockQuote
Promise\<void> stopScan()
:::

Detiene el escaneo y el informe de nuevos dispositivos Bluetooth

**addEventListener**

:::BlockQuote
addEventListener(BtCentralEventType type, BtCentralEventCallback callback)
:::

Este evento se genera cuando cambia el estado de Bluetooth. Utilice este método para escuchar este evento. Consulte [Gestión de eventos en JavaScript](docId\:PqIIPi27TFcO3ZuvJmnyX) para obtener más información.

**removeEventListener**

:::BlockQuote
removeEventListener(BtCentralEventType type, BtCentralEventCallback callback)
:::

Utilice este método para eliminar un detector de eventos. Consulte [Gestión de eventos en JavaScript](docId\:PqIIPi27TFcO3ZuvJmnyX) para obtener más información.

## Adapter

En versiones de BOS inferiores a 9.1.21 e inferiores a 9.0.198, esto devuelve una matriz de cadenas de identidad del adaptador. El número de elementos en la matriz es el número de adaptadores Bluetooth instalados.

En versiones de BOS superiores a 9.1.21 y 9.0.198, esto devuelve una matriz de objetos de adaptador.

- `nombre` <font color="#704ae0">string</font>:
- `alimentado` <font color="#704ae0">bool</font>: Indica si el adaptador está encendido o no

## ScanParameters

Esta interfaz contiene información sobre un dispositivo de streaming Bluetooth escaneado:&#x20;

- `advertisingReports` <font color="#704ae0">bool</font>: Indica si el escaneo de advertisements está activo o no.