聆客开放平台

# 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"
        }
    ]
}