Appearance
直播间详情
请求路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://gateway.nuoyunapi.com/Api/Room/roomInfo/2.0.0 - 频率限制:
10秒100次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| room_id | 是 | number | 直播间id |
请求示例
{
"room_id": 103891
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | string | 状态码:200-成功,400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 消息内容 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| room_id | 是 | number | 直播间id |
| live_status | 是 | string | 直播状态:预告、未直播、直播中、已结束、回放 |
| live_state | 是 | string | 直播状态:not_lived--未直播,living--直播中,up_coming--预告,not_start--未开始,playback--回放,ended--已结束 |
| live_url | 是 | object | 直播流地址/回放流地址 |
| is_live | 是 | boolean | 是否在推流 |
| uid | 是 | number | 账户uid |
| push_app_nick | 是 | string | 直播间名称 |
| app_cover | 是 | string | web端直播间封面图 |
| app_cover_mobile | 是 | string | 手机端直播间封面图 |
| desc | 是 | string | 微信分享描述文字 |
| description | 是 | string | 直播间简介 |
| start_time | 是 | number | 直播开始时间 |
| end_time | 是 | number | 直播结束时间 |
| visit_number | 是 | string | 浏览量,即观看人次pv |
| uv | 是 | number | 观看人数UV |
| room_url | 是 | string | 直播间观看地址 |
| room_webview_url | 否 | string | 直播间H5观看链接(小程序webview场景) |
| live_type | 是 | number | 直播间类型:0-视频直播,4-图片直播,5-互动直播,6-全景直播 |
| screen_type | 是 | number | 横竖屏:1-横屏,2-竖屏 |
| live_in_time | 是 | number | 直播时长 |
| avg_live_time | 是 | string | 平均观看时长 |
| g_id | 是 | number | 直播间分类id |
| g_name | 是 | string | 直播间分类名 |
live_url 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| webrtc_url | 是 | string | webrtc拉流地址 |
| rtmp_url | 是 | string | rtmp拉流地址 |
| hls_url | 是 | string | m3u8拉流地址 |
| flv_url | 是 | string | flv拉流地址 |
| type | 是 | string | 类型 |
| title | 是 | string | 标题 |
| vod_url | 是 | string | 回放地址 |
响应示例
未开始
json
{
"code": 200,
"data": {
"room_id": 644868499,
"live_status": "未开始",
"live_state": "not_start",
"live_url": {
"webrtc_url": "",
"rtmp_url": "",
"hls_url": "",
"flv_url": "",
"type": "",
"title": "",
"vod_url": "",
},
"is_live": false,
"uid": 2035,
"push_app_nick": "1111",
"app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
"app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
"desc": "",
"description": "",
"start_time": 1755045000,
"end_time": 1755061200,
"visit_number": "0",
"uv": 0,
"room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/644868499",
"room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/644868499",
"live_type": 0,
"screen_type": 1,
"live_in_time": 0,
"avg_live_time": "0.00",
"g_id": 0,
"g_name": "无分类"
},
"msg": "Success"
}直播中
json
{
"code": 200,
"data": {
"room_id": 1805938378,
"live_status": "直播中",
"live_state": "living",
"live_url": {
"webrtc_url": "",
"rtmp_url": "rtmp://wsu-play.nuoyun.tv/wx/iz43sogi_xhd?keeptime=259200&wsSecret=a25b2e8339a9a82e1c50562027a89c8c&wsTime=1754965698",
"hls_url": "https://wsu-play.nuoyun.tv/wx/iz43sogi_xhd.m3u8?keeptime=259200&wsSecret=917161140a2577aa30496fcf8cd83831&wsTime=1754965698",
"flv_url": "https://wsu-play.nuoyun.tv/wx/iz43sogi_xhd.flv?keeptime=259200&wsSecret=20644fca3fd846005703c828cee6b0da&wsTime=1754965698",
"type": "",
"title": "",
"vod_url": ""
},
"is_live": true,
"uid": 2035,
"push_app_nick": "123",
"app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
"app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
"desc": "",
"description": "",
"start_time": 1755045000,
"end_time": 1755061200,
"visit_number": "0",
"uv": 0,
"room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/1805938378",
"room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/1805938378",
"live_type": 0,
"screen_type": 1,
"live_in_time": 0,
"avg_live_time": "0.00",
"g_id": 0,
"g_name": "无分类"
},
"msg": "Success"
}直播间不存在
json
{
"code": 400,
"msg": "您无权限访问此直播间或直播间不存在",
"data": []
}