错误信息
NearLink disabled.
错误描述
当星闪开关未打开时调用接口,将返回该错误码。
可能原因
星闪开关未打开。
处理步骤
在设备的设置界面打开星闪后重试(通常路径为“设置 > 星闪和蓝牙 > 星闪”,不同产品或系统版本可能为“设置 > 多设备协同 > 星闪”),或请通过在线提单提交问题。
错误信息
The UUID is already registered.
错误描述
对应UUID的端口已经被注册。
可能原因
使用同一个UUID重复创建端口。
处理步骤
调用dataTransfer.destroyPort接口销毁对应UUID的端口通道,或请通过在线提单提交问题。
错误信息
Port exceeds the upper limit.
错误描述
端口注册数量超出上限。
可能原因
数据传输业务通道分配达到上限。
处理步骤
调用dataTransfer.destroyPort接口销毁其他已注册的端口通道,或请通过在线提单提交问题。
错误信息
The UUID is not registered.
错误描述
没有注册对应UUID的端口。
可能原因
尝试销毁一个未注册的端口。
处理步骤
确认要销毁的端口已注册,或请通过在线提单提交问题。
错误信息
Data transmission congested.
错误描述
数据传输拥塞导致发送数据失败。
可能原因
协议层或芯片处理数据拥塞,导致可靠传输模式下发送数据失败。
处理步骤
控制数据写入流量,或请通过在线提单提交问题。
错误信息
Integer out of range.
错误描述
整数超出范围。
可能原因
传入的整数参数超出接口定义的取值范围。
处理步骤
修改整数参数值到接口定义的有效取值范围内(具体取值范围请参见对应接口的参数说明),或请通过在线提单提交问题。
错误信息
Invalid address.
错误描述
无效地址。
可能原因
传入的地址参数格式不正确,如长度不符、包含非法字符。
处理步骤
修改地址参数为正确格式,或请通过在线提单提交问题。
正确的地址格式形如“11:22:33:AA:BB:FF”,由十六进制数字字符和冒号共17个字符组成。
错误信息
Invalid UUID.
错误描述
无效UUID。
可能原因
传入的UUID参数格式不正确,如长度不符、包含非法字符。
处理步骤
修改UUID参数为正确格式,或请通过在线提单提交问题。
正确的UUID格式形如“FFFFFFFF-1234-5678-ABCD-000000001234”,由十六进制数字字符和连字符共36个字符组成,代表128比特标识。
错误信息
NearLink standard UUID not allowed.
错误描述
禁止使用星闪标准服务UUID。
可能原因
接口参数中禁止使用星闪标准服务UUID。限制场景包括:
禁止直接将星闪标准服务UUID作为参数传入;
禁止在自定义服务、属性、方法等服务结构中包含星闪标准服务UUID。
处理步骤
将接口参数中的标准服务UUID更换为自定义服务UUID。
检查自定义的服务、属性、方法等结构,确保其中不包含星闪标准服务UUID;若问题持续存在,请通过在线提单提交问题。
标准服务UUID由星闪联盟官方定义的基础标识(Base UUID,37BEA880-FC70-11EA-B720-000000000000)的前112比特与16比特标准标识拼接而成。自定义服务UUID不能以基础标识的前112比特为前缀。
错误信息
Coordinated Devices Set Management not supported.
错误描述
本设备不支持合作设备集合管理功能。
可能原因
当前设备硬件不支持合作设备集合管理功能。
处理步骤
如需使用合作设备集合管理功能,请使用支持星闪合作设备集合管理特性的设备,例如支持星闪音频的部分手机、平板等。也可通过查询设备能力接口确认设备是否支持该特性,或请通过在线提单提交问题。
错误信息
Operation failed.
错误描述
系统处理过程中遇到非预期的内部错误。
可能原因
在设备已配对的情况下重复调用startPairing发起配对。
其他非预期的内部错误。
处理步骤
检查设备是否已配对;若已配对,请勿重复调用startPairing发起配对。
请重试操作;若问题持续存在,请通过在线提单提交问题。