Versions Compared

Old Version 5

changes.mady.by.user Yulia Morozova

Saved on

compared with

New Version 6

changes.mady.by.user Alena Kniazeva

Saved on

Key

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

...

Section


Column
width35%


Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleOn page:
Table of Contents



Column


Export start

Export is initiated using one of the following POST requests:
POST http://IP-address:port/prefix/export/archive/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME} − archive export.
POST http://IP-address:port/prefix/export/live/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME} − live video export.

Tip

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

...

Info
titleNote

BEGINTIME and ENDTIME set time in the YYYYMMDDTHHMMSS format in the UTC+0 time zone. If BEGINTIME If BEGINTIME is greater than ENDTIME, then the values will swap. BEGINTIME must should be equal to ENDTIME for snapshot frame export.  

The ENDTIME and BEGINTIME syntax is described in Get archive contents section.


ParameterRequiredDescription
waittimeoutNo

Wait timeout in milliseconds required for a frame to arrive. The default value is 10. If the parameter value is less than the reference frames interval, then the export will not be performed.

It is recommended to set the value not less than 30.

archiveNoName of the archive in the hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage format (see Get archive contents). If the value is not specified, the default archive will be used for export

Sample request:

POST http://127.0.0.1:80/export/archive/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20200415T085456.908/20200415T085501.908?waittimeout=30

Request body example:

Code Block
{
    "format": "mp4",
    "vc": 4,
    "comment": "сomment"
}

The supported Supported parameters that are sent in the body of the initial POST request:

ParameterFormatDescriptionExample
formatString

Mandatory parameter. Available values are mp4, mkv, avi, exe, jpg and pdf. It sets the format of output export container. 


maxfilesize

Number

Maximum export file size ( in bytes). A new file will be created when the size limit is exceeded. Export results in the collection of files. Default value is 0 (as a result, a single file).

"maxfilesize": 1e+6
"maxfilesize": 1000000
vc, acNumber

A compression quality level for video and audio respectively. Allowed values are from 0 to 6 (6 means the worst). Default value is 0.


freq Number

Frame rate of the output stream. Default value is 0. Available values:

  1. 0 – original
  2. 1 – half of original
  3. 2 − quarter of original
  4. 3 – one-eighth of original

tsformatString

A time stamp format template. Any string can be generated on the basis of http://www.boost.org/doc/libs/1_55_0/doc/html/date_time/date_time_io.html. Default value is %Y-%b-%d %H:%M:%S.

Attention! The The Server does not check the format of the input string.

"tsformat": "%B %Y",
cropareaArea

A snapshot frame area for export (default value is is [[0, 0], [1,1]] – the entire snapshotframe).

Image example:


Code Block
"croparea": [
        [
            0.3,
            0.3
        ],
        [
            0.8,
            0.8
        ]
    ]


maskspaceArea

A snapshot frame area for masking, set in coordinates. By default a snapshot frame is not masked.

The area is specified by at least 3 nodal anchor points + 1 terminal 1 terminal point (coincides with one of the nodal anchor points). The reference The reference point is the upper left corner. You can specify multiple polygons.

Image example:


Code Block
"maskspace": [
    [
        [
            0.2,
            0.2
        ],
        [
            0.3,
            0.7
        ],
        [
            0.5,
            0.5
        ],
        [
            0.2,
            0.2
        ]
    ]
]


colorString

Text color of a comment and a time stamp. It is set in the #FFFFFF web format.

"color": "#e31e1e",
comment StringA comment.
Parameters relevant to for PDF export format only:
snapshotplaceAreaSnapshot Frame location on the page.
commentplaceAreaComment location on the page.
tsplaceAreaTime stamp location on the page.
layoutNumber

Page layout. Available values are 0 (portrait), 1  (landscape).


Sample JSONresponse:

Code Block
{
    "format": "mp4",
    "vc": 4,
    "comment": "сomment"
}

Sample response:

Code Block
HTTP/1.1 202 Accepted
Connection: Close
Location: /export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3
Cache-Control: no-cache

Possible error codes:

Error codeDescription
400Incorrect request.
500Server internal error.

Get export status

GET http://IP-address:port/export/{id}/status

...

ParameterDescription
state

Current state of export. Available values:
0 – – export is not yet in perform;
1 – – export is performed;
2 – – export is completed;
3 – – export error;
4 – – not enough space to complete the operation;
5 – – the file with the given name already exists;
6 – – no data to export.

progressProgress of export session in the range from 0 to 1.
errorDescription of error (if any).
filesList of the files created as the result of the export result.

Download file

GET http://IP- address:port/prefix/export/{id}/file

...

ParameterRequiredDescription
nameYes

Name of the file from the files field.

Sample request:

GET http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/file?name=Server1_DeviceIpint.10[20190903T050000-20190903T050100].mp4

Info
titleNote

On the Server , the exported file is saved to the folder C:\ProgramData\AxxonSoft\AxxonOne\Export\{ID}

...