进入/离开房间
房间创建完成后,客户端需要通过进入/离开房间接口来完成整个音视频会话的生命周期管理。本节介绍 Android SDK 中与「进入、离开、请出、掉线与房间结束」相关的典型用法。
1. 进入房间
进入房间前需满足以下条件:
- 已调用登录接口并登录成功;
- 已获取到有效的房间号(例如通过 createMeeting 创建,或业务服务器下发)。
进入房间使用接口 enterMeeting:
int meetID = 12345678;
String nickName = "用户A";
RTCMeeting.getInstance().enterMeeting(meetID, nickName);
进入结果在回调 enterMeetingRslt 中返回:
@Override
void enterMeetingRslt(CRVIDEOSDK_ERR_DEF sdkErr) {
if (sdkErr == CRVIDEOSDK_ERR_DEF.CRVIDEOSDK_NOERR) {
// 入会成功,可以打开视频、麦克风、屏幕共享等
} else {
// 入会失败,根据错误码提示用户
}
}
当本端进入房间成功后,房间内其它成员会收到 userEnterMeeting 通知:
@Override
void userEnterMeeting(String userID) {
// 更新 UI(成员列表、参会人数等)
}
相关 API 参考:
2. 主动离开房间
当用户主动退出房间时,调用 exitMeeting 即可:
RTCMeeting.getInstance().exitMeeting();
接口说明要点:
- 调用 exitMeeting 不需要等待服务器响应,即使网络较差或已断网,也视为本端已经离会;
- 离开房间后将不再收到任何房间内的消息;
- 如果离会时网络正常,房间内其他成员会立刻收到 userLeftMeeting 通知。
@Override
void userLeftMeeting(String userID) {
// 从成员列表中移除 userID,刷新界面
}
若希望彻底结束房间本身(而不仅是某个成员离开),请参考 destroyMeeting。
相关 API 参考:
3. 请出房间
房间内具备相应操作权限的用户(通常是主持人/管理员)可以将其他成员请出房间,使用接口 kickout:
RTCMeeting.getInstance().kickout("user_b");
被请出的一方会收到 meetingDropped 通知,可用于做定向提示:
@Override
void meetingDropped(CRVIDEOSDK_MEETING_DROPPED_REASON reason) {
// 根据 reason 判断是否为被请出、网络异常等
}
其余仍在房间中的成员会收到 userLeftMeeting 通知,用于刷新成员列表。
相关 API 参考:
4. 掉线离开房间
除主动退会和被请出外,用户也可能因为网络问题等原因被动与房间断开连接。此时 SDK 会触发 meetingDropped 或 lineOff 回调:
@Override
void meetingDropped(CRVIDEOSDK_MEETING_DROPPED_REASON reason) {
// 可调用 enterMeeting 尝试重新进入房间
}
更多连接状态说明参见 连接状态管理。
相关 API 参考:
5. 房间被销毁
当房间被主动销毁(例如管理员调用 destroyMeeting)时,所有仍在房间中的成员都会收到 meetingStoped 通知:
@Override
void meetingStoped() {
// 1. 关闭本地音视频设备、停止屏幕共享
// 2. 切换到「会议已结束」界面
// 3. 清理与房间相关的 UI 状态和业务数据
}
收到房间结束通知后,无需再调用 exitMeeting,因为房间已经不存在。
相关 API 参考: