错误码的定义位于 trro_field.h 头文件中。函数返回值为错误码的负值，如错误码为16777215，返回值为-16777215。
通用错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_SUCCED | All | 0x00000001 | 1 | 成功执行。 |
TRRO_SUCCEED | All | 0x00000001 | 1 | 成功执行。 |
TRRO_GWID_NOT_FOUND | v2.5 | 0x00000010 | 16 | 设备 ID 未找到。 |
TRRO_PARAM_INVALID | All | 0x00F00000 | 15728640 | 输入参数不正确。 |
TRRO_COMMON_ERROR | All | 0x00FFFFFF | 16777215 | 通用失败，未初始化。 |
配置文件错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_CONFIG_PARSE_FAILED | All | 0x01000002 | 16777218 | |
TRRO_CONFIG_ILLEGAL | All | 0x01000003 | 16777219 | 检查配置文件中，width、height、protocol 与接口输入参数是否匹配。 |
TRRO_CONFIG_UNEXIST | All | 0x01000004 | 16777220 | 配置文件不存在或长度为0 解决方法： 1. 确认配置路径是否正确传入，路径是否存在。 2. 配置文件内容不正确。 检查配置文件内容是否完整有效，确保文件非空且格式正确。 |
TRRO_CONFIG_CER_FAILED | All | 0x01000005 | 16777221 | 使用公有云模式（cloud_mode 节点设置 public）启动，但没有证书文件 device.pem 或证书文件校验失败。 |
TRRO_CONFIG_LIC_FAILED | All | 0x01000006 | 16777222 | 使用私有模式（cloud_mode 节点设置 private）启动，但 license.txt 文件不存在。 |
TRRO_CONFIG_STREAMS_SIZE_ERROR | All | 0x01000007 | 16777223 | 超过最大支持流数目。 |
TRRO_CONIFG_PORT_RANGE_ILLEGAL | All | 0x01000008 | 16777224 | 端口范围配置非法。 |
TRRO_CONFIG_LOG_PERMISSON_DENIED | All | 0x01000009 | 16777225 | 打开 log 文件权限不足 解决方法： 授予文件写权限。旧的 SDK 版本可能存在权限不够崩溃问题，请及时更新版本。 |
TRRO_CONFIG_DEVICE_ID_INVALID | All | 0x0100000A | 16777226 | 设备 ID 格式非法。 |
TRRO_CONFIG_DEVICE_NAME_INVALID | All | 0x0100000B | 16777227 | 设备名称格式非法。 |
TRRO_CONFIG_SDK_MODE_INVALID | All | 0x0100000C | 16777228 | SDK 模式值非法。 |
TRRO_CONFIG_CLOUD_MODE_INVALID | All | 0x0100000D | 16777229 | 云模式值非法。 |
TRRO_CONFIG_REQUIRED_FIELD_MISSING | All | 0x0100000E | 16777230 | 必填字段缺失。 |
TRRO_CONFIG_FIELD_TYPE_ERROR | All | 0x0100000F | 16777231 | 字段类型错误。 |
TRRO_CONFIG_ERROR | All | 0x01FFFFFF | 33554431 | 配置模块通用失败。 |
初始化错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_INIT_INPUT_ILLEGAL | All | 0x02000002 | 33554434 | 初始化参数异常。 |
TRRO_INIT_PARSE_FAILED | All | 0x02000003 | 33554435 | 初始化解析配置节点异常。 |
TRRO_INIT_CREAT_MEDIAMODE_FAILED | All | 0x02000004 | 33554436 | 媒体模块创建失败。 |
TRRO_INIT_PRM_ERROR | v2.4 | 0x02000005 | 33554437 | 初始化参数错误。 您需确认初始化参数，例如视频流输入 protocol 是否正确。 |
TRRO_INIT_LICENSE_CHECK_FAILED | v2.5 | 0x02000005 | 33554437 | LICENSE 校验失败。 |
TRRO_INIT_INVALID_INPUT | All | 0x02000006 | 33554438 | 初始化参数非法。 |
TRRO_INIT_REPEAT | v2.4 | 0x02000007 | 33554439 | 重复初始化 解决方法： 请检查 SDK 是否已经初始化过了，检查 sdk 启动次数。 |
TRRO_INIT_PRM_ERROR | v2.5 | 0x02000007 | 33554439 | 初始化参数错误。 您需确认初始化参数，例如视频流输入 protocol 是否正确。 |
TRRO_INIT_REPEAT | v2.5 | 0x02000008 | 33554440 | 重复初始化 解决方法： 请检查 SDK 是否已经初始化过了，检查 sdk 启动次数。 |
TRRO_INIT_CANCEL | All | 0x0200000F | 33554447 | 客户主动退出。 |
TRRO_INIT_LICENSE_CHECK_FAILED | v2.4 | 0x02000010 | 33554448 | LICENSE 校验失败。 |
TRRO_INIT_LICENSE_FILE_ERROR | All | 0x02000011 | 33554449 | LICENSE 文件错误。 |
TRRO_INIT_LICENSE_CHECK_TIME_FAILED | All | 0x02000012 | 33554450 | 授权过期。 |
TRRO_INIT_LICENSE_CHECK_DEVICE_FAILED | All | 0x02000013 | 33554451 | 硬件验证失败。 |
TRRO_INIT_LICENSE_CHECK_STREAM_FAILED | All | 0x02000014 | 33554452 | 授权流数目小于设备配置流数目。 |
TRRO_INIT_LICENSE_CHECK_ID_FAILED | All | 0x02000015 | 33554453 | 设备 ID 验证失败。 |
TRRO_INIT_PUBLIC_LICENSE_CHECK_TIMEOUT | All | 0x02000100 | 33554688 | 公有云 LICENSE 验证超时 解决方法： 公有云: 检测域名（ access.trro.qclouder.com 和 access.trro.qcloud.com）。如果无法连接，请检查网络对于物联网卡的情况。 |
TRRO_INIT_PUBLIC_LICENSE_CHECK_NOT_BIND | All | 0x02000101 | 33554689 | 公有云设备未绑定 LICENSE 解决方法： 请检查在公有云服务是否已过期，并进行续费或重新购买。 |
TRRO_INIT_PUBLIC_LICENSE_CHECK_NOT_ENOUGH | All | 0x02000102 | 33554690 | 公有云 LICENSE 数量不足。 |
TRRO_INIT_PUBLIC_LICENSE_CHECK_OVERTIME | All | 0x02000103 | 33554691 | 公有云 LICENSE 已过期。 |
TRRO_INIT_PUBLIC_LICENSE_CHECK_NOT_DURATION | All | 0x02000104 | 33554692 | 公有云 license 剩余时长不足。 |
TRRO_INIT_ERROR | All | 0x02FFFFFF | 50331647 | 初始化失败。 |
信令连接错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_SIGNAL_REGIST_FAILED | All | 0x03000002 | 50331650 | 注册信令服务器失败。 |
TRRO_SIGNAL_STATUS_ABNORMAL | All | 0x03000003 | 50331651 | 信令服务连接异常。 |
TRRO_SIGNAL_MESSAGE_FAILED | All | 0x03000004 | 50331652 | 信令消息处理失败。 |
TRRO_SIGNAL_CONNECT_OUTTIME | All | 0x03000005 | 50331653 | 信令服务器连接超时 解决方法： 1. 内部重连： 端侧尝试连接服务。首次可能未成功连接，内部会进行重连。若后续连接成功，此错误码可忽略。 2. 网络连接问题： 私有云: 检测服务的 IP 地址。如果无法连接，请检查网络设置。 公有云: 检测域名（ access.trro.qclouder.com 和 access.trro.qcloud.com）。如果无法连接，请检查网络以及考虑白名单设置问题。共性问题: 如果可以连通，私有云需检查推流和服务是否开启防火墙；公有云需检查是否开启防火墙，同时确认端口是否已开放。 |
TRRO_SIGNAL_DEVICEID_OR_PASSWORD_INCORRECT | All | 0x03000006 | 50331654 | 信令服务器连接用户名或者密码错误 解决方法： 请检查配置文件 config.json 中否存在 device id 以及password 确认其是否正确。 |
TRRO_DEVICE_ALREADY_LOGIN | All | 0x03000007 | 50331655 | 信令服务器连接用户名已经登录 解决方法： 1. 检查多进程问题： 使用命令 ps -aux |grep run_loader.ssh 和 ps-aux |grep trro-test 查是否有多个进程运行。如果发现重复进程，需按顺序结束进程： 先结束 run_loader.sh 进程。 再结束 trro-test 进程。 2. 强制登录： 如果有其他人或设备使用相同的设备 ID 登录，可以通过设置 force_login 为1来强制登录。 3. 私有云登录： 在私有云环境下，可以使用不同的设备 ID 登录，避免冲突。 |
TRRO_SIGNAL_NIC_DISCONNECT | v2.5 | 0x03000008 | 50331656 | 信令某网卡连接断开（多网卡场景）。 |
TRRO_SIGNAL_NIC_RECONNECT_FAILED | v2.5 | 0x03000009 | 50331657 | 信令某网卡重连/连接失败（多网卡场景）。 |
TRRO_SIGNAL_ERROR | All | 0x03FFFFFF | 67108863 | 信令模块异常。 |
采集错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_CAPTURE_OPENDEVICE_FAILED | All | 0x04000002 | 67108866 | 打开设备失败，检查相机是否有其他程序占用。 |
TRRO_CAPTURE_GETSOURCE_FAILED | All | 0x04000003 | 67108867 | 读取相机数据超时失败。 |
TRRO_CAPTURE_UNKNOWN_CAPTURETYPE | All | 0x04000004 | 67108868 | 未知的相机数据源类型。 |
TRRO_CAPTURE_ERROR | All | 0x04FFFFFF | 83886079 | 采集模块异常。 |
视频流连接错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_CONNECT_OUTTIME | All | 0x05000002 | 83886082 | 超时断连。 |
TRRO_CONNECT_RESET | v2.5 | 0x05000003 | 83886083 | connect 时之前有未断开的连接需要重置。 |
TRRO_CONNECT_MODE | v2.5 | 0x05000004 | 83886084 | connect 网关的连接 mode 不支持。 |
TRRO_CONNECT_ERROR | All | 0x05FFFFFF | 100663295 | 连接异常。 |
诊断模块错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_DIAG_STARTED | v2.5 | 0x06000000 | 100663296 | 诊断工具正在启动中。 |
TRRO_DIAG_TIMEOUT | v2.5 | 0x06000001 | 100663297 | 诊断工具获取推流信息超时。 |
TRRO_DIAG_FAILED | v2.5 | 0x06000002 | 100663298 | 诊断工具处理失败。 |
权限错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_UNAUTHORIZED | v2.5 | 0x07000000 | 117440512 | 网关未授权无法发送消息。 |
消息通道错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_MESSAGE_CHANNEL | v2.4 | 0x06000002 | 100663298 | 无可用消息发送通道。 |
TRRO_MESSAGE_BYTE_EXCEED | v2.4 | 0x06000003 | 100663299 | 发送字节数超出限制 解决方法： 检查消息长度是否超过允许的最大值，根据消息传输类型（reliable）使用不同的最大值限制： 不可靠传输时单条大小限制为1KB。 可靠传输（reliable）时单条大小限制为10KB。 如果超出限制，记录错误日志并返回 -TRRO_MESSAGE_BYTE_EXCEED。 |
TRRO_MESSAGE_RATE_EXCEED | v2.4 | 0x06000004 | 100663300 | 发送间隔过于密集 |
TRRO_MESSAGE_MAX_EXCEED | v2.4 | 0x06000005 | 100663301 | 1秒最多发送 100KB 数据， inactive 模式1秒最多发送 KB 数据。 |
TRRO_MESSAGE_BLOCK | v2.4 | 0x06000006 | 100663302 | 发送缓冲区满了。 |
TRRO_MESSAGE_COMPRESS | v2.4 | 0x06000007 | 100663303 | 消息压缩失败。 |
TRRO_MESSAGE_PERMISSION | All | 0x06000008 | 100663304 | 没有接收端存在，接收端权限问题。 |
TRRO_MESSAGE_MEDIA_CLOSED_RATE_EXCEED | v2.5 | 0x0600000A | 100663306 | 媒体未连接发送受限。 |
TRRO_MESSAGE_ERROR | All | 0x06FFFFFF | 117440511 | 消息发送失败。 |
TRRO_MESSAGE_BYTE_EXCEED | v2.5 | 0x08000002 | 134217730 | 发送字节数超出限制 解决方法： 检查消息长度是否超过允许的最大值，根据消息传输类型（reliable）使用不同的最大值限制： 不可靠传输时单条大小限制为1KB。 可靠传输（reliable）时单条大小限制为10KB。 如果超出限制，记录错误日志并返回 -TRRO_MESSAGE_BYTE_EXCEED。 |
TRRO_MESSAGE_RATE_EXCEED | v2.5 | 0x08000003 | 134217731 | 发送间隔过于密集 |
TRRO_MESSAGE_MAX_EXCEED | v2.5 | 0x08000004 | 134217732 | 1秒最多发送 100KB 数据。 |
TRRO_MESSAGE_CHANNEL | v2.5 | 0x08000005 | 134217733 | 无可用消息发送通道。 |
TRRO_MESSAGE_BLOCK | v2.5 | 0x08000006 | 134217734 | 发送缓冲区满了。 |
TRRO_MESSAGE_COMPRESS | v2.5 | 0x08000007 | 134217735 | 消息压缩失败。 |
TRRO_MESSAGE_DATA_CHANNEL_NOT_READY | v2.5 | 0x08000008 | 134217736 | 数据通道未就绪，无法发送消息。 |
本地视频存储错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_STOR_UNENABLE | All | 0x07000001 | 117440513 | 存储功能未使能。 |
TRRO_STOR_IDEXIST | All | 0x07000002 | 117440514 | 重复开启存储。 |
TRRO_STOR_ID_ILLEGAL | All | 0x07000003 | 117440515 | 存储 ID 非法。 |
TRRO_STOR_PARAM_ILLEGAL | All | 0x07000004 | 117440516 | 存储数据源输入入参非法。 |
TRRO_STOR_UNSET_FILENAME | All | 0x07000005 | 117440517 | 存储文件名为空。 |
TRRO_START_CAPTURE_IDEXIST | All | 0x07000006 | 117440518 | 重复开启存储。 |
TRRO_STOR_ERROR | All | 0x07FFFFFF | 134217727 | 存储异常，检查接口调用顺序。 |
外部输入错误
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_EXTERNAL_RESIZE | All | 0x08000001 | 134217729 | 外采输入错误。 |
异步错误事件
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_ERROR_CALLBACK_CAMERA | All | 0x09010000 | 151060480 | 相机异步回调错误。 |
TRRO_ERROR_CALLBACK_MIC | All | 0x09020000 | 151126016 | 麦克风异步回调错误。 |
TRRO_ERROR_CALLBACK_BANDWIDTH_LIMIT | All | 0x09030000 | 151191552 | 评估网络带宽无法满足最低码率需求。 |
TRRO_ERROR_CALLBACK_RESERVE_DEGRADE | All | 0x09040000 | 151257088 | 网络带宽不足引发 reserve 带宽降级。 |
TRRO_ERROR_CALLBACK_JOIN_AUTH_FAILED | v2.5 | 0x09050000 | 151322624 | RTC 进房鉴权失败（底层 event 10006），通常由后台黑白名单配置、UserSig 非法或过期引起。 |
其他
错误码名称 | 适用版本 | 十六进制值 | 十进制值 | 描述 |
TRRO_UNSUPPORT | All | 0x0F000001 | 251658241 | 该调用或者函数功能暂不支持。 |
TRRO_INPUT_SIZE_ILLEGAL | All | 0x0F000002 | 251658242 | 输入大小不匹配。 |
TRRO_SESSION_INACTIVE | All | 0x0F000003 | 251658243 | 会话未激活。 |
