bt

8 min

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

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

device_address string required: El identificador de un dispositivo remoto de anuncios

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

datos Array<byte> required: Datos del anuncio

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 advertising

datos_del_fabricante Array<Array<int, Array<byte>>> optional: Los datos de advertising específicos del fabricante indexados por id del fabricante

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

BtCentralDeviceLostEvent

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

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

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

BtCentral

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

getAdapters()

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()

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 optional:

stopScan()

Promise<void> stopScan()

Detiene el escaneo y el informe de nuevos dispositivos Bluetooth

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 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 string:

alimentado bool: Indica si el adaptador está encendido o no

ScanParameters

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

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