0.0.3 • Published 1 year ago

laird-capacitor-plugin-android v0.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Laird Capacitor Plugin

This plugin is still in development and is not live on NPM yet!

A Capacitor plugin that communicates with bluetooth low energy laird devices. Supports older devices with the BluetoothAdapter and newer devices uses the BluetoothLeScanner.

Install

npm install laird-capacitor-plugin
npx cap sync

Example

// Import Laird and Device.
import { Laird, Device } from 'laird-capacitor-plugin';

// Initialize the listener first.
Laird.addListener("deviceFoundEvent", (device) => {
    console.log(device);
});

// Start discovering.
Laird.startDiscovering({ periodically: true });

API

startDiscovering(...)

startDiscovering(options?: { periodically: boolean; } | undefined) => any

Start the discovering process for finding bluetooth devices.

ParamType
options{ periodically: boolean; }

Returns: any


cancelDiscovering()

cancelDiscovering() => any

Cancels the discovering process for finding bluetooth devices.

Returns: any


connectToDevice(...)

connectToDevice(options: { address: string; }) => any

Connects to the specified device with the address.

ParamType
options{ address: string; }

Returns: any


disconnectFromDevice()

disconnectFromDevice() => any

Disconnects the current connected device.

Returns: any


sendDataToDevice(...)

sendDataToDevice(options: { data: string; }) => any

Sends data to the connected device.

ParamType
options{ data: string; }

Returns: any


addListener(...)

addListener(eventName: 'discoveryStartEvent', callback: () => void) => Promise<PluginListenerHandle> & PluginListenerHandle

DiscoveryStartEvent

ParamType
eventName"discoveryStartEvent"
callback() => void

Returns: any


addListener(...)

addListener(eventName: 'discoveryStopEvent', callback: () => void) => Promise<PluginListenerHandle> & PluginListenerHandle

DiscoveryStopEvent

ParamType
eventName"discoveryStopEvent"
callback() => void

Returns: any


addListener(...)

addListener(eventName: 'deviceFoundEvent', callback: (device: Device) => void) => Promise<PluginListenerHandle> & PluginListenerHandle

DeviceFoundListener

ParamTypeDescription
eventName"deviceFoundEvent"DeviceFoundEvent
callback(device: Device) => voidCallback

Returns: any


addListener(...)

addListener(eventName: 'deviceRecvDataEvent', callback: (data: DeviceData) => void) => Promise<PluginListenerHandle> & PluginListenerHandle

DeviceRecvDataListener

ParamTypeDescription
eventName"deviceRecvDataEvent"DeviceRecvDataEvent
callback(data: DeviceData) => voidCallback

Returns: any


Interfaces

PluginListenerHandle

PropType
remove() => any

Device

PropType
namestring
typenumber
addressstring
rssinumber

DeviceData

PropType
datastring