微信小程序API-设备-iBeacon

2017-08-14

wx.startBeaconDiscovery(OBJECT)

基础库 1.2.0 开始支持,低版本需做兼容处理

开始搜索附近的iBeacon设备

OBJECT参数说明:

参数名类型必填说明
uuidsStringArrayiBeacon设备广播的 uuids
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名类型说明
errMsgString调用结果

示例代码:

wx.startBeaconDiscovery({
    success(res) {
    }
})

wx.stopBeaconDiscovery(OBJECT)

基础库 1.2.0 开始支持,低版本需做兼容处理

停止搜索附近的iBeacon设备

OBJECT参数说明:

参数名类型必填说明
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名类型说明
errMsgString调用结果

wx.getBeacons(OBJECT)

基础库 1.2.0 开始支持,低版本需做兼容处理

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

OBJECT参数说明:

参数名类型必填说明
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名类型说明
beaconsObjectArrayiBeacon 设备列表
errMsgString调用结果

iBeacon 结构:

参数类型说明
uuidStringiBeacon 设备广播的 uuid
majorStringiBeacon 设备的主 id
minorStringiBeacon 设备的次 id
proximityNumber表示设备距离的枚举值
accuracyNumberiBeacon 设备的距离
rssiNumber表示设备的信号强度

wx.onBeaconUpdate(CALLBACK)

基础库 1.2.0 开始支持,低版本需做兼容处理

监听iBeacon设备的更新事件

CALLBACK返回参数说明:

参数名类型说明
beaconsarray object当前搜寻到的所有 iBeacon 设备列表

iBeacon 结构:

参数类型说明
uuidStringiBeacon 设备广播的 uuid
majorStringiBeacon 设备的主 id
minorStringiBeacon 设备的次 id
proximityNumber表示设备距离的枚举值
accuracyNumberiBeacon 设备的距离
rssiNumber表示设备的信号强度

wx.onBeaconServiceChange(CALLBACK)

基础库 1.2.0 开始支持,低版本需做兼容处理

监听iBeacon服务的状态变化

CALLBACK返回参数说明:

参数名类型说明
availableBoolean服务目前是否可用
discoveringBoolean目前是否处于搜索状态

错误码列表

错误码说明备注
0ok正常
11000unsupport系统或设备不支持
11001bluetooth service unavailable蓝牙服务不可用
11002location service unavailable位置服务不可用
11003already start已经开始搜索