阅读(3297)
赞(1)
微信小程序API-设备-iBeacon
2017-08-14 17:17:16 更新
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 | 已经开始搜索 |