iBeacon API 平台差异说明

5+AppH5微信小程序支付宝小程序百度小程序
√x√√x

uni.onBeaconServiceChange(CALLBACK)

监听 iBeacon 服务状态变化事件

CALLBACK 返回参数

属性类型说明
availableboolean服务目前是否可用
discoveringboolean目前是否处于搜索状态

uni.onBeaconUpdate(CALLBACK)

监听 iBeacon 设备更新事件

CALLBACK 返回参数

属性类型说明
beaconsArray<IBeaconInfo>当前搜寻到的所有 iBeacon 设备列表

uni.getBeacons(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明：

属性类型说明
beaconsArray<IBeaconInfo>iBeacon 设备列表

错误

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

uni.startBeaconDiscovery(OBJECT)

开始搜索附近的 iBeacon 设备

OBJECT 参数说明

属性类型默认值必填说明
uuidsArray＜String＞是iBeacon 设备广播的 uuid 列表
ignoreBluetoothAvailablebooleanfalse否是否校验蓝牙开关，仅在 iOS 下有效
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

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

示例代码

  1. uni.startBeaconDiscovery({
  2.   success(res) { }
  3. })

uni.stopBeaconDiscovery(OBJECT)

停止搜索附近的 iBeacon 设备

OBJECT 参数说明

属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

错误

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

IBeaconInfo

属性类型说明
uuidstringiBeacon 设备广播的 uuid
majorstringiBeacon 设备的主 id
minorstringiBeacon 设备的次 id
proximitynumber表示设备距离的枚举值
accuracynumberiBeacon 设备的距离
rssinumber表示设备的信号强度

发现错误？想参与编辑？在 GitHub 上编辑此页面！