add-channel接口
添加输入协议视频流,支持类型如下:
仅管理员有权限。
接口原型
协议 |
HTTP/HTTPS POST |
URL |
ip[:port]/sc_cloud/channel/add |
数据格式 |
请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
请求Cookies
名称 |
描述 |
mwcloud-sid |
用于标识当前登录的字符串 |
mwcloud-uid |
当前登录用户名 |
Request Body
参数 |
描述 |
name |
协议流名称。字符限制如下:- 1~32个字符。
- 仅支持大小写字母、数字、特殊符号._-+'[]()和空格。
- 不能以空格开头或结束。
|
protocol |
协议流详细信息。 |
protocol
参数 |
描述 |
name |
输入视频流名称。暂不支持修改。默认值:def-channel-src-name。 |
is-enable |
输入视频流是否启动。默认值:1。 |
type |
协议流类型。取值如下:- 1:RTMP/RTMPS
- 3:SRT Listener
|
rtmp |
type=1时,Request Body参见:RTMP/RTMPS示例。 |
srt |
type=3时,Request Body参见:SRT Listener示例。 |
rtmp
参数 |
描述 |
type |
常量值:1。 |
url |
服务器地址。 |
key |
流密钥。 |
is-auth |
认证状态。 |
user |
用户名。 |
passwd |
密码。 |
srt
参数 |
描述 |
ip |
常量值:"0.0.0.0"。 |
port |
端口号,取值范围是1~65535。 |
latency |
延迟时间。取值范围是20ms~8000ms,默认为120ms。 |
enc-type |
加密类型,默认不加密。取值对应关系如下:- 0:不使用加密
- 16:AES-128
- 24:AES-192
- 32:AES-256
|
enc-pass |
加密密码。enc-type取值不为0时,需要输入10~79位字符的密码。 |
请求示例
POST /sc_cloud/channel/add HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: 179
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
{
"name": "rtmp push",
"protocol": {
"name": "def-channel-src-name",
"is-enable": 1,
"type": 1,
"rtmp": {
"type": 1,
"url": "rtmp://127.0.0.1/live",
"key": "test",
"is-auth": 0,
"user": "",
"passwd": ""
}
}
}
POST /sc_cloud/channel/add HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: 179
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
{
"name": "srt listener",
"protocol": {
"name": "def-channel-src-name",
"is-enable": 1,
"type": 3,
"srt": {
"ip": "0.0.0.0",
"port": 3522,
"latency": 120,
"enc-type": 16,
"enc-pass": "ddddddddddddd"
}
}
}
响应参数
参数 |
描述 |
Content-Type |
取值为:'application/json; charset=UTF-8' |
Response Body
参数 |
描述 |
result |
返回码。 |
id |
协议流ID。 |
method |
方法名:add-channel。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 43
Connection: keep-alive
{
"id": 13,
"method": "add-channel",
"result": 0
}