Skip to main content
Use this API to get the list of Bluetooth devices that are currently connected.

​
Parameters

PropertyTypeRequiredDescription
servicesArrayNoFilter by service UUIDs
successFunctionNoCallback on success
failFunctionNoCallback on failure
completeFunctionNoCallback that always executes

​
Success Callback Parameters

PropertyTypeDescription
devicesArrayList of connected devices

​
Device Object Properties

PropertyTypeDescription
deviceIdStringDevice identifier
nameStringDevice name

​
Code Example

​
Basic Usage

my.getConnectedBluetoothDevices({
  success(res) {
    console.log('Connected devices:', res.devices);
  }
});

​
Filter by Service

my.getConnectedBluetoothDevices({
  services: ['FEE7'],
  success(res) {
    console.log('Connected devices with service FEE7:', res.devices);
  }
});

​
Check Connection Status

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

  checkConnections() {
    my.getConnectedBluetoothDevices({
      success: (res) => {
        this.setData({ connectedDevices: res.devices });

        if (res.devices.length === 0) {
          my.showToast({ content: 'No devices connected' });
        }
      }
    });
  }
});

​
Reconnection Logic

Page({
  targetDeviceId: 'XX:XX:XX:XX:XX:XX',

  checkAndReconnect() {
    my.getConnectedBluetoothDevices({
      success: (res) => {
        const isConnected = res.devices.some(
          d => d.deviceId === this.targetDeviceId
        );

        if (!isConnected) {
          this.reconnectDevice();
        }
      }
    });
  },

  reconnectDevice() {
    my.connectBLEDevice({
      deviceId: this.targetDeviceId,
      success: () => {
        my.showToast({ content: 'Reconnected' });
      }
    });
  }
});

my.getBluetoothDevices

Get discovered devices

my.connectBLEDevice

Connect to device