标题: 微信小程序API-设备-iBeacon [打印本页]

---

作者: vicky.yu    时间: 2026-7-2 10:09     标题: 微信小程序API-设备-iBeacon

wx.startBeaconDiscovery(OBJECT)
基础库 1.2.0 开始支持，低版本需做兼容处理

开始搜索附近的iBeacon设备

OBJECT参数说明：

参数名        类型        必填        说明
uuids        StringArray        是        iBeacon设备广播的 uuids
success        Function        否        接口调用成功的回调函数
fail        Function        否        接口调用失败的回调函数
complete        Function        否        接口调用结束的回调函数（调用成功、失败都会执行）
success返回参数说明：

参数名        类型        说明
errMsg        String        调用结果
示例代码：

wx.startBeaconDiscovery({
    success(res) {
    }
})
wx.stopBeaconDiscovery(OBJECT)
基础库 1.2.0 开始支持，低版本需做兼容处理

停止搜索附近的iBeacon设备

OBJECT参数说明：

参数名        类型        必填        说明
success        Function        否        接口调用成功的回调函数
fail        Function        否        接口调用失败的回调函数
complete        Function        否        接口调用结束的回调函数（调用成功、失败都会执行）
success返回参数说明：

参数名        类型        说明
errMsg        String        调用结果
wx.getBeacons(OBJECT)
基础库 1.2.0 开始支持，低版本需做兼容处理

获取所有已搜索到的iBeacon设备

OBJECT参数说明：

参数名        类型        必填        说明
success        Function        否        接口调用成功的回调函数
fail        Function        否        接口调用失败的回调函数
complete        Function        否        接口调用结束的回调函数（调用成功、失败都会执行）
success返回参数说明：

参数名        类型        说明
beacons        ObjectArray        iBeacon 设备列表
errMsg        String        调用结果
iBeacon 结构：

参数        类型        说明
uuid        String        iBeacon 设备广播的 uuid
major        String        iBeacon 设备的主 id
minor        String        iBeacon 设备的次 id
proximity        Number        表示设备距离的枚举值
accuracy        Number        iBeacon 设备的距离
rssi        Number        表示设备的信号强度
wx.onBeaconUpdate(CALLBACK)
基础库 1.2.0 开始支持，低版本需做兼容处理

监听iBeacon设备的更新事件

CALLBACK返回参数说明：

参数名        类型        说明
beacons        array object        当前搜寻到的所有 iBeacon 设备列表
iBeacon 结构：

参数        类型        说明
uuid        String        iBeacon 设备广播的 uuid
major        String        iBeacon 设备的主 id
minor        String        iBeacon 设备的次 id
proximity        Number        表示设备距离的枚举值
accuracy        Number        iBeacon 设备的距离
rssi        Number        表示设备的信号强度
wx.onBeaconServiceChange(CALLBACK)
基础库 1.2.0 开始支持，低版本需做兼容处理

监听iBeacon服务的状态变化

CALLBACK返回参数说明：

参数名        类型        说明
available        Boolean        服务目前是否可用
discovering        Boolean        目前是否处于搜索状态
错误码列表
错误码        说明        备注
0        ok        正常
11000        unsupport        系统或设备不支持
11001        bluetooth service unavailable        蓝牙服务不可用
11002        location service unavailable        位置服务不可用
11003        already start        已经开始搜索

---

欢迎光临 赛捷软件论坛 (http://sagesoft.cn/bbs/)

Powered by Discuz! 7.2