Parameters
Code Example
Basic Usage
Disconnect with UI Update
Cleanup on Page Exit
Related APIs
my.connectBLEDevice
Connect to device
my.getConnectedBluetoothDevices
Get connected devices
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Disconnect from a Bluetooth Low Energy device.
| Property | Type | Required | Description |
|---|---|---|---|
| deviceId | String | Yes | Device identifier |
| success | Function | No | Callback on success |
| fail | Function | No | Callback on failure |
| complete | Function | No | Callback that always executes |
my.disconnectBLEDevice({
deviceId: 'XX:XX:XX:XX:XX:XX',
success() {
console.log('Disconnected from device');
}
});
Page({
data: {
connectedDevice: null
},
disconnect() {
const { connectedDevice } = this.data;
if (!connectedDevice) return;
my.disconnectBLEDevice({
deviceId: connectedDevice.deviceId,
success: () => {
this.setData({ connectedDevice: null });
my.showToast({ content: 'Disconnected' });
},
fail: (err) => {
my.showToast({ content: 'Failed to disconnect', type: 'fail' });
}
});
}
});
Page({
data: {
deviceId: null
},
onUnload() {
if (this.data.deviceId) {
my.disconnectBLEDevice({
deviceId: this.data.deviceId
});
}
my.closeBluetoothAdapter();
}
});