Versions Compared

Old Version 5

changes.mady.by.user Alina Luchkina

Saved on

compared with

New Version 6

changes.mady.by.user Alina Luchkina

Saved on

Key

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

...

Note
titleImportant!

You can get audio from x64 Server only.

You can't get audio in MJPEG format.

General information

GET httpGET http://IP- Address:port/prefix/live/media/{VIDEOSOURCEID}

Tip

{VIDEOSOURCEID} — – a three-component source endpoint ID (see Get list of video cameras and information about them). For instance, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

...

ParameterRequiredDescription
formatNo

Parameter values are "mp4", "hls".

Video can be received in the original format (without recompression) via HLS protocols. HLS protocol supports only H.264 format.

The "mp4" player allows to receive the original video in H.264 and H.265. In all other cases the server recompresses re-compresses it to MJPEG format. 

Note
titleImportant!

If video is requested in the format that differs from the original one, then recompression will be performed, therefore, Server load will increase.


w, hNo

w – frame width, h – frame height.

Info
titleNote

If h and w values are more than size of original video, the video will be received with original size.

Zooming out of width and height is available only discretely - – in 2, 4, 8 times, etc. If specified sizes are not corresponding to 1/2, 1/4 etc. of original video size, the video will be received with size divisible by the original video size close to specified values.


Note
titleImportant!

The mp4 video is transferred without scaling.


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 — – enable authorization by token = 1.

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

valid_token_hoursNo

key_frames

No

1 — – playback only by key frames;

0 — – original frame rate (default).


Sample request:

GET http://IP -Address:port/prefix/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480&enable_token_auth=1&valid_token_hours=1

...

Request to get the structure of the RTSP link: http://login:password@IP-address:Port/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?format=rtsp

Sample response:

Code Block
{
    "http": {
        "description": "RTP/RTSP/HTTP/TCP",
        "path": "hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0",
        "port": "8554"
    },
    "rtsp": {
        "description": "RTP/UDP or RTP/RTSP/TCP",
        "path": "hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0",
        "port": "554"
    }
}

Request to get video: GET rtsp://login:password@IP -addressAddress:554/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0

Note
titleImportant!

In some cases, the RTSP video can be streamed with artifacts. To fix this, change the TCP/IP settings using this reg file.

RTSP stream information:

GET GET http://IP -Address:port/prefix/rtsp/stat

...

ffplay.exe -v debug "http://login:password@IP-address Address:8001/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=1600&h=0"

...

ffplay -rtsp_transport http "rtsp://login:password@IP - Address:80/rtspproxy/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0"

GET for VLC: rtsp://login:password@IP - Address:80/rtspproxy/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0

...