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