互动白板>客户端 API>Android

Android

编辑文档更新于 2024-11-11 06:14:32

概况房间文档与白板用户聊天对象和枚举错误码最佳实践

BRTMError

BRTMError 是 BRTM SDK 对程序运行过程中可能发生的各种错误和异常的含义封装，方便程序员快速明确错误原因。

一、方法

注：这里仅针对 get方法进行解释。

名称	函数体	说明
getMessage	`public String getMessage()`	获取错误描述。可能为 null 或者空字符串。某些名称就有自解释功能的错误码，可能就没有额外的错误描述文字了。
getCode	`public long getCode()`	获取错误码。每一个错误码值都是唯一的，具有特定的含义。
getNewError	`public getNewError(int code)` `public getNewError(int code, String message)` `public getNewError(int code, Throwable e)`	通过错误码、错误描述或 `Throwable`对象来构造一个 BRTMError 对象
getException	`public Throwable getException()`	获取错误码对应的 Throwable 对象

二、错误码

基础错误码

符号	值	含义
CODE_OK	0	无错误的正常返回值
CODE_ERROR_UNKNOWN	-1	未知错误

网络相关

符号	值	含义
CODE_ERROR_NETWORK_FAILURE	1000	失败、无网
CODE_ERROR_HOST_UNKNOWN	1001	域名解析失败
CODE_ERROR_ROOM_SERVER_FAILED	1002	room server 连接失败
CODE_ERROR_MASTER_SERVER_LOSE_CONNECTION	1003	master server 连接失败
CODE_ERROR_ROOM_SERVER_CONNECTION_TIME_OUT	1004	room server 连接超时
CODE_ERROR_ENTER_ROOM_FAIL	1005	在连接 BRTM 某服务器时，任务发生异常
CODE_ERROR_SERVER_CONNECTION_RESTORED	1006	断网重连恢复后的通知事件

参数、值相关

符号	值	含义
CODE_ERROR_INVALID_PARAMS	2000	参数非法
CODE_ERROR_ANIM_PPT_ILLEGAL	2001	动态文档格式非法
CODE_ERROR_STATIC_PPT_ILLEGAL	2002	静态文档格式非法
CODE_ERROR_ADD_PAGE_ILLEGAL	2003	添加/删除白板时，传入的 docId 不对
CODE_ERROR_CHANGE_PAGE_ILLEGAL	2004	翻页下标越界
CODE_ERROR_OBJECT_NOT_INITIALIZED	2005	内部关键变量尚未初始化，操作无法正确执行

房间逻辑相关

符号	值	含义
CODE_ERROR_ENTER_ROOM	3000	进房间失败
CODE_ERROR_WHITEBOARD_COUNT_EXCEED	3001	超过最大白板数
CODE_ERROR_WHITEBOARD_LESS_THAN_ONE	3002	白板最少得有一页
CODE_ERROR_SIGNAL_FREQUENCY_TOO_HIGH	3003	信令发送频率过高
CODE_ERROR_LOGIN_CONFLICT	3004	登录冲突

文件读写相关

符号	值	含义
CODE_ERROR_FILE_NOT_EXIST	4000	文件不存在
CODE_ERROR_DATA_NOT_EXIST	4001	本地无此数据

退出教室相关

符号	值	含义
CODE_ERROR_LOGOUT_CLASS_ROOM_CLOSE	5001	教室强制关闭
CODE_ERROR_LOGOUT_PRESENTER_LEAVE	5002	主讲人离开
CODE_ERROR_LOGIN_KICK_OUT_WITHOUT_BLOCK	5003	被踢出但没有拉黑
CODE_ERROR_LOGIN_KICK_OUT	5004	被踢出且拉黑

{{allComment[version]}} ×

暂无评论
{{comment.author}}

{{ comment.createdAt | date: 'yyyy-MM-dd HH:mm:ss '}}

{{comment.content}}