add-channel 接口
添加预设数据源,目前支持的协议类型有:ntkndi、rtsp、http、rtmp、udp、srt、rtp
请求方式
GET http://ip/mwapi?method=add-channel&name=xxx&url=xxx
参数 |
说明 |
method |
方法名称:add-channel |
name |
数据源名称,唯一值,不能重复 字符要求:1-120 个英文字符 |
url |
数据源 URL |
不同协议的URL组成参数不同,目前支持的协议有:
1. NTKNDI
ntkndi://ndi?name=test&url=192.168.1.90%3A5963&mw-buffer-duration=60
URL 组成 |
说明 |
ntkndi |
NID 数据源协议 |
ndi |
默认主机名,不可修改 |
name |
NDI 流名称 |
url |
NDI 流 URL |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
2. RTSP
rtsp://192.168.1.58:899?mw-buffer-duration=60
URL 组成 |
说明 |
rtsp://192.168.1.58:899 |
合法 URL |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
3. HTTP
http://192.168.1.88:8585?mw-buffer-duration=60
URL 组成 |
说明 |
http://192.168.1.88:8585 |
合法 URL |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
4. RTMP
// RTMP 拉流
rtmp://url/stream-key?mw-buffer-duration=60
// RTMP 推流
rtmp://127.0.0.1/live/stream-key?mw-buffer-duration=80
URL 组成 |
说明 |
url |
RTMP 拉流:合法的 RTMP URL RTMP 推流:rtmp://127.0.0.1/live/. |
stream-key |
密钥,必须是 URL 最后一个路径,不支持斜杠(/) |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
5. MPEG-TS over UDP
// 组播
udp://ip:port?mw-audio-track=2&mw-buffer-duration=80
// 单播
udp://0.0.0.0:port?mw-audio-track=2mw-buffer-duration=80
URL 组成 |
说明 |
ip |
单播:0.0.0.0 组播:有效 IP 范围 224.0.0.0 ~ 239.255.255.255 |
port |
端口号,有效范围:1 ~ 65535 |
mw-audio-track |
音轨,有效范围:1 ~ 8 |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
6. MPEG-TS over SRT
// Caller 模式
srt://ip:port?mode=caller&latency=125&streamid=test&passphrase=1234567890&mw-audio-track=2&mw-buffer-duration=80
// Listener 模式
srt://0.0.0.0:port?mode=listener&latency=125&streamid=test&mw-audio-track=2&mw-buffer-duration=80
URL 组成 |
说明 |
ip |
Listener:0.0.0.0 caller:合法 IP 地址(不能为:0.0.0.0) |
port |
端口号,有效范围:1 ~ 65535 |
mode |
模式,有效值:caller/listener |
latency |
延迟时间,有效范围:20 ~ 8000 |
passphrase |
加密密码,选填,需要加密时才设置 |
streamid |
流 ID,字符长度:0 ~ 512 |
mw-audio-track |
音轨,有效范围:1 ~ 8 |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
7. MPEG-TS over RTP
// 组播
rtp://ip:port?mw-ts-progid=2&mw-audio-track=2&mw-buffer-duration=80
// 单播
rtp://0.0.0.0:port?mw-ts-progid=2&mw-audio-track=2&mw-buffer-duration=80
URL 组成 |
说明 |
ip |
单播:0.0.0.0 组播:有效 IP 范围 224.0.0.0 ~ 239.255.255.255 |
port |
端口号,有效范围:1 ~ 65535 |
mw-ts-progid |
TS ProgID,有效范围:1 ~ 10000000 |
mw-audio-track |
音轨,有效范围:1 ~ 8 |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
8. TVU ISSP
issp://192.168.1.88?mw-buffer-duration=60
URL 组成 |
说明 |
issp://192.168.1.88 |
合法 URL |
mw-buffer-duration |
缓冲时间(ms),有效值可通过 get-buffer-limit 接口获取 |
返回数据
{
"status": 0
}
字段 |
说明 |
status |
返回状态。0:数据添加成功,返回其它值请参考 API 状态码。 |