Miku 快直播

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

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

    最近更新时间: 2026-01-26 10:16:20

    描述

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

    接口信息

    • 请求方法: 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 可选 生成完成后的回调地址

    请求示例

    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 可选
    以上内容是否对您有帮助？