# onBeaconUpdate
监听 Beacon 设备更新事件,仅能注册一个监听
注意事项:需要先调用startBeaconDiscovery。
# 支持说明
该接口对应的客户端版本需要 5.3.2 版本及以上(Android和 iOS)。
# 输入
继承标准对象输入,扩展属性如下所示。
| 名称 | 数据类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| callback | function | 是 | - | 该事件的回调函数 |
# 输出
继承标准对象输出,扩展属性如下所示。
回调函数返回beacons(Beacon 设备列表数组)的属性:
| 名称 | 数据类型 | 描述 |
|---|---|---|
| uuid | string | Beacon 设备广播的 uuid |
| major | number | Beacon 设备的主 id |
| minor | number | Beacon 设备的次 id |
| proximity | number | 表示设备距离的枚举值 |
| accuracy | number | Beacon 设备的距离 |
| rssi | number | 表示设备的信号强度 |
# 示例代码
app.link.startBeaconDiscovery({
uuids: [
"fda50693-a4e2-4fb1-afcf-c6eb07647825"
],
success(res) {
app.link.onBeaconUpdate(function(res) {
console.log(JSON.stringify(res));
});
},
fail(res) {
console.log(`startBeaconDiscovery fail: ${JSON.stringify(res)}`);
}
});
success返回对象示例:
{
"beacons": [
{
"accuracy": 16.545591294123085,
"major": 11054,
"minor": 11389,
"proximity": 3,
"rssi": -86,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
}
]
}