my.onBeaconServiceChange
2020-09-15 15:21 更新
版本要求:支付宝客户端 10.1.8 或更高版本,若版本较低,建议做兼容处理
监听 iBeacon 服务的状态变化。
示例代码
my.onBeaconServiceChange({
success: (res) => {
},
})
入参
为 Object 对象,属性如下:
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 回调函数
入参为 Object 类型,属性如下:
参数名 | 类型 | 说明 |
---|---|---|
available | Boolean | 服务目前是否可用 |
discovering | Boolean | 目前是否处于搜索状态 |
fail 回调函数
入参为 Object 类型,属性如下:
属性 | 类型 | 描述 |
---|---|---|
error | String | 错误码 |
errorMessage | String | 错误信息 |
结果码
结果码 | 说明 | 备注 |
---|---|---|
11000 | unsupport | 系统或设备不支持 |
11001 | bluetooth invalid | 蓝牙服务不可用 |
11002 | location service unavailable | 位置服务不可用 |
11003 | location authorization forbidden | 位置服务权限禁止 |
11004 | already discovering | 已经开始搜索 |
11006 | uuid invalid | UUID 格式错误 |
11008 | uuids empty | 参数错误,UUID 数组为空 |
使用须知
iOS 11 及以后版本 “控制中心蓝牙开关” 和 “设置 > 蓝牙 > 开关” 分离,控制中心蓝牙开关不再影响 iBeacon 使用,但是 my.onBeaconServiceChange
事件仍然会回调,建议 iOS 11 以后该事件回调以后继续等待 my.onBeaconUpdate
以确认是否提示用户开启蓝牙。
以上内容是否对您有帮助:
更多建议: