Versions Compared

Old Version 1

changes.mady.by.user Yulia Morozova

Saved on

compared with

New Version 2

changes.mady.by.user Alina Luchkina

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Get archive stream from default archive

GET http://IP-AddressIPaddress:port/prefix/archive/media/{VIDEOSOURCEID}/{STARTTIME}

Tip

{VIDEOSOURCEID} - − three-component source endpoint ID (see see Get list of video sources (cameras)).   For instance, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


Tip

{STARTTIME} - − time in ISO format.  Set Set the timezone to UTC+0. 


ParameterRequiredDescription
speed NoPlayback speed, values can be negative.
formatNoParameter values are 'mjpeg', 'rtsp', 'mp4', 'hls'. If the format is not specified, 'rtsp' is selected or it is not recognized, then the native format is selected by server to prevent additional encoding. If the native format is not supported by client, server selects WebM.
idNoUnique identifier of archive stream (optional). It is used to get stream info or control the stream.

w

h

No

w – frame width, h – frame height.

frNo

fps.

Note
titleImportant!

This parameter is relevant only for MJPEG video.


enable_token_auth No

Get signed links to video streams.

enable_token_auth - auth − enable authorization by token token = 1.

valid_token_hours - hours − signature validation time (in hours). The maximum value is a week. The default value is 12 hours.

valid_token_hoursNo

...

Note
titleImportant!

HLS archive video becomes available in 30 seconds after getting the response.

Sample response:

Code Block
{
    "http": {
        "description": "RTP/RTSP/HTTP/TCP",
        "path": "archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=1&hmac=wVlyHvZkB2TnqftTfYugtwmZ7g8=",
        "port": "8554"
    },
    "httpproxy": {
        "description": "RTP/RTSP/HTTP/TCP Current Http Port",
        "path": "rtspproxy/archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=2&hmac=BVICx8NVV4yijwqc0Q6Xzji41Rg="
    },
    "rtsp": {
        "description": "RTP/UDP or RTP/RTSP/TCP",
        "path": "archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=1&hmac=wVlyHvZkB2TnqftTfYugtwmZ7g8=",
        "port": "554"
    }
}

...

Assign ID to the stream to receive information about this stream.

http://IP-AddressIPaddress:port/prefix/archive/media/VIDEOSOURCEID/STARTTIME/20140723T120000.000?format=rtsp&speed=1&w=640&h=480&id=f03c6ccf-b181-4844-b09c-9a19e6920fd3

...

RTSP archive video

GET rtsp://login:password@IP-Addresspassword@IPaddress:554/archive/hosts/SERVER1/DeviceIpint.0/SourceEndpoint.video:0:0/20160907T050548.723000Z?speed=1

Speed parametr is mandatory: playback speed.

Examples:

  • speed = 1 - − forward playback, normal speed;
  • speed = -1 - − back playback, normal speed;
  • speed = 4 - − fast playback, speed 4х;
  • speed = -8 - − fast-rewind playback, speed 8x.

...

ffplay.exe -v debug "http://login:password@IP-Address:80/archive/media/SERVER1/DeviceIpint.4/SourceEndpoint.video:0:0/20170112T113526?w=1600&h=0&speed=1".

Tunneling RTSP over HTTP

...

Tip

Configure tunneling RTSP over HTTP in VLC

...


ffplay -rtsp_transport http "rtsp://login:password@IP-Addresspassword@IPaddress:8554/rtspproxy/archive/hosts/SERVER1/DeviceIpint.4/SourceEndpoint.video:0:0/20170115T113526".

For VLC: GET rtsp://login:password@IP-Addresspassword@Iaddress:8554/rtspproxy/archive/hosts/SERVER1/DeviceIpint.4/SourceEndpoint.video:0:0/20170115T113526

...