Miku 快直播 > API 文档 > 直播录制API > 生成指定时间范围录制文件

生成指定时间范围录制文件

最近更新时间: 2026-09-23 15:07:29

描述

生成指定时间范围录制文件

接口信息

请求方法: POST
请求地址: <bucket>.mls.cn-east-1.qiniumiku.com
请求路径: /

请求参数

Query 参数

参数名称	类型	必填	示例值	描述
recordingFile	string	必须	无	固定字段

Header 参数

参数名	类型	必填	示例值	描述
Host	string	是	`<bucket>`.mls.cn-east-1.qiniumiku.com	请求的服务域名，Host 中的 `<bucket>` 是流所属的空间名称
Authorization	string	是	`<QiniuToken>`	管理凭证 QiniuToken，生成规则

Body 参数 (application/json)

参数名称	类型	必填	描述
startTime	integer	是	开始时间
endTime	integer	是	endTime
format	string	可选	录制格式文件格式，可选文件格式为：m3u8: HLS格式，默认值 flv: FLV格式，将回放切片转封装为单个flv文件，异步模式 mp4: MP4格式，将回放切片转封装为单个mp4文件，异步模式异步模式下，生成回放文件需要一定时间
fname	string	可选	录制文件名，为空时会随机生成一个文件名
pipeline	string	可选	异步模式时，指定数据处理的队列，可以将优先级较高的任务配置到独立的队列中进行执行，参考文档：流媒体队列 https://developer.qiniu.com/dora/kb/2500/streaming-media-queue-about-seven-cows
expireDays	integer	可选	ts文件过期时间切片文件的生命周期：0: 默认值，表示不修改ts文件生命周期, 可显著提升接口响应速度大于0: 表示修改ts文件的的生命周期为 ExpireDays 参数值 -1: 表示修改 ts 文件生命周期属性为永久
firstSegmentType	integer	可选	第一个分片类型过滤ts切片文件类型，部分非标准的直播流，在推流初期缺少视频帧或音频帧，过滤功能可以剔除这部分切片，0: 默认值，不做过滤 1: 第一个ts切片需要是纯视频类型，不符合预期的ts切片将被跳过 2: 第一个ts切片需要是纯音频类型，不符合预期的ts切片将被跳过 3: 第一个ts切片需要是音视频类型，不符合预期的ts切片将被跳过
persistentDeleteAfterDays	integer	可选	生成文件的生命周期 0 表示默认情况下生成新文件的生命周期为Bucket 下 Recording 配置中的 ExpireDays值大于 0 表示新生成文件的生命周期为表示生成文件（m3u8/flv/mp4）的生命周期为 PersistentDeleteAfterDays 参数值
notify	string	可选	生成完成后的回调地址（回调地址是转码回调地址，如果format录制格式选择m3u8，不会触发回调）

请求示例

POST /<StreamName>?recordingFile HTTP/1.1
Host: <bucket>.mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>
Content-Type: application/json

{
  "startTime": 0,
  "endTime": 0,
  "format": "string",
  "fname": "string",
  "pipeline": "string",
  "expireDays": 0,
  "firstSegmentType": 0,
  "persistentDeleteAfterDays": 0
}

返回响应

响应状态码

请查阅: 这里

响应示例

{
  "endTime": 1701766699,
  "fname:": "test/3/1701766353000-1701766699000.m3u8",
  "httpUrl": "http://pjazxydt1.bkt.clouddn.com/test/3/1701766353000-1701766699000.m3u8?pm3u8/0/expire/7200&e=1701784683&token=JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:6dQO1osBbrkmtuug-kTP1ylUMH8",
  "startTime": 1701766353
}

响应参数

参数名称	类型	说明	是否必需
endTime	integer	结束时间	必需
fname	string	录制文件名	必需
httpUrl	string	http回放地址	必需
startTime	integer	开始时间	必需
persistentId	string	如果传入mp4/flv 会返回的异步任务id	可选

以上内容是否对您有帮助？