文档中心
云端录制
基础功能
视频截图

视频截图

更新时间：2025-01-13 16:24

功能描述

云端录制支持以固定频率在单流录制模式（混流录制模式不支持）下对视频流进行截图，截图文件为 JPG 格式。

本文介绍如何通过使用云端录制 API 进行视频截图。

在单流录制下仅进行截图操作，也将会按照单流录制收费。

实现方法

在调用 StartRecord 方法时，将 OutputFileFormat 设置为 “jpg” 即可进行视频截图。可以通过设置 SnapshotInterval 参数控制截图的周期，默认为每 10 秒对房间内的所有流截一次图。

仅支持 RecordMode 设置为 1 时，即单流录制模式下输出视频截图文件。
StreamType 设置为 1（仅录制音频）时不支持输出截图文件，需要有视频流才能截图。
通过查询录制状态接口查询视频截图任务状态时，返回参数不会包含文件列表。

录制过程中产生截图文件后会上传至第三方云存储，每次完成截图时会回调通知文件信息，每个回调通知对应一个截图文件。

请求示例

以下是一个启动视频截图的示例。

Content-type 为 application/json;charset=utf-8，StartRecord 请求包体内容如下：

{
    "RoomId": "xxxx",
    "RecordInputParams": {
        "RecordMode": 1,
        "StreamType": 3,
        "MaxIdleTime": 60
    },
    "RecordOutputParams": {
        "OutputFileFormat": "jpg",
        "OutputFolder": "record/",
        "SnapshotInterval": 10
    },
    "StorageParams": {
        "Vendor": 2,
        "Region": "oss-xxxx",
        "Bucket": "xxxx",
        "AccessKeyId": "xxxx",
        "AccessKeySecret": "xxxx"
    }
}