Amcrest http api v3.26 - 기술

문서의 이전 판을 선택했습니다! 저장하면 이 자료로 새 판을 만듭니다.

{{tag> amcrest_http_api_v3.26 }}
====== Amcrest http api v3.26======

Amcrest HTTP API V3.26 가이드에 따른 **카메라 제어 주요 API** 요약임.

===== 실시간 스트림 제어 (RTSP)=====

카메라의 실시간 영상을 요청할 때 사용하며, RTSP 프로토콜(기본 포트 554)을 이용함.

* **URL 형식**: `rtsp://<server>:<port>/cam/realmonitor?channel=<channel>&subtype=<type>`

* **subtype**: 0(메인 스트림), 1(서브 스트림 1), 2(서브 스트림 2)

* **주요 메서드**: DESCRIBE, SETUP, PLAY, PAUSE, TEARDOWN.

===== PTZ(팬/틸트/줌) 제어=====

카메라의 방향 및 배율을 조절함.

* **기본 이동**: `Up`, `Down`, `Left`, `Right`, `ZoomWide`, `ZoomTele` 등.

* `http://<ip>/cgi-bin/ptz.cgi?action=start&channel=1&code=<Code>&arg1=0&arg2=<Speed>&arg3=0`

* **프리셋(Preset) 이동**: 특정 저장 위치로 즉시 이동함.

* `http://<ip>/cgi-bin/ptz.cgi?action=start&code=GotoPreset&channel=1&arg2=<PresetID>`

* **3D 포지셔닝**: 화면상의 특정 영역을 지정하여 그 위치로 렌즈를 정렬함.

* `http://<ip>/cgi-bin/ptzBase.cgi?action=moveDirectly&channel=1&startPoint[0]=<x>&startPoint[1]=<y>...`

===== 포커스 및 줌 상세 설정=====

렌즈의 초점과 미세한 배율을 조절함.

* **초점 조절**: `http://<ip>/cgi-bin/devVideoInput.cgi?action=adjustFocus&focus=<val>&zoom=<val>`

* **자동 초점**: `http://<ip>/cgi-bin/devVideoInput.cgi?action=autoFocus&channel=1`

===== 이미지 및 화면 설정=====

카메라의 화질과 출력 방식을 변경함.

* **이미지 속성**: 밝기(Brightness), 대비(Contrast), 채도(Saturation) 조절.

* `http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoColor[0][0].Brightness=50`

* **화면 반전 및 회전**: Flip, Mirror, 90도 회전 기능을 설정함.

* `http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoImageControl[0].Flip=true`

* **주야간 모드**: 컬러, 흑백, 자동 전환 모드를 설정함.

* `http://<ip>/cgi-bin/configManager.cgi?action=setConfig&VideoInDayNight[0][0].Mode=Auto`

===== 스냅샷(Snapshot) 요청=====

현재 화면을 JPEG 이미지로 캡처함.

* **요청**: `http://<ip>/cgi-bin/snapshot.cgi?channel=<channel>`

===== 오디오 제어=====

오디오 채널 확인 및 볼륨을 조절함.

* **볼륨 설정**: `http://<ip>/cgi-bin/configManager.cgi?action=setConfig&AudioOutputVolume[0]=80`

* **오디오 스트림 받기**: `http://<ip>/cgi-bin/audio.cgi?action=getAudio&channel=1`

편집 요약

참고: 이 문서를 편집하면 내용은 다음 라이선스에 따라 배포하는 데 동의하는 것으로 간주합니다: CC Attribution-Noncommercial-Share Alike 4.0 International