녹화 자료 검색

검색 기본 URL

녹화 자료 검색 HTTP 요청은 다음과 같은 기본 URL로 시작합니다.

http://USER:PASSWORD@NVR-ADDRESS:NVR-HTTP-PORT/

위에서 USER:PASSWORD는 검색 권한이 있는 사용자 이름과 비밀번호이고, NVR-ADDRESS:NVR-HTTP-PORT는 NVR의 주소와 HTTP 포트 번호입니다.

http://admin:gollum04@demo.nvrsw.com:80/

기본 URL 뒤에 더 구체적인 동작에 대한 파라미터를 추가하여 HTTP 'GET' 명령으로 요청하면 결과를 리턴합니다. 예를 들어, curl 프로그램을 이용해 다음과 같이 확인할 수 있습니다.

$ curl 'http://admin:gollum04@demo.nvrsw.com:80/setting.cgi?object=recording&action=search&format=text'

카메라 목록 지정

channels 파라미터는 동작에 필요한 카메라 채널 목록입니다. 지정하지 않으면 모든 카메라를 의미합니다. 채널 번호는 0부터 시작하고, 따옴표(,)와 대시 등을 이용해 지정할 수 있습니다. 예를 들어, 채널 0, 1, 2, 3, 5, 9, 10, 11, 12를 지정하려면 다음과 같이 지정하면 됩니다.

channels=0-3,5,9-12

녹화 일자 목록

녹화 자료가 있는 날짜 목록을 얻으려면 카메라 목록을 지정하고 target=summary를 추가하면 됩니다. 예를 들어 다음 요청은,

/setting.cgi?object=recording&action=search&format=text&target=summary&channels=0,2

채널 0, 2에 대한 녹화 일자를 다음과 같은 형태로 알려줍니다.

CHANNELS: 0,2
DATES: 2015-10-05,2015-10-06,2015-10-07

녹화 날짜는 지정한 카메라 목록 중 하나라도 있으면 표시됩니다.

녹화 파일 목록

특정 날짜에 대한 녹화 파일 목록을 얻으려면 카메라 목록을 지정하고 target=day를 추가하고, date=YYYY-MM-DD 형식으로 날짜를 지정하면 됩니다. 예를 들어 다음 요청은,

/setting.cgi?object=recording&action=search&format=text&target=day&date=2015-10-05&channels=0,2

다음과 같은 결과를 리턴합니다.

DATE: 2015-10-05
CHANNELS: 0,2
TIMELINE: 00;87-86399
TIMELINE: 02;87-86399
FILE: 00;/data/disk1/dvr/2015-10-05/00/00-20151005-000127-20151005-001127.avi
FILE: 00;/data/disk1/dvr/2015-10-05/00/00-20151005-001127-20151005-002127.avi
FILE: 00;/data/disk1/dvr/2015-10-05/00/00-20151005-002127-20151005-003127.avi
FILE: 00;/data/disk1/dvr/2015-10-05/00/00-20151005-003127-20151005-004127.avi
FILE: 02;/data/disk1/dvr/2015-10-05/02/02-20151005-000127-20151005-001127.avi
FILE: 02;/data/disk1/dvr/2015-10-05/02/02-20151005-001127-20151005-002127.avi
FILE: 02;/data/disk1/dvr/2015-10-05/02/02-20151005-002127-20151005-003127.avi
FILE: 02;/data/disk1/dvr/2015-10-05/02/02-20151005-003127-20151005-004127.avi
FILE: 02;/data/disk1/dvr/2015-10-05/02/02-20151005-004127-20151005-005127.avi

TIMELINE:, FILE: 바로 뒤에 붙은 00;, 02; 부분은 카메라 채널 번호를 의미합니다.

TIMELINE: 마지막 항목은 해당 카메라의 초 단위로 표현된 지정한 날짜의 녹화 범위입니다. 0시 0분 0초가 0이고, 23시 59분 59초가 86399입니다. 녹화 범위가 중간에 비어 있으면 0-12,15-30 처럼 따옴표(,)로 구분되어 표시됩니다.

FILE: 마지막 항목은 실제 녹화 파일입니다. 이 파일을 EDNet 프로토콜(또는 SDK)를 이용해 재생(replay)하면 됩니다.

FILE: 목록은 시간 순서로 정렬되어 있습니다.

JSON 형식

format=text 대신 format=json 파라미터를 지정하면 텍스트 형식 대신 JSON 형식으로 결과를 돌려줍니다.

녹화 파일 갱신 주기

기본적으로 NVR은 시스템 시작 후에 10분 단위로 녹화 파일을 생성하는데, 현재 녹화 중인 파일은 검색 목록에 표시되지 않습니다. 필요하다면 EDNet 프로토콜에서 녹화 재시작(reload) 요청을 보낸 후에 1~2초 뒤에 다시 검색하면 됩니다.

하지만, 너무 빈번하게 녹화 재시작 요청을 보내면 녹화 파일 길이가 너무 짧아지고 파일이 많이 생성되어 전반적인 성능 저하와 안정성을 해칠 수 있으므로 유의해야 합니다.

지원 버전

NVR 검색 HTTP 프로토콜은 2013년 12월 1일 이후 버전부터 지원합니다.


© NVRSW.com 2016-2018 Thu Sep 06 2018 15:39:38 GMT+0900 (대한민국 표준시)