修改 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 自动推流任务数量超限

与“”相关结果约

    找不到与“”相关的结果