bt

9 min

El objeto bt 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 con otro dispositivo.

IDL de bt

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 primero cargue el módulo brightsign/bt usando el método require() . Luego cree una instancia de la clase bt .

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

BtCentralAdvertisingReportEvent

adapter_path string required: El adaptador al que pertenece el dispositivo de anuncios

dirección_del_dispositivo string required: El identificador de un dispositivo de anuncios remoto

rssi int required: La intensidad de señal del dispositivo cuando se informa un anuncio

datos Array<byte> required: Datos de anuncios

BtCentralDeviceFoundEvent

Indica si se encuentra un dispositivo Bluetooth durante el escaneo

adapter_path string required: El adaptador al que pertenece el dispositivo de anuncios

dirección string required: La dirección Bluetooth única del dispositivo

alias string required: Un nombre alternativo para el dispositivo remoto

nombre string optional: El nombre del dispositivo Bluetooth

rssi int optional: La intensidad de señal del dispositivo

tx_power int optional: El nivel de potencia transmitida del dispositivo

uuids Array<String> optional: cadenas UUID

advertising_flags Array<byte> optional: Las marcas utilizadas para la publicidad

manufacturer_data Array<Array<int, Array<byte>>> optional: Los datos de publicidad específicos del fabricante indexados por ID de fabricante

service_data Map<String, Array<byte>> optional: Los datos de publicidad del servicio indexados por UUID

BtCentralDeviceLostEvent

Se utiliza para informar cuando se pierde un dispositivo Bluetooth.

adapter_path string required: El adaptador al que pertenece el dispositivo de publicidad

dirección string required: La dirección Bluetooth única del dispositivo

BtCentral

Utilice esta interfaz para realizar acciones en conexiones de transmisión Bluetooth.

getAdapters()

Promise<Array<Adapter>> getAdapters()

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

scan()

Promise<void> scan(optional ScanParameters)

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

Parámetros de escaneo optional:

stopScan()

Promise<void> stopScan()

Detiene el escaneo y el informe de nuevos dispositivos Bluetooth

reset()

Promise<void> reset()

Intentará recuperar una pila Bluetooth si deja de responder

addEventListener

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 para obtener más información.

removeEventListener

removeEventListener(BtCentralEventType type, BtCentralEventCallback callback)

Utilice este método para eliminar un detector de eventos. Consulte Gestión de eventos en JavaScript para obtener más información.

Adapter

En las 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 de la matriz es el número de adaptadores Bluetooth instalados.

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

nombre string:

alimentado por bool: Si el adaptador está encendido o no

ScanParameters

Esta interfaz contiene información sobre un dispositivo de transmisión Bluetooth escaneado:

advertisingReports bool: Indica si el escaneo de anuncios está activo o no.