PTZ 제어

PTZ를 제어합니다.

사용자 인증

HTTP Basic 인증을 사용합니다. 사용자는 해당 카메라의 장치 제어 권한이 있어야 합니다.

PTZ URL 형식

PTZ URL 기본 형식은 다음과 같습니다.

GET /ptz/[camera]?action=[action]

positionstop 명령 이외의 명령은 timeout 인수를 사용할 수 있으며, 단위는 밀리초 입니다. timeout 인수를 사용할 수 있는 명령을 보내면, 일정 시간이 지난 후 자동으로 stop 명령을 카메라에 보냅니다. timeout의 기본 값은 1초이며, timeout 값이 0 이면 자동으로 stop 명령을 보내지 않습니다.

팬 / 틸트 / 줌 / 포커스 이동

action 목록

팬 / 틸트 / 줌 / 포커스 명령은 speed 인수를 사용할 수 있습니다. 해당 인수는 이동 속도를 나타내며, 값의 범위는 1 ~ 100 입니다.

다음은 속도 50으로 Pan 을 왼쪽으로 이동하는 예제입니다.

GET /ptz/0?action=pan-left&speed=50 HTTP/1.1

다음은 속도 100으로 Tilt 를 아래로 이동하는 예제입니다.

GET /ptz/0?action=tilt-down&speed=100 HTTP/1.1

다음은 PTZ 이동을 중지하는 예제입니다.

GET /ptz/0?action=stop HTTP/1.1

자동 팬 / 틸트

action 목록

다음은 팬 자동을 실행하는 명령입니다.

GET /ptz/0?action=pan-auto-on HTTP/1.1

다음은 팬 자동을 중지하는 명령입니다.

GET /ptz/0?action=pan-auto-off HTTP/1.1

자동 포커스

action 목록

다음은 자동 포커스를 실행하는 명령입니다.

GET /ptz/0?action=focus-auto HTTP/1.1

프리셋

카메라의 프리셋을 설정하고, 이동하는 기능입니다.

action 목록

preset 인수는 프리셋 번호를 나타내며, 값의 범위는 1 ~ 255 입니다.

다음은 프리셋 1번으로 이동하는 예제입니다.

GET /ptz/0?action=preset-move&preset=1 HTTP/1.1

다음은 프리셋 2번을 설정하는 예제입니다.

GET /ptz/0?action=preset-set&preset=2 HTTP/1.1

홈 위치

PTZ 홈 기능을 지원하는 카메라의 홈 위치를 설정하고 이동하는 기능입니다.

action 목록

다음은 홈 위치로 이동하는 예제입니다.

GET /ptz/0?action=home-move HTTP/1.1

다음은 홈 위치를 설정하는 예제입니다.

GET /ptz/0?action=home-set HTTP/1.1

중심 이동

요청한 위치가 영상의 중심이 되도록 PTZ 를 이동하는 명령입니다.

action 목록

사용하는 인수는 다음과 같습니다.

다음은 중심을 (1000, 8000) 으로 이동하는 예제입니다.

 GET /ptz/0?action=center&x=1000&y=8000 HTTP/1.1

절대 좌표 이동

절대 좌표 위치로 PTZ 를 이동하는 명령입니다.

action 목록

사용하는 인수는 다음과 같습니다.

autofocus 값이 1 이면, focus 값은 무시됩니다.

다음은 팬(1000), 틸트(5000), 줌(2000), 포커스(500)로 이동하는 예제입니다.

GET /ptz/0?action=position&pan=1000&tilt=5000&zoom=2000&focus=500 HTTP/1.1

다음은 팬(1000), 틸트(5000), 줌(2000) 로 이동하고, 자동 포커스를 사용하는 예제입니다.

GET /ptz/0?action=position&pan=1000&tilt=5000&zoom=2000&autofocus=1 HTTP/1.1

영역 이동

요청한 영역으로 PTZ 를 이동하는 명령입니다.

action 목록

사용하는 인수는 다음과 같습니다.

다음은 좌표(1000, 8000) 기준으로 넓이(5000), 높이(5000) 영역으로 이동하는 예제입니다.

 GET /ptz/0?action=areazoom&x=1000&y=8000&width=5000&height=5000 HTTP/1.1

AUX

카메라의 AUX 장치를 켜고, 끄는 기능입니다.

action 목록

device 인수는 AUX 장치 번호를 나타내며, 값의 범위는 1 ~ 255 입니다.

다음은 AUX 장치 1번을 켜는 예제입니다.

GET /ptz/0?action=aux-on&device=1 HTTP/1.1

다음은 AUX 장치 2번을 끄는 예제입니다.

GET /ptz/0?action=aux-off&device=2 HTTP/1.1

기타

action 목록

다음은 와이퍼를 켜는 명령입니다.

GET /ptz/0?action=wiper-on HTTP/1.1

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