add-channel接口

添加输入协议视频流,支持类型如下:

  • RTMP/RTMPS
  • SRT Listener
仅管理员有权限。

接口原型

协议 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 认证状态。
  • 0:无需认证。
  • 1:需要认证,用户名和密码必填。
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位字符的密码。

请求示例

  • RTMP/RTMPS实例:
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": ""
    }
  }
}
  • SRT Listener实例:
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"
    }
  }
}

响应参数

Response Header
参数 描述
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
}

与“”相关结果约

    找不到与“”相关的结果

    与“”相关结果约

      找不到与“”相关的结果