- uni.onBeaconServiceChange(CALLBACK)
- uni.onBeaconUpdate(CALLBACK)
- uni.getBeacons(OBJECT)
- 错误
- uni.startBeaconDiscovery(OBJECT)
- 错误
- 示例代码
- uni.stopBeaconDiscovery(OBJECT)
- 错误
- IBeaconInfo
iBeacon API 平台差异说明
5+App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 |
---|---|---|---|---|
√ | x | √ | √ | x |
uni.onBeaconServiceChange(CALLBACK)
监听 iBeacon 服务状态变化事件
CALLBACK 返回参数
属性 | 类型 | 说明 |
---|---|---|
available | boolean | 服务目前是否可用 |
discovering | boolean | 目前是否处于搜索状态 |
uni.onBeaconUpdate(CALLBACK)
监听 iBeacon 设备更新事件
CALLBACK 返回参数
属性 | 类型 | 说明 |
---|---|---|
beacons | Array<IBeaconInfo> | 当前搜寻到的所有 iBeacon 设备列表 |
uni.getBeacons(OBJECT)
获取所有已搜索到的 iBeacon 设备
OBJECT 参数说明
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
属性 | 类型 | 说明 |
---|---|---|
beacons | Array<IBeaconInfo> | iBeacon 设备列表 |
错误
错误码 | 错误信息 | 说明 |
---|---|---|
0 | ok | 正常 |
11000 | unsupport | 系统或设备不支持 |
11001 | bluetooth service unavailable | 蓝牙服务不可用 |
11002 | location service unavailable | 位置服务不可用 |
11003 | already start | 已经开始搜索 |
uni.startBeaconDiscovery(OBJECT)
开始搜索附近的 iBeacon 设备
OBJECT 参数说明
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
uuids | Array<String> | 是 | iBeacon 设备广播的 uuid 列表 | |
ignoreBluetoothAvailable | boolean | false | 否 | 是否校验蓝牙开关,仅在 iOS 下有效 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
错误
错误码 | 错误信息 | 说明 |
---|---|---|
0 | ok | 正常 |
11000 | unsupport | 系统或设备不支持 |
11001 | bluetooth service unavailable | 蓝牙服务不可用 |
11002 | location service unavailable | 位置服务不可用 |
11003 | already start | 已经开始搜索 |
示例代码
uni.startBeaconDiscovery({
success(res) { }
})
uni.stopBeaconDiscovery(OBJECT)
停止搜索附近的 iBeacon 设备
OBJECT 参数说明
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
错误
错误码 | 错误信息 | 说明 |
---|---|---|
0 | ok | 正常 |
11000 | unsupport | 系统或设备不支持 |
11001 | bluetooth service unavailable | 蓝牙服务不可用 |
11002 | location service unavailable | 位置服务不可用 |
11003 | already start | 已经开始搜索 |
IBeaconInfo
属性 | 类型 | 说明 |
---|---|---|
uuid | string | iBeacon 设备广播的 uuid |
major | string | iBeacon 设备的主 id |
minor | string | iBeacon 设备的次 id |
proximity | number | 表示设备距离的枚举值 |
accuracy | number | iBeacon 设备的距离 |
rssi | number | 表示设备的信号强度 |
发现错误?想参与编辑?在 GitHub 上编辑此页面!