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 状态码 |