add-channel-sink接口

添加输出视频流,支持类型如下:

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

接口原型

协议 HTTP/HTTPS POST
URL ip[:port]/sc_cloud/channel/add-sink
数据格式 请求消息:Content-Type: application/json
响应消息:Content-Type: application/json

请求Cookies

名称 描述
mwcloud-sid 用于标识当前登录的字符串
mwcloud-uid 当前登录用户名
Request Body
参数 描述
id 协议流ID。执行add-channel接口生成的。可以通过get-channels查询到。
protocol 协议流详细信息。
protocol
参数 描述
name 输出视频流名称。
is-enable 输出视频流是否启动。默认值:1。
type 协议流类型。取值如下:
  • 1:RTMP/RTMPS
  • 2:SRT Caller
  • 3:SRT Listener
rtmp type=1时,Request Body参见:RTMP/RTMPS示例
srt type=2时,Request Body参见:SRT Caller示例
type=3时,Request Body参见:SRT Listener示例
rtmp
参数 描述
type 常量值:1。
url 服务器地址。
key 流密钥。
is-auth 认证状态。
  • 0:无需认证。
  • 1:需要认证,用户名和密码必填。
user 用户名。
passwd 密码。
srt
参数 描述
ip IP地址或域名。type为SRT Listener时,IP为常量值:"0.0.0.0"。
port 端口号,取值范围是1~65535。
latency 延迟时间。取值范围是20ms~8000ms,默认为120ms。
bandwidth SRT开销占总带宽的比例。取值范围是5%~100%,默认值为25%。
仅SRT Caller类型有此属性。
stream-id 流ID。
仅SRT Caller类型有此属性。
取值范围是0~256个字符。必须与发送端的Stream ID一致。
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-sink HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: 190
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
{
  "id": 13,
  "protocol": {
    "name": "output-rtmp",
    "is-enable": 1,
    "type": 1,
    "rtmp": {
      "type": 1,
      "url": "rtmp://10.2.3.63/live",
      "key": "",
      "is-auth": 1,
      "user": "test",
      "passwd": "12345678",
      "name": "output-rtmp"
    }
  }
}
  • SRT Caller实例:
POST /sc_cloud/channel/add-sink HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: 225
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
{
  "id": 13,
  "protocol": {
    "name": "output-srt caller",
    "is-enable": 1,
    "type": 2,
    "srt": {
      "ip": "10.0.2.3",
      "port": 678,
      "latency": 120,
      "enc-type": 16,
      "enc-pass": "passphrase",
      "stream-id": "stream id",
      "bandwidth": 25,
      "name": "output-srt caller"
    }
  }
}
  • SRT Listener实例:
POST /sc_cloud/channel/add-sink HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: 178
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
{
  "id": 13,
  "protocol": {
    "name": "output-srt listener",
    "is-enable": 1,
    "type": 3,
    "srt": {
      "ip": "0.0.0.0",
      "port": 666,
      "latency": 120,
      "enc-type": 0,
      "enc-pass": "",
      "name": "output-srt listener"
    }
  }
}

响应参数

Response Header
参数 描述
Content-Type 取值为:'application/json; charset=UTF-8'
Response Body
参数 描述
result 返回码。
method 方法名:add-channel-sink。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 40
Connection: keep-alive
{
  "method": "add-channel-sink",
  "result": 0
}

与“”相关结果约

    找不到与“”相关的结果

    与“”相关结果约

      找不到与“”相关的结果