本文主要介绍在调用声网远程控制(RDC) API 过程中,SDK 返回的错误码(code
)和错误信息(message
)。
你可以根据如下错误码及错误信息了解出错的可能原因,并采取响应措施。对于未给出解决方法的错误码,声网推荐你联系技术支持,我们的技术支持人员会根据你在实际场景中遇到的问题进行排查。
声网 RDC SDK 在运行过程中,可能通过如下方式返回错误码和错误信息:
EVT_ERROR
回调报告错误码。 EVT_ERROR
回调报告的错误码。
code | message | 描述 |
---|---|---|
8001 |
Admin required | 当前操作需要计算机管理员权限,请先获取权限再重新操作。 |
8002 |
Invalid view size | 未设置主控端的视图区域或未指定被控端的共享屏幕,请先调用 updateViewPort 或 updateView 方法。 |
初始化声网 RDC 服务相关错误码。
code | message | 描述 |
---|---|---|
0 |
INIT ERR OK | 初始化声网 RDC 服务成功。 |
1 |
INIT ERR FAILURE | 初始化通用错误。 |
2 |
INIT ERR ALREADY INITIALIZED | 声网 RDC 服务已完成初始化,不能重复初始化。 |
3 |
INIT ERR INVALID APP ID | App ID 无效。请更换有效的 App ID 重新初始化。建议你检查 App ID 的格式是否有效。 |
4 |
INIT ERR INVALID ARGUMENT | Event Handler 为空。 |
登录相关错误码及错误信息。
code | message | 描述 |
---|---|---|
0 |
LOGIN ERR OK | 方法调用成功或登录成功。 |
1 |
LOGIN ERR UNKNOWN | 登录失败。原因未知。 |
2 |
LOGIN ERR REJECTED | 登录被服务器拒绝。 |
3 |
LOGIN ERR INVALID ARGUMENT | 无效的登录参数。 |
4 |
LOGIN ERR NVALID APP ID | 无效的 App ID。 |
5 |
LOGIN ERR INVALID TOKEN | 无效的 Token。 |
6 |
LOGIN ERR TOKEN EXPIRED | Token 已过期,登录被拒绝。 |
7 |
LOGIN ERR NOT AUTHORIZED | 预留错误码 未经授权的登录。 |
8 |
LOGIN ERR ALREADY LOGIN | 用户已登录,或正在登录声网 RDC 系统,或未调用 logout 方法登出。 |
9 |
LOGIN ERR TIMEOUT | 登录超时。目前的超时设置为 12 秒。你需要再次登录。 |
10 |
LOGIN ERR TOO OFTEN | 登录过于频繁。超过 2 次每秒的上限。 |
101 |
LOGIN ERR NOT INITIALIZED | 声网 RDC 服务未完成初始化。 |
登出相关错误码及错误信息。
code | message | 描述 |
---|---|---|
0 |
LOGOUT ERR OK | 登出成功。没有错误。 |
1 |
LOGOUT ERR REJECTED | 预留错误码 |
101 |
LOGOUT ERR NOT INITIALIZED | 声网 RDC 服务未完成初始化。 |
102 |
LOGOUT ERR USER NOT LOGGED IN | 登出声网 RDC 系统前未调用 login 方法或者 login 方法调用未成功。 |
加入频道相关错误码及错误信息。
code | message | 描述 |
---|---|---|
0 |
JOIN_CHANNEL_ERR_OK | 方法调用成功,或用户加入频道成功。 |
1 |
JOIN_CHANNEL_ERR_FAILURE | 通用错误。用户加入频道失败。 |
3 |
JOIN_CHANNEL_ERR_INVALID_ARGUMENT | 用户加入频道失败。输入参数无效。 |
4 |
JOIN_CHANNEL_TIMEOUT | 用户加入频道超时。目前的超时设置为 5 秒。可能原因:用户正处于与 RDC 系统断开的状态。 |
5 |
JOIN_CHANNEL_ERR_EXCEED_LIMIT | 同时加入的频道数超过 20 上限。 |
6 |
JOIN_CHANNEL_ERR_ALREADY_JOINED | 用户正在加入频道或已成功加入频道。 |
7 |
JOIN_CHANNEL_ERR_TOO_OFTEN | 方法调用超过每 3 秒 50 次的上限。 |
8 |
JOIN_CHANNEL_ERR_JOIN_SAME_CHANNEL_TOO_OFTEN | 加入相同频道的频率超过每 5 秒 2 次的上限。 |
101 |
JOIN_CHANNEL_ERR_NOT_INITIALIZED | 声网 RDC 服务未完成初始化。 |
102 |
JOIN_CHANNEL_ERR_USER_NOT_LOGGED_IN | 用户加入频道前未调用 login 方法或者 login 方法调用未成功。 |
离开频道相关错误码及错误信息。
code | message | 描述 |
---|---|---|
0 |
LEAVE CHANNEL ERR OK | 方法调用成功,或用户离开频道成功。 |
1 |
LEAVE CHANNEL ERR FAILURE | 通用错误。用户离开频道失败。 |
2 |
LEAVE CHANNEL ERR REJECTED | 预留错误码 |
3 |
LEAVE CHANNEL ERR NOT IN CHANNEL | 用户已不在频道内。 |
101 |
LEAVE CHANNEL ERR NOT INITIALIZED | 声网 RDC 服务未完成初始化。 |
102 |
LEAVE CHANNEL ERR USER NOT LOGGED IN | 用户在调用 leaveChannel 方法前未调用 login 方法或者 login 方法调用未成功。 |
点对点指令发送相关错误码及错误信息。
code | message | 描述 |
---|---|---|
1 |
PEER MESSAGE ERR FAILURE | 发送点对点指令失败。 |
2 |
PEER MESSAGE ERR SENT TIMEOUT | 发送点对点指令超时。当前的超时时间设置为 10 秒。可能原因:用户正处于与 RDC 系统断开的状态。 |
3 |
PEER MESSAGE ERR PEER UNREACHABLE | 对端用户不在线(用户不存在或与 RDC 系统断开),发出的点对点指令未被收到。 |
5 |
PEER MESSAGE ERR TOO OFTEN | 发送指令(点对点指令和频道内指令一并计算在内)超过每 3 秒 180 次的上限。 |
6 |
PEER MESSAGE ERR INVALID USERID | 用户 ID 无效。 |
7 |
PEER MESSAGE ERR INVALID MESSAGE | 指令为 NULL 或超出 32 KB 的长度限制。 |
101 |
PEER MESSAGE ERR NOT INITIALIZED | 声网 RDC 服务未完成初始化。 |
102 |
PEER MESSAGE ERR USER NOT LOGGED IN | 发送点对点指令前未调用 login 方法或者 login 方法调用未成功。 |
文件上传相关错误码及错误信息。
code | message | 描述 |
---|---|---|
0 |
UPLOAD MEDIA ERR OK | 方法调用成功,或上传操作成功。 |
1 |
UPLOAD MEDIA ERR FAILURE | 通用未知错误。请检查文件是否存在或是否有权限。 |
2 |
UPLOAD MEDIA ERR INVALID ARGUMENT | 内部参数错误。请联系技术支持。 |
3 |
UPLOAD MEDIA ERR TIMEOUT | 服务器响应超时。当前如果 SDK 与文件服务器之间没有文件传输达 120 秒时,SDK 认定上传超时。 |
4 |
UPLOAD MEDIA ERR SIZE OVERFLOW | 上传文件大小超过 30 MB 上限。 |
5 |
UPLOAD MEDIA ERR CONCURRENCY LIMIT EXCEEDED | 文件同时上传数超过 9 个的上限(上传任务和下载任务可一并计算)。 |
6 |
UPLOAD MEDIA ERR INTERRUPTED | 文件上传任务因如下原因中途退出:上传方处于与 RDC 系统断开的状态。上传方取消了文件上传。 |
101 |
UPLOAD MEDIA ERR NOT INITIALIZED | 声网 RDC 服务未完成初始化。 |
102 |
UPLOAD MEDIA ERR NOT LOGGED IN | 本次操作前未调用 login 方法或者 login 方法调用未成功。 |
文件下载相关错误码及错误信息。
code | message | 描述 |
---|---|---|
0 |
DOWNLOAD MEDIA ERR OK | 方法调用成功,或下载操作成功。 |
1 |
DOWNLOAD MEDIA ERR FAILURE | 通用未知错误。请检查是否有写权限。 |
2 |
DOWNLOAD MEDIA ERR INVALID ARGUMENT | 内部参数错误。请联系技术支持。 |
3 |
DOWNLOAD MEDIA ERR TIMEOUT | 服务器响应超时。当前如果 SDK 与文件服务器之间没有文件传输达 120 秒时,SDK 认定下载超时。 |
4 |
DOWNLOAD MEDIA ERR NOT EXIST | 要下载的文件不存在,可能是内部参数错误。请联系技术支持。 |
5 |
DOWNLOAD MEDIA ERR CONCURRENCY LIMIT EXCEEDED | 文件同时下载数超过 9 个的上限(上传任务和下载任务一并计算)。 |
6 |
DOWNLOAD MEDIA ERR INTERRUPTED | 文件下载任务因如下原因中途退出:下载方处于与 RDC 系统断开的状态。下载方取消了文件下载。 |
101 |
DOWNLOAD MEDIA ERR NOT INITIALIZED | 声网 RDC 服务未完成初始化。 |
102 |
DOWNLOAD MEDIA ERR NOT LOGGED IN | 本次操作前未调用 login 方法或者 login 方法调用未成功。 |
文件传输相关错误码。
code | 描述 |
---|---|
1 |
content 传入空值。 |
2 |
剪贴板内容为空。 |
3 |
传入文件路径错误。 |
4 |
上传文件至服务器失败。 |
5 |
创建文本指令失败。 |
6 |
发送文本指令失败。 |