获取录制参数
1.接口描述
接口说明：获取录制参数信息。
请求方式：
- 固件版本 V2.6.0 及以上：POST [ip]/mwapi/V2.0/output/get-record-encoder-params
- 固件版本 V2.5.0 及以下：POST [ip]/mwapi/get-record-encoder-params
| 管理员权限 | 登录认证 |
|---|---|
| 否 | 是 |
2.输入参数
无
3.输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| recording | Int | 是否正在录制 0：否；1：是 |
| 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 | 录制计划设置历史 |
| encode-params | Array | 编码参数可用范围 |
ScheduleRecordTime
| 参数名称 | 类型 | 描述 |
|---|---|---|
| startTime | Int | 录制任务开始时间戳（仅取时分秒），毫秒 |
| duration | Int | 录制任务持续时间，毫秒 |
4.示例
获取录制参数。
输入示例
None
输出示例
{
"duration": 166666,
"video-bitrate": 2048,
"resolution": "1920x1080",
"codeType": 0,
"profile": 0,
"encodingMode": 1,
"keyframeInterval": 2,
"audioBitrate": 128,
"splitMode": 0,
"splitBlock": 2048,
"fileNamePrefix": "UF_",
"savePath": "/data/resource/album",
"fileExtention": 1,
"recordSourceId": 0,
"recordWithAudio": 1,
"scheduleMode": 3,
"scheduleStartDate": 0,
"scheduleEndDate": 0,
"weeklyDate": 254,
"scheduleRecordTime": [
{
"startTime": 33180000,
"duration": 10000
}
],
"scheduleRecordCache": [
{
"scheduleMode": 1,
"scheduleStartDate": 1690560000000,
"scheduleEndDate": 1690560000000,
"weeklyDate": 0,
"scheduleRecordTime": [
{
"startTime": 1690570800000,
"duration": 370000
}
]
},
{
"scheduleMode": 2,
"scheduleStartDate": 1690387200000,
"scheduleEndDate": 1691164800000,
"weeklyDate": 0,
"scheduleRecordTime": [
{
"startTime": 1690398360000,
"duration": 17000
}
]
},
{
"scheduleMode": 3,
"scheduleStartDate": 0,
"scheduleEndDate": 0,
"weeklyDate": 254,
"scheduleRecordTime": [
{
"startTime": 33180000,
"duration": 10000
}
]
}
],
"encode-params": "{\"resolutions\":[{\"name\":\"1080P\",\"value\":\"1920x1080\"},{\"name\":\"720P\",\"value\":\"1280x720\"}],\"durations\":[{\"name\":\"60 FPS\",\"value\":\"166666\"},{\"name\":\"30 FPS\",\"value\":\"333333\"}],\"videoBitrates\":[{\"name\":\"20 Mbps\",\"value\":\"20480\"},{\"name\":\"16 Mbps\",\"value\":\"16384\"},{\"name\":\"8 Mbps\",\"value\":\"8192\"},{\"name\":\"4 Mbps\",\"value\":\"4096\"},{\"name\":\"2 Mbps\",\"value\":\"2048\"},{\"name\":\"1 Mbps\",\"value\":\"1024\"},{\"name\":\"512 Kbps\",\"value\":\"512\"}],\"codeType\":[{\"name\":\"H.264\",\"value\":\"0\"}],\"Profile\":[{\"name\":\"Baseline\",\"value\":\"0\"},{\"name\":\"Main Profile\",\"value\":\"1\"},{\"name\":\"High Profile\",\"value\":\"2\"}],\"encodingMode\":[{\"name\":\"VBR\",\"value\":\"0\"},{\"name\":\"CBR\",\"value\":\"1\"}],\"keyframeInterval\":[{\"name\":\"1s\",\"value\":\"1\"},{\"name\":\"2s\",\"value\":\"2\"},{\"name\":\"3s\",\"value\":\"3\"},{\"name\":\"4s\",\"value\":\"4\"},{\"name\":\"5s\",\"value\":\"5\"},{\"name\":\"6s\",\"value\":\"6\"},{\"name\":\"7s\",\"value\":\"7\"},{\"name\":\"8s\",\"value\":\"8\"},{\"name\":\"9s\",\"value\":\"9\"},{\"name\":\"10s\",\"value\":\"10\"},{\"name\":\"15s\",\"value\":\"15\"},{\"name\":\"20s\",\"value\":\"20\"},{\"name\":\"25s\",\"value\":\"25\"},{\"name\":\"30s\",\"value\":\"30\"}],\"audioCode\":[{\"name\":\"48Khz,aac,48kbps\",\"value\":\"48\"},{\"name\":\"48Khz,aac,64kbps\",\"value\":\"64\"},{\"name\":\"48Khz,aac,96kbps\",\"value\":\"96\"},{\"name\":\"48Khz,aac,128kbps\",\"value\":\"128\"},{\"name\":\"48Khz,aac,192kbps\",\"value\":\"192\"},{\"name\":\"48Khz,aac,256kbps\",\"value\":\"256\"}],\"savePath\":[{\"name\":\"Internal Storage\",\"value\":\"/data/resource/album\"}],\"splitByTime\":[{\"name\":\"10 minutes\",\"value\":\"10\"},{\"name\":\"20 minutes\",\"value\":\"20\"},{\"name\":\"30 minutes\",\"value\":\"30\"},{\"name\":\"1 hour\",\"value\":\"60\"},{\"name\":\"1.5 hours\",\"value\":\"90\"},{\"name\":\"2 hours\",\"value\":\"120\"}],\"splitBySize\":[{\"name\":\"100 MB\",\"value\":\"100\"},{\"name\":\"200 MB\",\"value\":\"200\"},{\"name\":\"500 MB\",\"value\":\"500\"},{\"name\":\"1 GB\",\"value\":\"1024\"},{\"name\":\"1.5 GB\",\"value\":\"1536\"},{\"name\":\"2 GB\",\"value\":\"2048\"},{\"name\":\"2.5 GB\",\"value\":\"2560\"},{\"name\":\"3 GB\",\"value\":\"3072\"},{\"name\":\"3.5 GB\",\"value\":\"3584\"},{\"name\":\"4 GB\",\"value\":\"4096\"}],\"fileExtention\":[{\"name\":\"MP4\",\"value\":\"0\"},{\"name\":\"MOV\",\"value\":\"1\"}],\"recordSources\":[{\"name\":\"Program\",\"value\":\"0\"},{\"name\":\"HDMI 1\",\"value\":\"1\"},{\"name\":\"HDMI 2\",\"value\":\"2\"},{\"name\":\"Web Camera\",\"value\":\"3\"}]}",
"recording": 0,
"status": 0
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 定义 | 说明 |
|---|---|---|
| 49 | MW_STATUS_INVALID_DATA | 数据未初始化，系统错误 |