Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is [available too].

Previous page 알람 목록 가져오기  매크로 Next page

On page:

내보내기 시작

POST http://IP Address:port/prefix/export/archive/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME} – 아카이브 내보내
POST http://IP Address:port/prefix/export/live/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME} – 실시간 비디오 내보내기

{VIDEOSOURCEID} – 세 구성 요소 소스 엔드포인트 ID (비디오 카메라 목록 및 정보 가져오기 참조). 예: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

Note

BEGINTIME과 ENDTIME은 UTC+0 시간대에서 YYYYMMDDTHHMMSS 형식으로 시간을 설정합니다. 만약 BEGINTIME이 ENDTIME보다 크면, 값이 자동으로 교환됩니다. 프레임 내보내기의 경우 BEGINTIME과 ENDTIME은 동일해야 합니다.

ENDTIME과 BEGINTIME 구문은 아카이브 내용 가져오기 섹션에 설명되어 있습니다.

파라미터필수설명
waittimeoutNo

프레임이 도착할 때까지 대기하는 시간(밀리초 단위)입니다. 기본값은 10000입니다. 만약 이 값이 기준 프레임 간격보다 짧으면, 내보내기가 수행되지 않습니다.

값은 최소 30000 이상으로 설정하는 것이 권장됩니다.

archiveNo내보내기할 아카이브의 이름은 hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage 형식이어야 합니다 (Get archive contents 참조). 만약 값이 지정되지 않으면, 기본 아카이브가 내보내기 작업에 사용됩니다.

샘플 요청:

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

요청 본문 예시:

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

초기 POST 요청 본문에 전달되는 지원되는 매개변수는 다음과 같습니다.

파라미터포맷설명예시
formatString

필수 매개변수입니다. 사용 가능한 값은 mp4, mkv, avi, exe, jpg, pdf입니다. 출력 내보내기 컨테이너의 형식을 설정합니다.


maxfilesize

Number

바이트 단위로 최대 내보내기 파일 크기입니다. 크기 제한을 초과하면 새 파일이 생성됩니다. 내보내기 결과는 여러 파일로 수집됩니다. 기본값은 0이며 이 경우 하나의 파일로 내보내집니다.

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

비디오와 오디오에 대한 압축 품질 수준입니다. 허용되는 값은 0에서 6까지이며 (6은 가장 낮은 품질을 의미함), 기본값은 0입니다.


freq Number

출력 스트림의 프레임 속도입니다. 기본값은 0입니다. 사용 가능한 값은 다음과 같습니다.

  1. 0 – 원본
  2. 1 – 원본의 절반
  3. 2 – 원본의 4분의 1
  4. 3 – 원본의 8분의 1

tsformatString

타임스탬프 형식 템플릿입니다.  http://www.boost.org/doc/libs/1_55_0/doc/html/date_time/date_time_io.html 을 기준으로 어떤 문자열이든 생성할 수 있습니다. 기본값은 %Y-%b-%d %H:%M:%S 입니다.

주의! 서버는 입력 문자열의 형식을 검증하지 않습니다.

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

내보내기 위한 프레임 영역 (기본값은 [[0, 0], [1,1]] – 전체 프레임)

이미지 예시:

"croparea": [
        [
            0.3,
            0.3
        ],
        [
            0.8,
            0.8
        ]
    ]
maskspaceArea

마스킹을 위한 프레임 영역은 좌표로 설정됩니다. 기본적으로 프레임은 마스킹되지 않습니다.

영역은 최소 3개의 앵커 포인트와 1개의 터미널 포인트 (하나의 앵커 포인트와 일치)가 필요합니다. 기준 점은 왼쪽 상단 모서리입니다. 여러 개의 다각형을 지정할 수 있습니다.

이미지 예시:

"maskspace": [
    [
        [
            0.2,
            0.2
        ],
        [
            0.3,
            0.7
        ],
        [
            0.5,
            0.5
        ],
        [
            0.2,
            0.2
        ]
    ]
]
colorString

주석과 타임스탬프의 텍스트 색상입니다. #FFFFFF 웹 형식으로 설정됩니다.

"color": "#e31e1e",
comment String코멘트
PDF 내보내기와 관련된 매개변수만 해당:
snapshotplaceArea페이지에서의 프레임 위치
commentplaceArea페이지에서의 코멘 위치
tsplaceArea페이지에서의 타임스탬프 위치
layoutNumber

이지 레이아웃. 사용 가능한 값은 0 (세로) 및 1 (가로)입니다.


샘플 응답:

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

가능한 오류 코드:

오류 코드설명
400

잘못된 요청

500서버 내부 오류

내보내기 상태 가져오기

GET http://IP Address:port/export/{id}/status

 id is the value from the Location field (here 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3)

샘플 요청:

GET http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/status

샘플 응:

{
  "id": "38e3e286-c07c-490f-a452-e4b541b958c4",
  "state": 2,
  "progress": 1.000000000e+00,
  "error": "",
  "files": [
    "Server1_DeviceIpint.10[20190903T050000-20190903T050100].mp4"
  ],
  "filesFriendly": [
    "Server1_10.RHCP[20190903T050000-20190903T050100].mp4"
  ]
}
파라미터설명
state

내보내기 현재 상태. 사용 가능한 값은 다음과 같습니다.
0 – 내보내기가 아직 수행되지 않음
1 – 내보내기가 수행됨
2 – 내보내기 완료
3 – 내보내기 오류
4 – 작업 완료할 공간 부족
5 – 주어진 이름의 파일이 이미 존재함
6 – 내보낼 데이터가 없음

progress내보내기 세션의 진행 상황은 0에서 1 사이의 범위로 표시됩니다.
error오류 설명 (있을 경우)
files내보내기 결과로 생성된 파일 목록

파일 다운로드

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

id는 Location 필드의 값입니다 (여기서 예시는 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3).

파라미터필수설명
nameYes

files 필드에서 파일 이름입니다.

샘플 요청:

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

Note

서버에서 내보낸 파일은 C:\ProgramData\AxxonSoft\AxxonOne\Export\{ID} 폴더에 저장됩니다.

내보내기 완료

이 요청은 서버에서 생성된 파일을 삭제합니다.

DELETE http://IP Address:port/prefix/export/{id}

id는 Location 필드의 값입니다 (여기서 예시는 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3).

샘플 요청:

DELETE http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3

  • No labels