错误信息
Device not paired.
错误描述
本端设备蓝牙未配对成功。
可能原因
本端设备未与目标设备完成蓝牙配对。
目标设备未启动服务监听。
使用了无效的MAC或者UUID。
处理步骤
使用运动健康应用完成设备添加及配对。
检查目标设备服务监听情况。
检查输入的MAC和UUID的有效性,MAC应为XX:XX:XX:XX:XX:XX格式的蓝牙MAC地址字符串,UUID应为标准UUID格式字符串,如xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
错误信息
ChannelId is invalid or unavailable.
错误描述
调用代理通道接口时传入的通道ID不符合要求或该通道已失效,导致操作无法继续。
可能原因
传入了非法的channelId,channelId应为openProxyChannel返回的number类型通道标识。
该channelId对应的通道已通过closeProxyChannel关闭,关闭后channelId不再可用。
处理步骤
检查代码逻辑,确认传入的channelId是否为openProxyChannel返回的channelId。
检查代码逻辑,确认该channelId对应的通道是否已关闭,若已关闭则不应继续使用该channelId;如需继续通信,请重新调用openProxyChannel建立新通道。
错误信息
Parameter error.
错误描述
调用代理通道接口时传入的参数不符合要求,如MAC或UUID格式异常、入参类型错误等,导致接口调用失败。
可能原因
传入的MAC或者UUID格式异常(MAC应为XX:XX:XX:XX:XX:XX格式的蓝牙MAC地址字符串,UUID应为标准UUID格式字符串,如xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
函数入参类型错误。
处理步骤
检查代码逻辑,确认MAC为XX:XX:XX:XX:XX:XX格式的蓝牙MAC地址字符串,UUID为标准UUID格式字符串,如xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
检查代码逻辑,确认入参类型与接口定义一致。
错误信息
Internal error.
错误描述
系统内部发生异常,可能导致当前操作执行失败或服务不可用。
可能原因
系统错误,如空指针、内存不足、分布式服务异常重启、IPC异常、JS引擎异常等。
处理步骤
重试操作。
若问题仍存在,重启应用。
若重启无效,升级应用或升级设备版本。
错误信息
Call is restricted.
错误描述
未授权调用,调用受限。
可能原因
未授权进程进行了访问。
处理步骤
申请代理通道管理所需权限(请从代理通道管理API接口文档中确认具体权限名称),并在应用配置中声明对应权限后重新尝试。
错误信息
Operation failed or Connection timed out.
错误描述
蓝牙底层故障导致代理通道操作未成功完成,或在规定时间内未建立连接而超时。
可能原因
底层蓝牙故障导致连接失败或者连接超时。
处理步骤
关闭后重新开启本端设备和目标设备的蓝牙。
重启本端设备和目标设备后,再打开设备的蓝牙。