Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rebellapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this API to get all Bluetooth devices discovered during the current session, including devices that are no longer in range.

​
Parameters

PropertyTypeRequiredDescription
successFunctionNoCallback on success
failFunctionNoCallback on failure
completeFunctionNoCallback that always executes

​
Success Callback Parameters

PropertyTypeDescription
devicesArrayList of discovered devices

​
Device Object Properties

PropertyTypeDescription
deviceIdStringDevice identifier
nameStringDevice name (may be empty)
RSSINumberSignal strength
advertisDataArrayBufferAdvertisement data
advertisServiceUUIDsArrayAdvertised service UUIDs

​
Code Example

​
Basic Usage

my.getBluetoothDevices({
  success(res) {
    console.log('Found devices:', res.devices);
  }
});

​
Display Device List

Page({
  data: {
    devices: []
  },

  refreshDeviceList() {
    my.getBluetoothDevices({
      success: (res) => {
        // Filter devices with names
        const namedDevices = res.devices.filter(d => d.name);
        this.setData({ devices: namedDevices });
      }
    });
  }
});

​
Sort by Signal Strength

Page({
  getDevicesBySignal() {
    my.getBluetoothDevices({
      success: (res) => {
        // Sort by RSSI (closer devices first)
        const sorted = res.devices.sort((a, b) => b.RSSI - a.RSSI);
        this.setData({ devices: sorted });
      }
    });
  }
});
This returns all devices found since discovery started. For real-time updates, use my.onBluetoothDeviceFound instead.

my.onBluetoothDeviceFound

Listen for new devices

my.getConnectedBluetoothDevices

Get connected devices