创建课堂
初始化SDK , 当SDK初始化成功后才可以使用,否则报验证失败错误
请求参数 | 描述 |
---|---|
Context | 上下文 |
appKey | 课堂SDK 身份验证 |
appSecretKey | 课堂SDK 身份验证 |
VHClass.getInstance().init(context, "", "");
一、获取课堂基础信息
获取课堂的基本信息,可以基本拿到这个课堂的状态,类型,介绍,等信息,知道这个课堂的内容。可以多次获取,及时刷新界面信息,保证数据统一。 传入的deviceId是用来区分学员,
请求参数 | 描述 |
---|---|
classId | 课堂ID 参考: edu_xxxxxxxxx |
deviceId | 唯一身份标识,必须保证唯一且不变,可以自由组合 |
ClassInfoCallback | 信息请求回调 |
返回ClassInfo.Webinar 参数 | 描述 |
---|---|
id | 课堂ID |
subject | 标题 |
course_type | 课堂类型 |
type | 当前课堂类型 |
status | 当前课堂状态 |
layout | 布局模式 |
introduction | 课堂介绍 |
course_type |
代码展示:
VHClass.getInstance().getClassInfo(mClassId, ClassApplication.device, new VHClass.ClassInfoCallback() {
@Override
public void onSuccess(ClassInfo.Webinar webinar) {
//信息获取成功
Toast.makeText(MainActivity.this, "信息获取成功" , Toast.LENGTH_SHORT).show();
}
@Override
public void onError(int errorCode, String errorMsg) {
//信息获取失败
Toast.makeText(MainActivity.this, "" + errorMsg, Toast.LENGTH_SHORT).show();
}
});
二、加入课堂
所谓的加入课堂,就是指进入这个已经存在的课堂,提供你的基本信息,比如你的唯一标识,你在课堂中的名字,还有这个课堂的密码,当你调用这个方法并且成功后,并且返回成功,你就已经加入了一个课堂,且这个方法只能调用一次,当需要重新调用时,必须先调用离开课堂的方法。方法调用成功后,消息服务器就会连接上,你的信息就会出现在Web端的学员列表中,老师也可以看到你。
请求参数 | 描述 |
---|---|
classId | 课堂ID 参考: edu_xxxxxxxxx |
deviceId | 唯一身份标识,必须保证唯一且不变,可以自由组合 |
nickName | 进入课堂后的学员姓名 |
pass | 该课堂设置的学员密码 |
RequestCallback | 请求回调 |
代码展示:
VHClass.getInstance().joinClass(
mClassId, ClassApplication.device, nickname, pwd, new VHClass.RequestCallback() {
@Override
public void onSuccess() {
//进入课堂成功
}
@Override
public void onError(int errorCode, String errorMsg) {
//进入课堂失败
Toast.makeText(MainActivity.this, "" + errorMsg, Toast.LENGTH_SHORT).show();
}
});
三、离开课堂
当调用此方法时,SDK内部会将消息断开,同时web端也不在显示你的信息,也接收不到来自课堂的消息,也会清空你在这个课堂的所有信息
代码展示:
VHClass.getInstance().leaveClass
三、课堂回调相关
注册课堂消息回调,从这个回调接收课堂中的消息
addClassCallback
注销回调监听
removeClassCallback
注册和注销必需成对出现,否则会存在内存泄漏及重复回调风险
VHClass.getInstance().addClassCallback(obj);
VHClass.getInstance().removeClassCallback(obj);
public interface ClassCallback {
// 事件信息回到
void onEvent(int eventCode, String msg);
// 消息回调
void onMessageReceived(MessageServer.MsgInfo msgInfo);
// 聊天回调
void onChatReceived(ChatServer.ChatInfo chatInfo);
// 课堂错误回调
void onError(int eventCode, String msg);
}