my.getbledevicerssi(object object)
基础库 或更高版本； 若版本较低，建议采取 兼容处理。
小程序开发者工具： 不支持。
主体： 企业支付宝小程序
相关文档： 蓝牙 api 概览 、 蓝牙 api 错误码对照表 、 my.connectbledevice
my.getbledevicerssi 获取低功耗蓝牙设备的信号强度（received signal strength indication, rssi）。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| deviceid | string | - | 是 | 蓝牙设备 id。该 deviceid 对应的蓝牙设备需要已经通过 my.connectbledevice 建立连接。 |
| success | function | - | 否 | 调用成功的回调函数。 |
| fail | function | - | 否 | 调用失败的回调函数。 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行）。 |
success 回调函数
参数
object res
| 属性 | 类型 | 描述 |
|---|---|---|
| rssi | number | 信号强度，单位：dbm（分贝毫瓦）。 |
fail 回调的参数为 object，error 属性为错误码，errormessage属性为错误消息。
错误码的详细信息请查看蓝牙 api 错误码对照表。
完整的示例代码请查看 my.connectbledevice 处示例代码
my.getbledevicerssi axml 代码
my.getbledevicerssi js 代码
<view>
<button ontap="getdevicerssi">获取设备信号强度button>
view>page({
data: {
// 本示例值为假数据,实际开发中 deviceid 可使用 my.startbluetoothdevicesdiscovery api 和 my.onbluetoothdevicefound api 去获取。
deviceid: "11a222b8-1111-2222-3333-00000000000",
},
// 获取信号强度
getdevicerssi() {
my.getbledevicerssi({
deviceid: this.data.deviceid,
success: (res) => {
console.log(res);
},
fail: (error) => {
console.log(error);
},
});
},
});