iBeacon

my.startBeaconDiscovery

支付宝客户端 10.1.8 版本开始支持，低版本需做兼容处理

开始搜索附近的 iBeacon 设备

入参

示例代码

my.startBeaconDiscovery({
  uuids:['uuid1','uuid2'],
  success: (res) => {
    console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

Bug & Tip

• tip: uuid1、uuid2 为目标 iBeacon 的UUID，可从硬件厂商获取，如果为空，无法搜索到 iBeacon
• tip: iBeacon 需要位置权限，iOS 11 之前需要蓝牙开关打开，iOS 11 以后，需要 设置->蓝牙->开关开启(控制中心的蓝牙开关不影响 iBeacon 使用)
• tip: 推荐在 my.onBeaconUpdate 回调中处理发现到的iBeacon设备信息

my.stopBeaconDiscovery

支付宝客户端 10.1.8 版本开始支持，低版本需做兼容处理

停止搜索附近的 iBeacon 设备

入参

示例代码

my.stopBeaconDiscovery({
  success: (res) => {
    console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

my.getBeacons

支付宝客户端 10.1.8 版本开始支持，低版本需做兼容处理

获取已经搜索到的 iBeacon 设备

入参

success返回参数说明：

iBeacon 结构：

示例代码

my.getBeacons({
  success: (res) => {
    console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

Bug & Tip

• bug: Android 支付宝客户端 10.1.28 及以前的版本该接口返回的 rssi 值不能动态更新，推荐使用事件触发方式

my.onBeaconUpdate()

支付宝客户端 10.1.8 版本开始支持，低版本需做兼容处理

监听 iBeacon 设备的更新事件

CALLBACK返回参数说明：

iBeacon 结构：

示例代码：

my.onBeaconUpdate({
  success: (res) => {
  },
})

my.onBeaconServiceChange()

支付宝客户端 10.1.8 版本开始支持，低版本需做兼容处理

监听 iBeacon 服务的状态变化

CALLBACK返回参数说明：

示例代码：

my.onBeaconServiceChange({
  success: (res) => {
  },
})

Bug & Tip

• tip: iOS 11及以后版本 “控制中心蓝牙开关” 和 “设置->蓝牙->开关” 分离，控制中心蓝牙开关不再影响 iBeacon 使用，但是 my.onBeaconServiceChange 事件仍然会回调，建议iOS 11以后该事件回调以后继续等待 my.onBeaconUpdate 以确认是否提示用户开启蓝牙。

错误码梳理

原文: https://docs.alipay.com/mini/api/yqleyc