...

A REST-query should be HTTP/HTTPS POST request as follows:

• HTTP: http://test.flashphoner.com:90918081/rest-api/rtsp/startup
• HTTPS: https://test.flashphoner.com:88888444/rest-api/rtsp/startup

Where:

• test.flashphoner.com - is the address of the WCS server
• 9091 8081 - is the standard REST / HTTP port of the WCS server
• 8888 8444 - is the standard HTTPS port
• rest-api - is the required part of the URL
• /rtsp/startup - REST-method to use

...

    stream = session.createStream(options).on(STREAM_STATUS.PENDING, function(stream) {
        ...
    }).on(STREAM_STATUS.PLAYING, function(stream) {
        ...
    }).on(STREAM_STATUS.STOPPED, function() {
        setStatus(STREAM_STATUS.STOPPED);
        onStopped();
    }).on(STREAM_STATUS.FAILED, function(stream) {
        ...
    }).on(STREAM_STATUS.NOT_ENOUGH_BANDWIDTH, function(stream){
        ...
    });
    stream.play();

Known issues

1. A stream containing B-frames does not play or plays with artifacts (latencies, lags)

Symptoms:

...

RTSP connection reuse

If other subscrubers request the stream captured from RTSP IP camera, the previous RTSP connection will be used if all subscribers set the same camera URL. For example, two requests to the same IP camera

rtsp://host:554/live.sdp

and

rtsp://host:554/live.sdp?p=1

are differ, then two RTSP connections will be created if streams from both URLs are requested.

Stream capture authentication

WCS supports RTSP stream capture authentication by user name and password, user data should be set in stream URL, for example

rtsp://user:password@hostname/stream

If name or password contains any special characters, they should be escaped such as

09rtsp:32:31,238 WARN 4BitstreamNormalizer - RTMP-pool-10-thread-5 It is B-frame!

Solution: request lower resolution video from the camera to avoid using B-frames or transcode that stream.

...

//user:p%40ssword@hostname/stream

Where

• user is user name
• p@ssword is password with character '@', it is escaped in URL.

Known issues

5. Connection to the IP camera is lost on error in any track (audio or video)

...

rtsp_fail_on_error_track=false
rtp_force_synchronization=true

3. AAC frames of type 0 are not supported by decoder and will be ignored while stream pulled playback

In this case, warnings will be displayed in the client log:6. All the characters in a stream name, that are not allowed in URI, should be escaped

Symptoms: RTSP stream is not played with 'Bad URI' error
Solution: any character that is not allowed in URI, should be escaped in stream URL, for example

10:13:06,815 WARN AAC - AudioProcessor-c6c22de8-a129-43b2-bf67-1f433a814ba9 Dropping AAC frame that starts with 0, 119056e500

...

rtsp://hostname/c@@lstream/channel1

should be set as

rtsp://hostname/c%40%40lstream/channel1

7. Some IP cameras do not support cnonce field in RTSP connection message header.

Symptoms: RTSP stream is played with VLC, but is not played with WCS.

Solution: set the following parameter in flashphoner.properties file

rtsp_auth_cnonce=

with empty value.