房间是 NERoom 产品的基石，搭建应用场景时，您首先需要创建房间。

注意事项

• 创建房间后，不会自动加入房间，您需要调用接口加入房间。
• PK 直播房间的保留时长最多为 24 小时，超过 24 小时，NERoom Server会自动删除该房间。
• 其他业务场景中，房间的保留时长最多为 16 小时，超过 16 小时，NERoom Server会自动删除该房间。
• 如果您需要延长默认的房间保留时长，请联系网易云信商务经理。

配置步骤

调用 createRoom 接口创建房间。

virtual void createRoom(const NECreateRoomParams& params, const NECreateRoomOptions& options, const NERoomCallback& callback) = 0;

• NECreateRoomParams 相关参数说明如下表所示。

  参数	描述
  roomUuid	房间 ID，房间 ID 需要保证全局唯一。 最大长度为 64 个字符。
  roomName	房间名。 最大长度为 64 个字符。
  templateId	模板 ID。类型：int。模板 ID 的值如下： 线上会议：40 互动直播：3 在线K歌：400 语聊房：569 自定义模板：模板 ID获取方法请参见如何获取模板 ID。
  password	（可选）设置当前房间的密码。如果设置为空，表示用户进入房间时无需密码。
  initialProperties	（可选）初始化房间属性。具体请参见房间属性。

• NECreateRoomOptions 相关参数说明如下表所示。

  参数	描述
  enableRtc	设置该房间是否包含音视频通话的功能。 true：包含音视频通话功能。 false：不包含音视频通话功能。 默认值：true。
  enableChatroom	设置该房间是否开启即时消息的功能。 true：包含即时消息功能。 false：不包含即时消息功能。 默认值：false。
  enableWhiteboard	设置该房间是否包含互动白板的功能。 true：包含互动白板功能。 false：不包含互动白板功能。 默认值：false。
  enableRecord	设置该房间是否包含云端录制的功能。 true：包含云端录制功能。 false：不包含云端录制功能。 默认值：false。
  enableLive	设置该房间是否包含直播的功能。 true：包含直播功能。 false：不包含直播功能。 默认值：false。

示例代码

实现创建房间功能的示例代码如下：

    NECreateRoomParams params;
    params.roomName = ui->leRoomName->text().toStdString();
    params.roomUuid = ui->leRoomUuid->text().toStdString();
    params.templateId = ui->leRoomConfigId->text().toInt();
    NECreateRoomOptions options;
    options.enableRtc = true;
    options.enableChatroom = true;
    options.enableWhiteboard = false;
    options.enableRecord = false;
    options.enableLive = true;
    m_pRoomkit->getRoomService()->createRoom(params, options, [this](int code, const std::string& msg){
        qInfo() << "code: " << code;
        qInfo() << "msg: " << QString::fromStdString(msg);
    });

API 参考