my.startbeacondiscovery(object object)
支付宝客户端 10.1.8 或更高版本; 若版本较低,建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
小程序开发者工具: 不支持。暂不支持 ide 调试,请使用真机调试。
主体: 企业支付宝小程序 、 个人支付宝小程序
开始搜索附近的 ibeacon 设备。
object object
查看示例
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
uuids | array |
- | 是 | 目标 ibeacon 设备广播的 uuid 数组,uuid 可从硬件厂商获取 |
success | function | - | 否 | 调用成功的回调函数 |
fail | function | - | 否 | 调用失败的回调函数 |
complete | function | - | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
fail 回调的参数为 object,error
属性为错误码,errormessage
属性为错误消息。
完整的错误码信息请查看蓝牙 api 错误码对照表。
错误码 | 错误消息 | 凯发app官方网站的解决方案 |
---|---|---|
11000 | 系统或设备不支持。 |
请使用支持 ibeacon 功能的设备进行调试。 |
11001 | 蓝牙服务不可用。 |
请打开手机系统设置中的蓝牙开关。 |
11003 | 位置服务权限禁止。 |
请打开手机系统设置中的位置权限开关。 |
11004 | 已经开始搜索。 |
调用 my.stopbeacondiscovery api 结束搜索之前,请不要重复调用 my.startbeacondiscovery api。 |
11006 | uuid 格式错误。 |
请传入正确格式的 uuid值。设备的 uuid 通常是36位的字符串,格式为:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (8位-4位-4位-4位-12位),其中,每个部分都是由十六进制数表示的。例如:550e8400-e29b-41d4-a716-446655440000。 |
11008 | 参数错误,uuid 数组为空。 |
uuid不能为空,请传入uuid。 |
-
tipios 11 及以后版本的手机,通过手机控制中心的快捷开关打开蓝牙,无法使用 ibeacon,需要在 设置 > 蓝牙 中开启蓝牙,方可使用。
-
tip由于 ibeacon 需要位置权限,所以使用之前请打开系统对支付宝 app 位置权限。
-
tip由于系统特性,若 uuid 真实存在,但没有使用 “8-4-4-4-12” 的格式传入时,如:uuids:["0112233445566778899aabbccddeeffa"],安卓端会调用成功,ios 端会报错 11008。所以实际开发时,请以 “8-4-4-4-12” 的格式传 uuid。