本页列出了声网 RTSA SDK 运行过程中或 API 调用时可能返回的错误码,帮助你判断引起错误的原因,然后进行排查。
如果 API 调用失败,SDK 会返回一个小于零的值。有以下两种情况:
返回值为 -1 时,表示为 Linux 系统相关错误。
错误码 | 解释 |
---|---|
RTC_ERR_OK | 0: 执行成功。 |
RTC_ERR_UNKNOWN_ERROR | -1: 未知错误。你需要根据日志文件排查问题。 |
RTC_ERR_LICENSE_VERIFICATION_FAILURE | -20: License 验证失败。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
RTC_ERR_AUDIO_CODEC_NOT_SUPPORT | -21:该 SDK 版本不支持 Audio Codec 功能。如果你需要 Audio Codec 功能,请联系技术支持获取对应 SDK 包。 |
RTC_ERR_SEND_DATA_BEFORE_JOIN_SUCCESS | -22:未加入任何频道,无法推送数据。你需要加入频道成功后再尝试推送数据。 |
RTC_ERR_NO_MEMORY | -31: 系统内存不足,申请分配内存失败 。你需要确认系统内存是否充足。声网建议你的系统内存大于 3 MB。 |
RTC_ERR_INVALID_PARAM | -33: 参数错误。你需要检查接口参数。 |
RTC_ERR_LICENSE_JSON_NOT_ENOUGH_MEMORY | -100: 试图解析 JSON 文件时无法分配内存。你需要确认系统内存是否充足。 |
RTC_ERR_LICENSE_JSON_INVALID_CHARACTER | -101: JSON 字符串中存在无效字符。你需要检查 JSON 字符串内容格式是否合法。 |
RTC_ERR_LICENSE_JSON_NOT_COMPLETE | -102: JSON 字符串不完整。你需要检查 JSON 字符串内容格式是否合法。 |
RTC_ERR_LICENSE_JSON_PARSE_ERROR | -103: JSON 字符串解析失败。你需要检查 JSON 字符串内容格式是否合法。 |
RTC_ERR_LICENSE_INVALID_CERTIFICATE | -104: License 格式(内容或长度)错误。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
RTC_ERR_LICENSE_CUSTOM_NOT_FOUND | -105: License 内容不合法(未携带用户信息)。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
RTC_ERR_LICENSE_INVALID_CREDENTIAL | -106: License 验证失败。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
RTC_ERR_LICENSE_CERTIFICATE_EXPIRED | -107: License 已过期。你需要重新申请 License。 |
RTC_ERR_LICENSE_INVALID_SIGNATURE | -108: License 签名不合法。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
RTC_ERR_LICENSE_BUFFER_OVERFLOW | -109: 数据长度超出限制。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
RTC_ERR_LICENSE_UNEXPECTED_NULL | -110: License 格式错误或分配内存异常。你需要检查系统内存是否充足,并检查 License 内容是否正确。 |
RTC_ERR_LICENSE_UNKNOWN_ERROR | -111: 其他未知的 License 验证错误。你需要排查 License 申请、激活和集成过程中是否存在问题。 |
详见 rtm_err_code_e
枚举类型。
on_error
回调返回的错误码on_error
回调中可能返回的错误码和描述详见 agora_err_code_e
枚举类型。