文档中心>云直播

查询录制文件

最近更新时间:2020-08-31 09:54:43

接口描述

注意:

由于该接口响应速度不理想,同时调用频率也不能太快(仅对刚结束的频道进行调用为宜),不推荐频繁使用。
推荐使用点播 API 接口进行查询:

  • 接口
    Live_Tape_GetFilelist:用于查询某条直播流某段时间内生成的录制文件。
  • 地址
    API 调用地址为:http://fcgi.video.qcloud.com/common_access
  • 说明
    由于文件的落地时间对您不可知,所以这种主动查询接口在调用时机上并不是特别好掌握,更推荐使用 被动事件通知(event_type = 100)机制。
注意:

  1. 查询频道录制文件结果信息,包含文件 ID 和文件 URL。
  2. 最长查询2个月内的录制文件。
  3. 查询时间段须包含创建录制任务时所带的任务时间段,仅带实际录制时间查询无效。

输入参数

参数名 参数含义 类型 备注 是否必需
appid 客户 ID int 即直播 appid,用于区分不同客户的身份 Y
interface 接口名称 string Live_Tape_GetFilelist Y
t 有效时间 int UNIX 时间戳 Y
sign 安全签名 string MD5(key+t) Y
Param.s.channel_id 直播码 string - Y
Param.n.page_no 分页页码 int 从1开始,默认为1 N
Param.n.page_size 分页大小 int 1 - 100,默认为10 N
Param.s.sort_type 排序方式 string asc 表示升序,desc 表示降序,默认 asc N
Param.s.start_time 查询开始时间 string 中国标准时间,需要 UrlEncode。如:2017-01-01 10:10:01,编码为:2017-01-01+10%3a10%3a01 N
Param.s.end_time 查询结束时间 string 中国标准时间,需要 UrlEncode。如:2017-01-01 10:10:01,编码为:2017-01-01+10%3a10%3a01。结束时间距开始时间一天以内,且不能跨天 N
注意:

有些早期提供的 API 中直播码参数被定义为 channel_id,新的 API 则称直播码为 stream_id,仅历史原因而已。

输出结果

参数名 参数含义 类型 备注
ret 返回码 int 0:成功;其他值:失败
message 错误信息 string 错误信息
output 消息内容 object 详情见下

其中 output 的主要内容为:

字段名 含义 类型 备注
all_count 分片总个数 int -
file_list 分片文件信息 array 详情见下

其中 file_list 的主要内容为:

字段名 含义 类型 备注
vid 点播的 vid string 如果为空,则使用 record_file_url
start_time 分片开始时间 string 由于 I 帧位置原因,并不能精确到秒
end_time 分片结束时间 string 由于 I 帧位置原因,并不能精确到秒
file_id 点播 file_id string 用点播 API 换取播放 URL 需要输入此参数
record_file_url 播放地址 string 如果不为空,则使用该地址;如果为空,采用 vid,按拼接格式拼接地址
注意:

vid 拼接格式,录制分片请求 url 格式: http://(点播bizid).vod.myqcloud.com/(vid).f0.flv

调用示例

目标:查询直播码为 8888_test123 的直播流在整个直播过程中所录制的文件列表。

组成部分 示例内容
接口 URL http://fcgi.video.qcloud.com/common_access?
appid 1234
interface Live_Tape_GetFilelist
Param.s.channel_id 8888_test123
Param.n.page_no 1
Param.n.page_size 20
t 1471850187
sign b17971b51ba0fe5916ddcd96692e9fb3
// copy时请去掉美化排版用的不可见换行符,否则可能出现 “appid is invalid” 等url拼装错误
URL = http://fcgi.video.qcloud.com/common_access?
            appid=1234&interface=Live_Tape_GetFilelist
            &Param.s.channel_id=8888_test123
            &Param.n.page_no=1
            &Param.n.page_size=20
            &t=1471850187&sign=b17971b51ba0fe5916ddcd96692e9fb3
            &Param.s.start_time=2017-01-01+10%3a10%3a01
            &Param.s.end_time=2017-01-01+10%3a10%3a01