my.writeBLECharacteristicValue

Parameters

Property	Type	Required	Description
deviceId	String	Yes	Device identifier
serviceId	String	Yes	Service UUID
characteristicId	String	Yes	Characteristic UUID
value	Hex String	Yes	Hexadecimal string value to write, limited to 20 bytes
success	Function	No	Callback on success
fail	Function	No	Callback on failure
complete	Function	No	Callback that always executes

Code Example

my.writeBLECharacteristicValue({
  deviceId: 'XX:XX:XX:XX:XX:XX',
  serviceId: '0000FFF0-0000-1000-8000-00805F9B34FB',
  characteristicId: '0000FFF1-0000-1000-8000-00805F9B34FB',
  value: 'fffe',
  success: (res) => {
    console.log('Write succeeded:', res);
  },
  fail: (err) => {
    console.error('Write failed:', err);
  }
});

Error Codes

Code	Description
10000	The Bluetooth adapter is not initialized
10001	The Bluetooth adapter is not available
10002	Device not found
10003	Connection failed
10004	Service not found
10005	Characteristic not found
10006	Connection lost
10007	Characteristic not supported
10008	System error
10009	BLE is not supported for Android systems with versions lower than 4.3
10011	Invalid device ID
10012	Invalid service ID
10013	Invalid characteristic ID
10014	Invalid data
10015	Timeout
10016	Parameters not enough
10017	Failed to write characteristic

IDE simulation is not supported for this API. Test on a real device.

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

Code Example

Error Codes

my.readBLECharacteristicValue

my.onBLECharacteristicValueChange

​Parameters

​Code Example

​Error Codes

​Related APIs

my.readBLECharacteristicValue

my.onBLECharacteristicValueChange

Parameters

Code Example

Error Codes

Related APIs