修改 RTMP 推流服务器配置
1.接口描述
接口说明:修改 RTMP 推流服务器配置。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/stream/update-rtmp
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/update-rtmp
管理员权限 | 登录认证 |
---|---|
否 | 是 |
2.输入参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
id | 是 | Int | 推流服务器ID,可通过获取直播推流服务器列表获得 |
type | 是 | Int | 推流类型 1:RTMP |
name | 是 | String | 推流服务器名称 |
url | 是 | String | 推流地址 |
streamKey | 是 | String | 推流秘钥 |
authentication | 是 | 是否需要鉴权 true:是;false:否 |
|
userName | 否 | String | 用户名,仅在需要鉴权时生效 |
password | 否 | String | 密码,仅在需要鉴权时生效 |
autoSwitch | 是 | Int | 是否配置为自动推流,可通过按键启动其开始直播推流 true:是;false:否 |
encoder | 是 | EncoderData | 编码配置参数 |
effective | 是 | Int | 是否为完整的直播配置 true:是;false:否 |
EncoderData
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
codeType | 是 | Int | 编码类型 0:H.264 |
encodingMode | 是 | Int | 码率模式 0:VBR;1:CBR |
videoBitrate | 是 | Int | 视频编码位率,单位 Kbps |
profile | 是 | Int | 编码档次 0:Baseline;1:Main Profile;2:High Profile |
audioBitrate | 是 | Int | 音频编码参数 48:48Khz,aac,48bps 64:48Khz,aac,64bps 96:48Khz,aac,96bps 128:48Khz,aac,128bps 192:48Khz,aac,192bps 256:48Khz,aac,256bps |
keyframeInterval | 是 | Int | 关键帧间隔,单位:秒 |
duration | 是 | Int | 视频帧率 166666:60 FPS;333333:30 FPS |
resolution | 是 | Int | 视频分辨率 1920x1080:1080p; 1280x720:720p |
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Int | 状态码 |
message | String | 状态描述 |
4.示例
修改ID为1000的推流服务器的配置。
输入示例
{
"id":1000,
"type":1,
"name":"rtmp",
"url":"10.10.7.10/live/",
"streamKey":"yxy",
"authentication":false,
"userName":"userName",
"password":"password",
"autoSwitch":false,
"encoder":{
"codeType":0,
"encodingMode":1,
"videoBitrate":2048,
"keyframeInterval":2,
"duration":166666,
"resolution":"1920x1080",
"audioBitrate":128,
"profile":0
}
}
输出示例
{
"message": "success",
"status": 0
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 定义 | 说明 |
---|---|---|
7 | MW_STATUS_INVALID_ARG | 参数缺失 |
16 | MW_STATUS_NOT_EXIST | 操作内容不存在 |
1001 | MW_STATUS_SAME_NAME | 已存在同名配置 |
1002 | MW_STATUS_AUTO_LIMIT | 自动推流任务数量超限 |