设置录制参数

1.接口描述

接口说明：设置录制参数信息。

请求方式：

  • 固件版本 V2.6.0 及以上：POST [ip]/mwapi/V2.0/output/set-record-encoder-format
  • 固件版本 V2.5.0 及以下：POST [ip]/mwapi/set-record-encoder-format
管理员权限 登录认证
否 是

2.输入参数

参数名称 必选 类型 描述
duration 是 Int 帧间隔
video-bitrate 是 Int 视频编码位率，单位 KB
resolution 是 String 分辨率，宽X高
codeType 是 Int 编码方式
0：H.264；1：H.265
profile 是 Int 编码档次
0：Baseline；1：Main Profile；2：High Profile
encodingMode 是 Int 码率模式
0：VBR；1：CBR
keyframeInterval 是 Int 关键帧间隔，单位 s
audioBitrate 是 Int 音频编码位率，单位 KB
splitMode 是 Int 文件分割方式
0：按大小；1：按时间
splitBlock 是 Int 分割间隔
按大小：MB
按时间: 分钟
fileNamePrefix 是 String 文件名前缀
savePath 是 String 存储路径
fileExtention 是 Int 文件扩展名
0：MP4；1：MOV
recordSourceId 是 Int 录制源
0：Program；1： HDMI 1；2：HDMI 2；3：Web Camera
recordWithAudio 是 Int 是否录制音频
0：否；1：是
scheduleMode 是 Int 自动录制任务类型
0：无；1：单日；2：每天；3：每周
scheduleStartDate 是 Int 录制任务开始时间戳，毫秒
scheduleEndDate 是 Int 录制任务结束时间戳，毫秒
weeklyDate 是 Int 每周重复时间， 二进制标记
0:不启用
周日：第1位（0x1LL << 1）
周一：第2位（0x1LL << 2）
周二：第3位（0x1LL << 3）
周三：第3位(0x1LL << 4)
周四：第5位(0x1LL << 5)
周五：第6位(0x1LL << 6)
周六：第7位(0x1LL << 7)
scheduleRecordTime 是 ScheduleRecordTime 录制计划配置
scheduleRecordCache 是 Array 录制计划设置历史
ScheduleRecordTime
参数名称 必选 类型 描述
startTime 是 Int 录制任务开始时间戳（仅取时分秒），毫秒
duration 是 Int 录制任务持续时间，毫秒

3.输出参数

参数名称 类型 描述
status Int 状态码
message String 状态描述

4.示例

设置录制参数信息。

输入示例
{
    "recordSourceId": 2,
    "recordWithAudio": 1,
    "resolution": "1920x1080",
    "duration": 166666,
    "video-bitrate": 8192,
    "codeType": 0,
    "keyframeInterval": 2,
    "profile": 0,
    "encodingMode": 1,
    "audioBitrate": 128,
    "fileNamePrefix": "UF_",
    "fileExtention": 0,
    "savePath": "/data/resource/album",
    "splitMode": 1,
    "splitBlock": 60,
    "scheduleMode": 1,
    "scheduleStartDate": 1716480000000,
    "scheduleEndDate": 1716480000000,
    "scheduleRecordTime": [
        {
            "startTime": 1716522176000,
            "duration": 102000
        }
    ],
    "scheduleRecordCache": [
        {
            "scheduleMode": 1,
            "scheduleStartDate": 1716480000000,
            "scheduleEndDate": 1716480000000,
            "weeklyDate": 0,
            "scheduleRecordTime": [
                {
                    "startTime": 1716522176000,
                    "duration": 102000
                }
            ]
        }
    ],
    "weeklyDate": 0
}
输出示例
{
    "message": "success",
    "status": 0
}

5.错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码 定义 说明
40 MW_STATUS_VERIFY_FAILED 录制计划验证失败，与设备重启计划冲突
49 MW_STATUS_INVALID_DATA 参数缺失或错误

与“”相关结果约 个

    找不到与“”相关的结果