Skip to content

回放视频列表(新)

历史版本

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://gateway.nuoyunapi.com/Api/Library/getLiveHomeList/2.0.0
  • 频率限制:10秒30次

请求参数

参数必选类型描述
room_idinteger直播间ID
pageinteger第几页(最小值1)
page_sizeinteger一页显示多少(最小值为1,最大值500)

请求示例

json
{
    "room_id": 10001,
    "page": 1,
    "page_size": 10
}

响应参数

参数必选类型描述
codeinteger状态码:200-成功,400-失败
msgstring提示信息
dataobject视频数据

data 参数结构

参数必选类型描述
totalinteger视频总数
listarray视频列表

list 参数结构

参数必选类型描述
idinteger视频ID
titlestring标题
vod_urlstring视频URL
video_durstring视频时长
snap_urlstring封面URL
ts_timestring最近一次推流状态修改时间
deal_idinteger处理标识,0文件不存在,1文件存在
v_typeinteger1:直播录制原始视频 2:剪辑后视频
video_classtypestring视频来源类型record录制 transcode转码 edit剪辑合并 concat拼接 transcoding正在转码
download_urlstring下载链接
file_formatstring媒体格式hls(m3u8) mp4 aac
sizeinteger视频文件大小 单位字节byte
file_idstring媒体文件ID
playback_statusboolean判断是否是在回放中 true:在回放 false:不在回放中
prep_statusboolean判断是否是在预播放中 true:在预播放 false:不在预播放
media_sourcestringupload:上传,edit:剪贴编辑,record:直播录制,transcode:转码,edit:剪辑合并,upload:正在转码
timestring最近一次推流状态修改时间

响应示例

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失败