dlt.readBLECharacteristicValue

Introduction

Read the value of a characteristic.

Parameters

Object object

Property	Type	Default	Required	Description
serviceUUID	string		Yes	The UUID of the service to which the characteristic belongs.
characteristicUUID	string		Yes	The UUID of the characteristic to read.
success	function		No	The callback function for a successful API call.
fail	function		No	The callback function for a failed API call.
complete	function		No	The callback function that is called when the API call ends (whether it succeeds or fails).

object.success Callback Function

Parameters

Object res

Property	Type	Description
success	string	true - Success
serviceUUID	string	The UUID of the service.
characteristicUUID	string	The UUID of the characteristic.
value	string	The value of the characteristic.
status	string	Status

object.fail Callback Function

Parameters

Object res

Property	Type	Description
success	string	false - Failure
errCode	string	Error code

Explanation of Error Codes

Error Code	Description
-1	Failed
0	Normal
10000	Bluetooth adapter uninitialized
10001	Bluetooth not available
10002	Device not found
10003	Connection failed
10004	Already connected
10005	Characteristic not found
10006	Descriptor not found
10007	Location access required
10008	System reports an exception
10013	Invalid data
10014	Permission not granted
10015	Adapter already initialized

Sample Code

dlt.readBLECharacteristicValue({
  serviceUUID: 'xxx',
  characteristicUUID: 'xxx',
  success: function (res) {
    console.log(res);
  },
});

In the sample code provided, dlt.readBLECharacteristicValue is used to read the value of a specified characteristic. When the operation is successful, the success callback function is called, and it logs the result to the console.