实时音视频 > 使用指南 > Linux >错误码

错误码

最近更新时间: 2022-03-28 16:57:03

本文主要介绍 QNRTC SDK 各端相关的错误码及其建议的处理方式。

若返回的错误码本文未提及，请提交工单或者联系七牛技术支持同学协助解决

房间相关错误码

枚举值	错误码	说明	处理方式
QNRTC_OK	0	无错误	无
Err_Token_Error	10001	房间 Token 错误	表示您提供的房间 token 不符合七牛 token 签算规则，详情请参考 RoomToken 签发服务
Err_Token_Expired	10002	房间 Token 过期	表示您的房间 token 过期，需要重新生成 token 再加入
Err_User_Already_Exist	10022	房间内已经有同名用户	后台如果配置为开启“禁止自动踢人”，则同一用户重复加入/未正常退出再加入会触发此错误
Err_Media_Not_Support	10054	媒体协商失败	表示该设备不支持指定的音视频格式，无法进行连麦的操作
Err_Auth_Failed	21001	加入房间认证失败	服务验证时出错，可能为服务网络异常，也可能是 token 验证失败，建议检查签算 token 的信息是否异常，若 token 无误，可重新尝试加入房间
Err_Reconnect_Failed	21003	30s 内未能重连成功或者重连时房间已被销毁	建议检查网络并重新申请 token 加入房间。当发生该错误时，之前创建的转推任务将被服务销毁，如有需要，应在下次成功加入房间后按业务需要恢复
Err_Fatal	21005	非预期错误	表示 RTC 生命周期异常，需要释放资源并重新初始化

SDK 重连机制：

SDK 内部会尝试无限重连

如果 30s 内无法完成有效的重连过程，则超时后的重连请求在到达 RTC 服务后会抛出 Err_Reconnect_Failed 错误

设备采集相关错误码

枚举值	错误码	说明	处理方式
Err_Mic_Init_Failed	23006	系统麦克风初始化错误，无权限或者麦克风被占用	请确认应用是否获取音频录制的权限或者麦克风是否被占用
Err_Mic_Capture_Failed	23007	麦克风录制失败	可尝试取消发布并重新发布麦克风 Track
Err_Speaker_Init_failed	23008	扬声器无权限或者被占用	请确认应用是否获取音频播放的权限或者扬声器被占用

发布 Track 相关错误码

枚举值	错误码	说明	处理方式
Err_Invalid_Parameter	10053	非法参数	请检查待发布 Track 是否为本地 Track，并且不为空
Err_Invalid_State	21002	非法状态	请检查是否已经加入房间
Err_Fatal	21005	非预期错误	RTC 生命周期异常，需要释放资源并重新初始化

CDN 转推相关错误码

枚举值	错误码	说明	处理方式
Err_No_Permission	10051	无操作权限	请检查用户的 token 签算权限
Err_Invalid_Parameter	10053	参数错误	请检查操作的参数是否合法
Err_Invalid_State	21002	状态异常	请检查房间状态，加入房间后才可以创建转推任务
Err_Network_Timeout	21004	操作超时	请重新尝试操作
Err_Fatal	21005	服务端错误	请重新尝试操作或者联系七牛技术支持同学协助定位

跨房媒体转发相关错误码

枚举值	错误码	说明	处理方式
Err_Relay_Token_Invalid	24000	Token 验证失败	请确认 Token 签算是否正确
Err_Relay_Already_Start	24001	已开启跨房	请勿重复操作
Err_Relay_Not_Start	24002	跨房没有开启	请先开启跨房再进行操作
Err_Relay_Destination_Room_Not_Existed	24003	目标房间不存在	请确认跨房的目标房间是否存在
Err_Relay_Player_In_Dest_Room	24004	用户不在目标房间内	请确认用户是否在目标房间内
Err_Relay_Start_Failed	24004	跨房开启失败	请确认跨房参数是否正确
Err_Invalid_Client_Mode	24006	使用场景不符	请切换到互动直播场景
Err_Invalid_Client_Role	24007	用户角色不符	请根据当前场景切换到指定角色再进行操作

以上内容是否对您有帮助？

Qvm free helper

服务•咨询