Appearance
回放视频列表(新)
历史版本
请求路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://gateway.nuoyunapi.com/Api/Library/getLiveHomeList/2.0.0 - 频率限制:
10秒30次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| room_id | 是 | integer | 直播间ID |
| page | 是 | integer | 第几页(最小值1) |
| page_size | 是 | integer | 一页显示多少(最小值为1,最大值500) |
请求示例
json
{
"room_id": 10001,
"page": 1,
"page_size": 10
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 状态码:200-成功,400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 视频数据 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| total | 是 | integer | 视频总数 |
| list | 是 | array | 视频列表 |
list 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | integer | 视频ID |
| title | 是 | string | 标题 |
| vod_url | 是 | string | 视频URL |
| video_dur | 是 | string | 视频时长 |
| snap_url | 是 | string | 封面URL |
| ts_time | 是 | string | 最近一次推流状态修改时间 |
| deal_id | 是 | integer | 处理标识,0文件不存在,1文件存在 |
| v_type | 是 | integer | 1:直播录制原始视频 2:剪辑后视频 |
| video_classtype | 是 | string | 视频来源类型record录制 transcode转码 edit剪辑合并 concat拼接 transcoding正在转码 |
| download_url | 是 | string | 下载链接 |
| file_format | 是 | string | 媒体格式hls(m3u8) mp4 aac |
| size | 是 | integer | 视频文件大小 单位字节byte |
| file_id | 是 | string | 媒体文件ID |
| playback_status | 是 | boolean | 判断是否是在回放中 true:在回放 false:不在回放中 |
| prep_status | 是 | boolean | 判断是否是在预播放中 true:在预播放 false:不在预播放 |
| media_source | 是 | string | upload:上传,edit:剪贴编辑,record:直播录制,transcode:转码,edit:剪辑合并,upload:正在转码 |
| time | 是 | string | 最近一次推流状态修改时间 |
响应示例
json
{
"code": 200,
"data": {
"total": 15,
"list": [
{
"id": 100001,
"title": "示例直播回放视频1",
"vod_url": "https://example.vod-qcloud.com/example/vodcq123456/abc123def456/playlist_eof.m3u8",
"video_dur": "00:15:30",
"snap_url": "https://example.vod-qcloud.com/example/vodtranscq123456/abc123def456/coverBySnapshot/cover_10_0.jpg",
"ts_time": "20250101120000",
"deal_id": 1,
"v_type": 1,
"video_classtype": "record",
"download_url": "https://example.vod-qcloud.com/example/vodcq123456/abc123def456/download.mp4",
"file_format": "hls",
"size": 157286400,
"file_id": "1234567890123456001",
"playback_status": false,
"prep_status": false,
"media_source": "record",
"time": "2025-01-01 12:00"
},
{
"id": 100002,
"title": "示例直播回放视频2",
"vod_url": "https://example.vod-qcloud.com/example/vodcq123456/xyz789abc123/playlist_eof.m3u8",
"video_dur": "00:08:45",
"snap_url": "https://example.vod-qcloud.com/example/vodtranscq123456/xyz789abc123/coverBySnapshot/cover_10_0.jpg",
"ts_time": "20250101140000",
"deal_id": 1,
"v_type": 1,
"video_classtype": "record",
"download_url": "https://example.vod-qcloud.com/example/vodcq123456/xyz789abc123/download.mp4",
"file_format": "hls",
"size": 89128960,
"file_id": "1234567890123456002",
"playback_status": false,
"prep_status": false,
"media_source": "record",
"time": "2025-01-01 14:00"
}
]
},
"msg": "Success"
}状态码说明
| 状态码 | 描述 |
|---|---|
| 200 | 成功 |
| 400 | 失败 |