my.onBLEConnectionStateChanged

Use this API to listen for changes in a BLE device’s connection state, including unexpected disconnections.

Parameters

Property	Type	Required	Description
callback	Function	Yes	Callback when the connection state changes

Callback Parameters

Property	Type	Description
deviceId	String	The Bluetooth device ID
connected	Boolean	The current connection state

Code Example

Page({
  onLoad() {
    my.onBLEConnectionStateChanged(this.handleConnectionStateChange);
  },

  handleConnectionStateChange(res) {
    if (!res.connected) {
      console.log('Device disconnected:', res.deviceId);
    }
  },

  onUnload() {
    my.offBLEConnectionStateChanged(this.handleConnectionStateChange);
  }
});

Call my.offBLEConnectionStateChanged to remove any existing listener before calling my.onBLEConnectionStateChanged, to avoid registering duplicate listeners that each fire on the same event. IDE simulation is not supported for this API — test on a real device.

my.offBLEConnectionStateChanged

Stop listening

my.connectBLEDevice

Connect to a BLE device

my.notifyBLECharacteristicValueChange my.offBLEConnectionStateChanged

JSAPI Reference

Basic

In-App Events

UI

Media

Storage

File

Location

Map

Network

Device

Sharing

Collection

Update

Web View

Alipay Connect

Open Capabilities

Other

Parameters

Callback Parameters

Code Example

my.offBLEConnectionStateChanged

my.connectBLEDevice

​Parameters

​Callback Parameters

​Code Example

​Related APIs

my.offBLEConnectionStateChanged

my.connectBLEDevice

Parameters

Callback Parameters

Code Example

Related APIs