# wx.readBLECharacteristicValue(Object object)
Start from base library version 1.1.0. Please remaining backward compatible.
with Promise style call: Supported
Mini Program plugin: Support, need to Mini Program base library version no less than 1.9.6
Reads the binary data of the characteristic value of a Bluetooth low-power device. Note: Features of the device must support read Before it can be successfully invoked.
# parameter
# Object object
attribute | type | Default values | Required | Introductions |
---|---|---|---|---|
deviceId | string | yes | Bluetooth Device id | |
serviceId | string | yes | Bluetooth Feature Corresponding Service UUID | |
characteristicId | string | yes | Bluetooth characteristic UUID | |
success | function | no | Interface calls the successful callback function | |
fail | function | no | Interface calls failed callback functions | |
complete | function | no | Callback function at the end of an interface call (both successful and unsuccessful calls are executed) |
# error
Error code | Error message | Introductions |
---|---|---|
0 | ok | normal |
-1 | already connect | Connected |
10000 | not init | Uninitialized Bluetooth adapter |
10001 | not available | The current Bluetooth adapter is not available |
10002 | No device | Specified device not found |
10003 | connection fail | Connection failure |
10004 | No service | Specified service not found |
10005 | No characteristic | Did not find the specified signature. |
10006 | No connection | Current connection disconnected |
10007 | property not support | Current feature does not support this operation |
10008 | system error | All other system reported anomalies |
10009 | system not support | Android System specific, system version below 4.3 Not supported WAS |
10012 | operate time out | Connection Timeout |
10013 | invalid_data | Connect deviceId Is empty or incorrectly formatted |
# Be careful
- Multiple parallel calls have the possibility of read failure.
- The information read by the interface needs to be stored in the wx.onBLECharacteristicValueChange Method to get the callback registered with the.
# sample code
// Must be here to get a callback
wx.onBLECharacteristicValueChange(function(characteristic) {
console.log('characteristic value comed:', characteristic)
})
wx.readBLECharacteristicValue({
// Here. deviceId Need has passed createBLEConnection Establish a link with the corresponding device
deviceId,
// Here. serviceId Need to getBLEDeviceServices Get in interface
serviceId,
// Here. characteristicId Need to getBLEDeviceCharacteristics Get in interface
characteristicId,
success (res) {
console.log('readBLECharacteristicValue:', res.errCode)
}
})