音视频通话

进入/离开房间

房间创建完成后,客户端需要通过进入/离开房间接口来完成整个音视频会话的生命周期管理。

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 请参考: