进入/离开房间
房间创建完成后,客户端需要通过进入/离开房间接口来完成整个音视频会话的生命周期管理。
1. 进入房间
进入房间前需满足以下条件:
-
已调用登录接口并登录成功
-
已获取到有效的房间号(例如通过 createMeeting 创建,或业务服务器下发)
-
调用接口:
int meetID = 12345678;
g_sdkMain.getSDKMeeting().enterMeeting(meetID);
注意:房间内显示昵称通过登录时 sdkLoginDat 的 _nickName 字段设置,入会接口不单独传昵称。
- 回调通知:
private void enterMeetingRslt(CRVSDK_ERR_DEF sdkErr)
{
if (sdkErr == CRVSDK_ERR_DEF.CRVSDKERR_NOERR)
{
// 入会成功,可以打开视频、麦克风、屏幕共享等
}
else
{
// 入会失败
}
}
private void notifyUserEnterMeeting(string userID)
{
// 有人进入房间,更新成员列表
}
相关 API 请参考:
2. 主动离开房间
g_sdkMain.getSDKMeeting().exitMeeting();
接口说明要点:
- 调用 exitMeeting 不需要等待服务器响应,即使网络较差也视为本端已经离会
- 离开房间后将不再收到任何房间内的消息
- 网络正常时,其他成员会收到 notifyUserLeftMeeting 通知
private void notifyUserLeftMeeting(string userID)
{
// 从成员列表中移除 userID
}
相关 API 请参考:
3. 请出房间
具备权限的用户可将其他成员请出房间:
g_sdkMain.getSDKMeeting().kickout("user_b");
private void kickoutRslt(CRVSDK_ERR_DEF sdkErr, string userID)
{
// 仅发起请出的一方收到
}
private void notifyMeetingDropped(CRVSDK_MEETING_DROPPED_REASON reason)
{
// 被请出方收到,reason == CRVSDK_DROPPED_KICKOUT
}
相关 API 请参考:
4. 掉线离开房间
网络问题导致断线时,SDK 会触发 notifyLineOff 回调,详见 连接状态管理。
5. 房间被销毁
当房间被主动销毁时,所有仍在房间中的成员都会收到 notifyMeetingStopped 通知,无需再调用 exitMeeting。
相关 API 请参考: