add-channel

Use the interface to add sources to preset list. Supported protocols are ntkndi, rtsp, http, rtmp, udp, srt, and rtp.

HTTP Request

GET http://ip/mwapi?method=add-channel&name=xxx&url=xxx
Parameter Description
method add-channel
name Indicates the source name which should be identical.
The source name ranges from 1 to 120 english characters.
url Indicates the source URL.

Parameters of URL vary for different protocols. For details, refer to the following description.

1. NTKNDI
ntkndi://ndi?name=test&url=192.168.1.90%3A5963&mw-buffer-duration=60
URL components Description
ntkndi Indicates the NDI protocol developed by NewTek.
ndi Indicates the default host name and it cannot be modified.
name Indicates the NDI stream name.
url Indicates the NDI URL.
mw-buffer-duration Indicates the NDI buffer duration in ms. You can get the value range using get-buffer-limit.
2. RTSP
rtsp://192.168.1.58:899?mw-buffer-duration=60
URL components Description
rtsp://192.168.1.58:899 Indicates a valid RTSP URL.
mw-buffer-duration Indicates the RTSP buffer duration in ms. You can get the value range using get-buffer-limit.
3. HTTP
http://192.168.1.88:8585?mw-buffer-duration=60
URL components Description
http://192.168.1.88:8585 Indicates a valid HTTP URL.
mw-buffer-duration Indicates the HTTP buffer duration in ms. You can get the value range using get-buffer-limit.
4. RTMP
// RTMP Pull
rtmp://url/stream-key?mw-buffer-duration=60

// RTMP Push
rtmp://127.0.0.1/live/stream-key?mw-buffer-duration=80
URL components Description
url RTMP Pull: Indicates a RTMP URL.
RTMP Push: rtmp://127.0.0.1/live/.
stream-key Indicates the stream key which follows URL. Slashes (/) or question marks (?) are not supported.
mw-buffer-duration Indicates the RTMP buffer duration in ms. You can get the value range using get-buffer-limit.
5. UDP
// Multicast
udp://ip:port?mw-buffer-duration=80

// Unicast
udp://0.0.0.0:port?mw-buffer-duration=80
URL components Description
ip Unicast IP address: 0.0.0.0
The range of multicast IP address is from 224.0.0.0 to 239.255.255.255.
port Indicates the port number which ranges from 1 to 65535.
mw-buffer-duration Indicates the UDP buffer duration in ms. You can get the value range using get-buffer-limit.
6. SRT
// Caller 
srt://ip:port?mode=caller&latency=125&passphrase=1234567890&mw-buffer-duration=80

// Listener 
srt://0.0.0.0:port?mode=listener&latency=125&mw-buffer-duration=80
URL components Description
ip Listener: 0.0.0.0
caller: a valid IP address. 0.0.0.0 is excluded.
port Indicates the port number which ranges from 1 to 65535.
mode Indicates the SRT modes including Caller and Listener.
latency Indicates the latency time ranges from 20 to 8000 in ms.
passphrase Indicates the encrypted password. It is optional unless the encryption is required.
mw-buffer-duration Indicates the SRT buffer duration in ms. You can get the value range using get-buffer-limit.
7. RTP
// Multicast
rtp://ip:port?mw-buffer-duration=80

// Unicast
rtp://0.0.0.0:port?mw-buffer-duration=80
URL components Description
ip Unicast IP address: 0.0.0.0
Multicast IP address: the IP address ranges from 224.0.0.0 to 239.255.255.255.
port Indicates the port number which ranges from 1 to 65535.
mw-buffer-duration Indicates the RTP buffer duration in ms. You can get the value range using get-buffer-limit.

Response Body

{
    "status": 0
}
Name Description
status 0 indicates that the request was accepted successfully. Refer to API Status Codes to find specific description for other values.

results matching ""

    No results matching ""

    results matching ""

      No results matching ""