McuClient_v.1.0.1_API.md
12.3 KB
McuClient API参考说明
##McuClient 目录 ##
创建McuClient对象
McuClient接口
McuClient回调事件
ErrorCode 错误码查询
##使用步骤说明 ##
- 创建McuClient对象
- McuClient初始化init
- 添加MessageTypes中的事件监听(接收各个模块的消息)
- McuClient加入会议
- 加入会议成功之后可以调用其他接口和监听事件
##创建McuClient对象 ## 只创建一次
示例代码
window.onload=function(){
//创建client,这是必须的第一步
const client=MCUClientEngine.createMcuClient();
//获取事件监听消息定义
const MessageTypes=MCUClientEngine.MessageTypes;
}
McuClient接口
初始化
client.init (paramInfo,onSuccess,mcuErrorEventHandler)
client创建完成之后第一步需要初始化。
示例代码
var paramInfo={
"meetingNumber":123456,
"portal":"127.0.0.1:80",
"usertRole":"normal",
"userID":0,
};
//初始化
client.init(paramInfo,onSuccess,mcuErrorEventHandler);
function onSuccess(callbackData){
//初始化成功回调
//{"siteId":"h5test","passwordRequired":true,"md5":"de399d5540b3da2fbc1eb0a770d4fd66","code":0,"msType":1}
};
function mcuErrorEventHandler(callbackData){
//整个MCUClient中Error异常监听
//返回值callbackData的结构为{"code":errorCode,"reson":""}
//errorCode的列表在文档最后面的 ErrorCode错误码查询
};
参数名称 |
类型 |
该对象包含以下属性 |
| paramInfo | 对象 |
|
|
||
|
||
|
||
|
||
onSuccess |
Function |
(必选) Function 初始化成功回调函数,返回值:{"siteId":"h5test","passwordRequired":true,"md5":"de399d5540b3da2fbc1eb0a770d4fd66","code":0,"msType":1} |
mcuErrorEventHandler |
Function |
(必选) Function 整个MCUClient中Error异常监听 |
参数名称 |
类型 |
该对象包含以下属性 |
| paramInfo | 对象 |
|
|
||
|
||
onSuccess |
Function |
(必选) Function 成功回调函数 |
参数名称 |
类型 |
该对象包含以下属性 |
| callbackData | 对象 |
|
|
|
参数名称 |
类型 |
该对象包含以下属性 |
| paramInfo | 对象 |
|
|
|
错误代码 |
值(code) |
描述(reson) |
| ERR_CLASS_INIT_PAEAM | 100 | 初始化参数错误 |
| ERR_CLASS_INIT_NETWORK | 101 | 初始化网络错误 |
| ERR_CLASS_INIT_PROTOCOL | 102 | 初始化协议错误 |
| ERR_CLASS_INIT_FAILED | 103 | 初始化验证失败 |
| ERR_CLASS_JOIN_NETWORK | 200 | 加入会议网络错误 |
| ERR_CLASS_JOIN_PROTOCOL | 201 | 加入会议化协议错误 |
| ERR_CLASS_JOIN_FAILED | 202 | 加入会议化异常错误 |
| ERR_CLASS_JOIN_PARAM | 203 | 加入会议参数错误 |
| ERR_CLASS_JOIN_FULL | 204 | 人数已满 |
| ERR_CLASS_MD5_WRONG | 205 | MD5验证失败 |
| ERR_CLASS_PASSWORD_WRONG | 206 | 密码错误 |
| ERR_CLASS_JOIN_CONFILICT | 207 | 已经在其它地方登陆 |
| ERR_GET_CLASS_DETAIL | 300 | 获取classDetail失败 |
| ERR_GET_MEETING_PARAML | 301 | 获取MeetingParam失败 |
| ERR_NETWORK | 10000 | 网络错误 |
| ERR_UNKNOWN | 10001 | 未知错误 |