set-server 接口
修改直播服务器。
请求方式
GET http://ip/usapi?method=set-server&id=xxx&type=xxx&url=xxx&key=xxx&...
| 参数 | 说明 | 
|---|---|
| method | 方法名称:set-server | 
| id | 服务器 ID,通过 get-settings 获取 | 
| type | 服务器类型 0: RTMP 1: Twitch 2: YouTube 3: Facebook 100: RTSP 120: SRT Caller 121: SRT Listener 130: NDI HX 131: HLS 132: TS over UDP 133: TS over RTP  | 
| name | 服务器名称,字符要求: 1、1 - 32 个字符 2、由 A-Z, a-z, 0-9, 空格 ._-+'[]() 组成,并且不能以空格开头或结束  | 
| RTMP直播参数 | |
| stream-index | 编码码流 0: 主码流 1: 次码流  | 
| url | 服务器地址 | 
| key | 流秘钥 | 
| is-auth | 认证状态 0: 无需认证 1: 需要认证,用户名和密码必填  | 
| user | 用户名 | 
| passwd | 密码 | 
| token | Token | 
| event-data | 直播事件 | 
| net-mode | 网络优先 0: 移动宽带优先 1: 有线网络优先 2: 无线网络优先  | 
| RTSP直播参数 | |
| port | 端口号,默认为554 | 
| max-connection | 客户端最大连接数 | 
| is-auth | 认证状态 0: 无需认证 1: 需要认证,用户名和密码必填  | 
| user | 用户名 | 
| passwd | 密码 | 
| is-main | 是否启用主码流 0: 不启用 1: 启用  | 
| main-stream-name | 主码流名称,字符要求: 1、1 - 32 个字符 2、由 A-Z, a-z, 0-9, 空格 ._-+'[]() 组成,并且不能以空格开头或结束  | 
| is-sub | 是否启用次码流 0: 不启用 1: 启用  | 
| sub-stream-name | 次码流名称,字符要求: 1、1 - 32 个字符 2、由 A-Z, a-z, 0-9, 空格 ._-+'[]() 组成,并且不能以空格开头或结束  | 
| is-audio | 是否启用音频 0: 不启用 1: 启用  | 
| SRT Caller直播参数 | |
| stream-index | 编码码流 0: 主码流 1: 次码流  | 
| url | 服务器地址 | 
| port | 端口号 | 
| latency | 延迟时间,通过get-info 可以获取相关参数的取值范围 | 
| bandwidth | 带宽限制,通过get-info 可以获取相关参数的取值范围 | 
| aes | 加密方式 0: 不加密 16: AES-128加密 24: AES-192加密 32: AES-256加密  | 
| ase-word | 加密字段 | 
| stream-id | 选填 | 
| mtu | 最大传输单元,有效值:232 ~ 1500 | 
| conn-timeout | 连接超时时间,单位毫秒 | 
| retry-duration | 等待重新连接时间,单位毫秒 | 
| net-mode | 网络优先 0: 移动宽带优先 1: 有线网络优先 2: 无线网络优先  | 
| SRT Listener直播参数 | |
| stream-index | 编码码流 0: 主码流 1: 次码流  | 
| port | 端口号,默认为8000 | 
| max-connection | 客户端最大连接数 | 
| latency | 延迟时间,通过get-info 可以获取相关参数的取值范围 | 
| bandwidth | 带宽限制,通过get-info 可以获取相关参数的取值范围 | 
| aes | 加密方式 0: 不加密 16: AES-128加密 24: AES-192加密 32: AES-256加密  | 
| ase-word | 加密字段 | 
| mtu | 最大传输单元,有效值:232 ~ 1500 | 
| NDI HX直播参数 | |
| source-name | 视频源名称,默认为设备序列号 | 
| group-name | 组名,默认为public | 
| enable-discovery | 是否启用发现服务 | 
| discovery-server | 发现服务器 IP 地址 | 
| transport-mode | 传输模式,通过get-info 可以获取相关参数的取值范围;选择组播传输模式,组播相关设置必填 | 
| mcast-addr | 组播地址 | 
| mcast-mask | 组播掩码 | 
| mcast-ttl | 生存时间,有效值:1 ~ 255 | 
| enable-fail-over | 是否启用备用通道 | 
| fail-over-ndi-name | 备用通道视频源名称 | 
| fail-over-ip-addr | 备用通道 IP 地址 | 
| enable-web-control | 是否显示 Web 控制 | 
| HLS直播参数 | |
| is-main | 是否启用主码流 0: 不启用 1: 启用  | 
| main-stream-name | 主码流名称,字符要求: 1、1 - 32 个字符 2、由 A-Z, a-z, 0-9, 空格 ._-+'[]() 组成,并且不能以空格开头或结束  | 
| is-sub | 是否启用次码流 0: 不启用 1: 启用  | 
| sub-stream-name | 次码流名称,字符要求: 1、1 - 32 个字符 2、由 A-Z, a-z, 0-9, 空格 ._-+'[]() 组成,并且不能以空格开头或结束  | 
| TS over UDP / TS over RTP直播参数 | |
| stream-index | 编码码流 0: 主码流 1: 次码流  | 
| url | 服务器地址 | 
| port | 端口号 | 
| net-mode | 网络优先 0: 移动宽带优先 1: 有线网络优先 2: 无线网络优先  | 
返回数据
{
  "result": 0
}
| 属性 | 说明 | 
|---|---|
| result | 返回状态,0:新增成功,返回其它值请参考 API 状态码 |