my.getbledevicecharacteristics(object object)
支付宝客户端 10.0.18 或更高版本； 若版本较低，建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
小程序开发者工具： 不支持。暂不支持在 ide 上调用该 api，请使用真机调试
主体： 企业支付宝小程序 、 个人支付宝小程序
获取低功耗蓝牙设备某个服务中所有特征（characteristic）
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| deviceid | string | - | 是 | 蓝牙设备 id。该 deviceid 对应的蓝牙设备需要已经通过 my.connectbledevice 建立连接 |
| serviceid | string | - | 是 | 蓝牙服务的 uuid。可调用 my.getbledeviceservices 获取 |
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
success 回调函数
参数
object res
查看示例
| 属性 | 类型 | 描述 | |||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| characteristics | array | 设备特征列表 |
|||||||||||||||||||||||||||||||||||||||||||||||
|
fail 回调的参数为 object，error 属性为错误码，errormessage属性为错误消息。
错误码的详细信息请查看蓝牙 api 错误码对照表。
完整的示例代码请参考 my.connectbledevice 处的示例代码
<view>
<button ontap="getbledevicecharacteristics">获取设备特征列表-getbledevicecharacteristicsbutton>
view>
page({
data: {
// 本示例值为假数据，实际开发中可使用 my.startbluetoothdevicesdiscovery api 和 my.onbluetoothdevicefound api 去获取 deviceid。
deviceid: "55829650-fb8a-4c86-1f80-d8dec4dfdc5d",
// 本示例值为假数据，实际开发中可使用 my.getbledeviceservices api 去获取 serviceid。
serviceid: "44:90:bb:99:41:a5",
characteristicid: "",
},
// 连接设备
connectbledevice() {
my.connectbledevice({
deviceid: this.data.deviceid,
success: () => {
my.alert({ content: "连接成功" });
},
fail: (error) => {
console.error('连接失败: ', json.stringify(error));
}
});
},
// 获取低功耗蓝牙设备指定服务的特征列表
getbledevicecharacteristics() {
my.getbledevicecharacteristics({
deviceid: this.data.deviceid,
serviceid: this.data.serviceid,
success: (res) => {
console.log(res)
// 可根据业务需要，去选择实际业务中需要的 characteristicid 值。
this.setdata({
characteristicid: res.characteristics[0].characteristicid,
});
},
fail: (error) => {
console.error('获取信息失败: ', json.stringify(error));
}
});
},
});
{
"characteristics": [
// 支付宝 10.5.50 的 success 回调参数
{
"characteristicid": "8667556c-9a37-4c91-84ed-54ee27d90049",
"properties": {
"indicate": false,
"notify": true,
"read": false,
"write": true,
"writedefault": true,
"writenoresponse": false
},
"serviceid": "d0611e78-bbb4-4591-a5f8-487910ae4366",
"value": "ff00a5"
},
// 支付宝 10.5.50 之前的 success 回调参数
{
"characteristicid": "8667556c-9a37-4c91-84ed-54ee2711111",
"properties": {
"indicate": false,
"notify": false,
"read": false,
"write": true
},
"serviceid": "d0611e78-a5f8-4591-a5f8-487910ae41111",
"value": ""
}
]
}