Appearance
创建直播间
历史版本
请求路径
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://gateway.nuoyunapi.com/Api/RoomManager/createRoom/2.0.0 - 频率限制：
10秒100次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| push_app_nick | 是 | string | 直播间名称 |
| start_time | 是 | string | 开始时间 |
| end_time | 是 | string | 结束时间 |
| replay_status | 是 | integer | 回放状态： 1: 开启；2: 未开启 |
| is_webrtc | 是 | integer | 超低延迟设置1:开启；2:关闭默认：关闭 |
| live_status | 是 | integer | 直播状态：0: 不展示；1: 展示 |
| screen_type | 是 | integer | 1横屏，2竖屏 |
| version | 是 | integer | 版本：1体验，2单场，3包月，4包年，5旗舰 |
| live_type | 是 | integer | 类型：0-视频直播，4-图片直播，5-互动直播，6-全景直播 |
| visit_number_switch | 否 | integer | 热力值：0:不展示；1: 展示 |
| chat_backage_image | 否 | string | 直播间聊天背景 |
| theme_type | 否 | integer | 直播间主题 |
| is_lcb | 否 | integer | 慢直播。1：开启；2：关闭 |
| app_cover | 否 | string | 播放器封面 |
| scenes | 否 | integer | 使用场景：1-通用 2-电商 3-培训 4-会议 5-年会 6-教育 7-婚礼 8 其他 |
| app_cover_mobile | 否 | string | 手机端播放器封面-电商直播专用 |
| lm_mode | 否 | integer | 连麦模式：1--普通；2--圆桌 |
| lm_number_type | 否 | integer | 连麦数量类型。 1：1v6 2：1v16 3：1v1 |
| lm_layout_type | 否 | integer | 连麦布局类型。 1：宫格 2：画中画 |
| description | 否 | string | 描述 |
| uid | 否 | integer | 用户ID |
| pic_live_add | 否 | string | 图片直播时-直播地点 |
请求示例
json
{
"push_app_nick": "接口创建---66666",
"start_time": "2025-08-12 10:30:34",
"end_time": "2025-09-31 13:00:00",
"replay_status": 2,
"is_webrtc": 1,
"live_status": 0,
"visit_number_switch": 1,
"chat_backage_image": "",
"theme_type": 5,
"is_lcb": 2,
"app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
"scenes": 3,
"app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
"screen_type": 1,
"lm_mode": 2,
"description": "描述信息验证",
"version": 3,
"live_type": 1,
"uid": 45808,
"lm_number_type": 3,
"lm_layout_type": 2,
"pic_live_add": "测试地址"
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 状态码：200-成功，400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 响应数据 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| room_id | 是 | integer | 直播间ID |
响应示例
成功响应
json
{
"code": 200,
"data": {
"room_id": 320993070
},
"msg": "Success"
}返回值状态码说明
| 状态码 | 描述 |
|---|---|
| 200 | 成功 |
| 400 | 失败 |
注意事项
- 时间格式：时间格式为
YYYY-MM-DD HH:mm:ss，如：2025-08-12 10:30:34 - 版本权限：
version参数决定直播间功能权限：- 1：体验版（基础功能）
- 2：单场版（单次直播）
- 3：包月版（一个月内无限次直播）
- 4：包年版（一年内无限次直播）
- 5：旗舰版（全功能版本）
- 直播类型：
live_type支持多种直播类型：- 0：视频直播（历史默认）
- 1：视频直播（历史婚礼）
- 2：视频直播（历史电商）
- 3：视频直播（历史年会）
- 4：图片直播
- 5：互动直播
- 6：全景直播
- 连麦配置：如果使用连麦功能，需要配置：
lm_mode：连麦模式lm_number_type：连麦数量类型lm_layout_type：连麦布局类型
- 使用场景：
scenes参数用于标识使用场景，便于数据统计和功能优化