구성: 동작

정보

Agent DVR의 동작 목록은 카메라/AI 경고 또는 장치 연결 끊김과 같은 특정 이벤트에 대한 응답입니다. 경보 울리기, 스마트 플러그 URL을 통해 조명 켜기, 또는 다른 카메라에서 녹화 시작과 같이 자동으로 응답하는 데 사용합니다. 동작 목록에 액세스하고 설정하려면 장치를 편집하고 메뉴에서 동작 목록 섹션으로 이동하세요.

'추가'를 클릭하여 새 동작을 만듭니다. 아래 이미지와 유사한 구성 화면이 표시됩니다.

AI Actions Interface
AI Task Interface

동작을 시작할 수 있는 다양한 범위의 이벤트가 있습니다. 각 이벤트에 여러 동작을 연결할 수 있으며, 이러한 동작 내에서 다양한 태그를 통합하여 동적 응답을 만들 수 있습니다.

동작 설정

  • 활성화됨: 이를 토글하여 동작을 활성화 또는 비활성화합니다. 또는 일정 및 API를 actionOn, actionOff, actionRun 같은 명령어와 함께 사용하여, 위에 표시된 ID를 사용할 수 있습니다.
  • 이름: 동작의 선택적 이름입니다.
  • 조건: 사용 가능한 이벤트(아래 참조)를 선택합니다.
  • 태그 포함: (AI 이벤트). 이는 주로 AI 이벤트에 사용됩니다. 예를 들어 AI: 개체 발견됨을 선택하고 여기에 고양이를 입력하면, 고양이가 감지될 때만 동작이 시작됩니다. 태그는 서버 설정 - 일반에서 선택한 언어를 기반으로 일치합니다.
  • 규칙: 여러 태그가 모두 일치해야 하는지(AND) 또는 하나라도 일치할 수 있는지(OR) 선택합니다.
  • 존 내: (AI 이벤트). 감지된 개체를 필터링하기 위해 움직임 감지 감지 탭의 움직임 존을 지정합니다. 예를 들어 존 1과 태그로 고양이를 선택하면, 존 1에서 고양이가 감지될 때만 동작이 시작됩니다. 모든 존을 포함하려면 공백으로 둡니다.
  • 반복 시간 제한: 이는 이 간격 내에 이벤트가 발생한 경우 이를 억제하고 타이머를 재설정합니다. 예를 들어 '차량 감지'가 트리거이고 30초 시간 제한이 있으면, 경고가 한 번 전송되고 감지된 교통에 30초 간격이 있을 때까지 후속 경고가 일시 정지됩니다.
  • 작업 추가: 클릭하여 작업을 추가합니다. 동작에 여러 작업을 할당할 수 있습니다(v4.5.5.0+).

사용 가능한 동작 목록

작업은 다양한 시스템, 장치 및 AI 이벤트에 응답할 수 있습니다. 작업을 설정할 수 있는 이벤트는 다음과 같습니다:

  • AI Server Down (AI 서버가 오류를 반환함 - 요청이 3회 실패하고 서버가 다시 온라인 상태가 될 때까지 반복되지 않은 후 이벤트가 발생함)
  • AI Server Up (AI 서버가 오류 상태를 종료함)
  • AI: Ask AI Positive Result (찾고 있던 개체를 발견함)
  • AI: Ask AI Result (긍정 또는 부정 여부에 관계없이 모든 Ask AI 응답에서 발생함)
  • AI: Describe Response Received (이미지가 AI에 의해 설명됨 - 설명은 {MESSAGE} 및 {AIJSON} 태그에 있음)
  • AI: Face Recognized
  • AI: Face Not Recognized
  • AI: License Plate Recognized
  • AI: License Plate Not Recognized
  • AI: Loiter Detected
  • AI: Object Found
  • AI: Object Not Found
  • AI: Sound Recognized (마이크만 해당)
  • 알림
  • Alert Finished
  • Call URL Response Received - 이는 "Call URL" 작업이 실행될 때 받는 응답으로 트리거되며, 다른 작업으로 이에 응답할 수 있습니다.
  • Manual Alert
  • Motion Detected
  • Motion Finished
  • 없음 - 일정에서 "작업: 실행" 명령으로 작업을 직접 트리거하려는 경우 이 옵션을 사용하세요
  • ONVIF Event ON - 예를 들어 ONVIF 논리적 상태 업데이트에 따라 녹화를 시작하고 중지하는 데 사용합니다 (모션 디텍터 유형이 ONVIF로 설정되어야 함)
  • ONVIF Event OFF
  • ONVIF Event Received (카메라에서 받은 모든 ONVIF 이벤트에서 발생함)
  • 사진 촬영됨
  • PTZ Preset Applied
  • Reconnect Failed
  • Recording Failed
  • Recording Finished
  • Recording Started
  • Source Disconnected
  • Source Reconnected
  • Source Covered/ Tampered
  • Switch Device Off
  • Switch Device On
  • 시스템: 활성화됨
  • 시스템: 비활성화됨
  • System: No UI Connected - 마지막 UI 세션이 종료될 때
  • System: Profile Applied
  • System: UI Connected - 누군가 브라우저를 열어 시스템을 볼 때
  • System: UI Disconnected - 세션이 종료될 때 (브라우저 연결이 끊긴 후 약 1분 후에 발생함)
  • Timelapse Started
  • Timelapse Stopped
  • 트립 와이어 통과 - 물체가 트립 와이어를 넘을 때마다 실행됩니다(트립 와이어 검출기를 사용하는 카메라). 동작에서 방향(둘 다, 내향 또는 나가는)을 설정하고, 특정 와이어로 제한하려면 태그에 해당 와이어의 이름을 입력하세요.

추가한 플러그인 이벤트와 사용자 정의 작업도 이 목록의 끝에 나타납니다.

배회 감지

체류(사람 또는 개체가 일정 시간 동안 한 장소에 머물러 있는 상황)를 감지하려면 다음을 설정해야 합니다:

  • 서버 설정에서 AI 서버를 설정합니다
  • AI: 체류 감지에 대한 동작을 추가합니다
  • 찾고 있는 태그를 설정합니다 - 일반적으로 사람이지만 자동차를 사용하여 너무 오래 주차된 자동차를 감지하거나, 여행 가방을 사용하여 잊은 짐을 감지하거나, 소파에 앉아있는 고양이를 감지할 수 있습니다. 예를 들어 자동차,버스,트럭처럼 여기에서 여러 태그를 사용할 수 있습니다. 찾을 수 있는 개체의 목록은 카메라를 편집할 때 객체 인식의 클래스 목록을 참조하세요.
  • 개체를 찾고자 하는 존을 지정합니다. 검출기 탭을 사용하여 움직임 감지 존을 그립니다.
  • 감지된 개체가 존에 있는 것을 허용할 초 단위 시간을 지정합니다.
  • 조건을 충족할 때 수행할 작업 목록을 추가합니다.

참고: 체류 검출기는 모서리 확인 및 오버레이와 같은 객체 인식 설정을 사용합니다

짐 방치, 철사 함정, 사람 수 계산을 포함하여 이 기능의 용도에 대해서는 보안 분석을 참조하세요.

사용자 정의 이벤트 추가

사전 설정된 이벤트 외에도 작업 목록을 추가하여 사용자 정의 이벤트를 만들 수 있습니다. 작업이 생성되면 이벤트 목록에 나타납니다. 그 다음에 이 작업에 대응하는 동작을 설정할 수 있습니다. 작업은 UI의 라이브 페이지에서(카메라를 선택한 후 왼쪽 하단의 작업 아이콘을 딸깍 소리) 트리거되거나 일정에서 찾을 수 있는 동작: 실행 중 명령을 통해 트리거될 수 있습니다.

사용자 정의 작업 목록

작업 목록은 장치들에 연결할 수 있는 명령어이며, 수동으로 동작 목록을 트리거할 수 있습니다. 동작 목록은 문을 열기, 조명 켜기, 소리 재생 등의 작업을 수행하기 위해 타사 API를 호출할 수 있습니다. 작업 목록을 추가, 삭제 및 실행하려면 라이브 페이지에서 장치를 선택하고 작업 목록 아이콘 을 클릭하세요.

작업 목록 설정:

  • 작업을 설명하는 텍스트를 입력하세요. 예를 들어 "조명 켜기"를 입력하고 + 버튼을 클릭합니다. 확인을 클릭하세요.
  • 편집 아이콘 을 사용하여 장치를 편집하려면 클릭하세요. 편집기의 오른쪽 상단 메뉴를 사용하여 동작 목록 패널을 선택하세요.
  • 동작을 추가하세요. "조건" 조건을 방금 만든 작업 목록으로 선택하고(작업 목록은 사용 가능한 동작 목록의 맨 아래에 표시됨) 작업 목록이 수행할 작업을 설정하세요.
  • 확인을 클릭합니다
  • 이제 라이브 보기에서 작업 목록 버튼을 클릭하고 작업 목록 옆의 다음 화살표 버튼을 클릭하여 이 동작을 수동으로 트리거할 수 있습니다.

Agent DVR API를 통해 작업 목록을 트리거할 수도 있습니다.

사용 가능한 작업 목록

작업은 이벤트가 발생할 때 작업이 수행하는 것으로, 이메일 경고 또는 푸시 알림 전송부터 다른 장치의 녹화 제어에 이르기까지 다양합니다. (그러면 아래) 수행할 수 있는 사용 가능한 작업 목록은 다음과 같습니다:

  • 경고 - 장치에서 경고를 트리거합니다
  • 경고음 - Agent DVR 컴퓨터의 스피커에서 경고음을 재생합니다
  • URL 호출 - 선택적 인증 토큰을 사용하여 모든 URL을 호출합니다. 여기서 Agent DVR API를 호출하거나 Discord, Slack, ntfy 및 유사한 서비스로 경고를 보낼 수 있습니다 (웹훅 참조). 서버 설정에서 API 보호가 선택되어 있으면 인증 헤더를 제공해야 합니다. 이를 수행하려면 서버 설정을 통해 사용자 계정을 추가하고 기본 인증 헤더 값을 입력해야 합니다:
BASIC YWRtaW46YWRtaW4=
  • 명령 실행
또한 명령을 참조하세요
자신만의 명령/스크립트를 추가하려면 명령 디렉터리에 .bat 또는 .sh 파일을 추가할 수 있습니다. 그런 다음 배치 파일에 매개변수를 전달할 수 있습니다. 예를 들어, 모든 사진을 D 드라이브의 루트로 복사하려면:

다음을 포함하는 일반 텍스트 파일을 생성합니다:

copy %1 D:\

Agent/Commands에 copyPhoto.bat로 저장합니다 (Linux에서는 .sh 사용 - chmod +x를 사용하여 이 파일을 실행 가능하게 만들어야 함)
그런 다음 작업을 추가합니다:
조건: "사진 촬영됨"
그러면: "명령 실행"
파일: copyPhoto
매개변수: "{FILENAME}"

  • 현재 녹화 클라우드 업로드 - 현재 녹화를 장치의 클라우드 공급자에 업로드합니다
  • 지연 - 다음 작업 실행 전에 일시 중지합니다
  • AI 질문 활성화 / 비활성화
  • 얼굴 인식 활성화 / 비활성화
  • LPR 활성화 / 비활성화
  • 개체 인식 활성화 / 비활성화
  • 패트롤 켜기 활성화 / 비활성화 (장치의 PTZ 패트롤)
  • 소리 인식 활성화 / 비활성화
  • FTP를 통해 현재 녹화 업로드 - 현재 녹화를 장치의 FTP 서버에 업로드합니다
  • 로그 - Agent DVR 로그에 메시지를 작성합니다
  • MQTT - MQTT 메시지를 전송합니다
  • MQTT 이미지 - 원본 라이브 이미지를 jpeg 바이트로 주제에 전송합니다
  • 네트워크 메시지
  • PTZ 명령어 - 카메라를 사전 설정 위치로 이동하거나 PTZ 명령을 실행합니다
  • 이메일 전송 (선택적 이미지 첨부 포함)
  • 동영상 포함 이메일 보내기 (기간 지정 - 이벤트의 버퍼를 포함합니다). v4.9.8.0+
  • 푸시 알림 보내기
  • SMS 전송
  • 동작 감지기 영역 설정 (감지기에서 정의한 영역을 선택합니다)
  • 메시지 표시 - 보기 중인 웹 브라우저에 메시지를 표시합니다
  • 소리 (Agent DVR 컴퓨터)
  • 소리 (카메라)
  • 소리(웹 브라우저)
브라우저 보안으로 인해 웹 페이지와의 상호작용이 필요합니다 (예: 무언가를 클릭). Chrome에서 이 문제를 해결하려면 chrome://settings/content/sound로 이동하여 서버 주소 (또는 원격 포털을 사용 중인 경우 웹사이트)를 허용 목록에 추가합니다.
  • 녹화 시작 (일부 장치) - 중지될 때까지 녹화합니다.
  • RTMP 스트리밍 시작
  • 타임랩스 시작 (일부 장치)
  • 녹화 중지 (일부 장치)
  • RTMP 스트리밍 중지
  • 타임랩스 중지 (일부 장치)
  • Switch Device On
  • Switch Device Off
  • 시스템: 프로필 적용 - 프로필 전환
  • 시스템: 방범 설정
  • 시스템: 방범 해제
  • 녹화 파일 태그 지정 - 현재 녹화에 태그를 추가합니다
  • 사진 촬영 (일부 장치)
  • 문자 음성 변환 (Agent DVR 컴퓨터 - iSpyConnect.com 계정 필요, 텍스트가 웹 서비스 호출을 통해 렌더링되므로)
  • 문자 음성 변환 (웹 브라우저)
브라우저 보안으로 인해 웹 페이지와의 상호작용이 필요합니다 (예: 무언가를 클릭)
  • 문자 음성 변환 (카메라)
  • 적응형 인코딩 트리거 (다른 장치)
  • 알림 트리거 (다른 장치)
  • AI 질문 트리거 (다른 장치)
  • 음성 인식 트리거 (다른 장치)
  • 감지 시 트리거 (다른 장치)
  • 얼굴 인식 트리거 (다른 장치)
  • LPR 트리거 (다른 장치)
  • 객체 인식 트리거 (다른 장치)
  • 녹화 트리거 (타임아웃 포함) (다른 장치). 이것은 녹화 탭의 녹화 트리거 타임아웃 설정까지 녹화합니다. 이 타임아웃은 모든 녹화 트리거 동작 호출에서 재설정됩니다.
  • UI: 보기 변경 - 연결된 UI를 다른 보기로 전환

태그 사용

Agent DVR 동작의 그러면 필드의 태그를 사용하면 동적 응답을 만들 수 있습니다. 일부 태그는 컨텍스트별로 사용할 수 있다는 점에 유의하는 것이 중요합니다. 예를 들어 {FILENAME}은 알림 이벤트에 사용할 수 없으며, {AI}은 AI 서버에서 생성한 이벤트가 아닌 경우 사용할 수 없습니다.

  • {ID}: 개체 ID이며, Agent에서 카메라 또는 마이크로폰을 편집할 때 편집기의 왼쪽 상단에 표시됩니다.
  • {OT}: 개체 유형 ID입니다. 마이크로폰의 경우 1, 카메라의 경우 2입니다.
  • {FILENAME}: 파일명입니다. 녹화 시작됨, 녹화 완료됨, 스냅샷 촬영됨과 같은 이벤트에 적용됩니다. 파일의 전체 로컬 경로입니다.
  • {CURRENT_RECORDING}: 현재 녹화의 파일명입니다. 파일의 전체 로컬 경로입니다. (v5.0.6.0+)
  • {MESSAGE}: 동작을 트리거한 이벤트의 이름입니다(예: "수동 알림").
  • {EVENT}: 이벤트 유형입니다.
  • {NAME}: 장치 이름입니다(일반 탭에서 찾을 수 있음).
  • {GROUPS}: 장치가 속한 그룹입니다(일반 탭에서 찾을 수 있음).
  • {SERVER}: 서버 이름입니다(서버 설정에서).
  • {ALERTID}: 알림의 ID입니다(관련된 알림이 없는 경우 -1).
  • {ALERTCOUNT}: 장치의 알림 횟수입니다.
  • {TIME} 및 {DATE}: 서버의 현재 시간과 날짜입니다.
  • {RECORDED}: 장치가 녹화 중인 경우 "REC"이고, 그렇지 않으면 공백입니다.
  • {TAGS}: 이벤트와 관련된 태그입니다.
  • {PLUGIN}: 플러그인 이벤트의 메시지입니다.
  • {LOCATION}: 카메라의 위치입니다(일반 탭에서 찾을 수 있음).
  • {LEVEL} 및 {DB}: 움직임 감지 또는 오디오 레벨입니다. {DB}은 오디오 장치의 데시벨 레벨입니다. 동작이 실행될 때 측정됩니다. (v4.3.7.0+)
  • {AI}: AI에서 감지된 개체, LPR의 번호판 또는 안면 인식에서 감지된 얼굴의 쉼표로 구분된 목록입니다.
  • {AIJSON}: AI 또는 LPR에서 반환된 JSON 데이터입니다.
  • {ZONE}: 동작을 트리거한 영역입니다(AI를 사용하지 않거나 1,2,3과 같은 여러 영역의 CSV 목록을 사용하는 경우 공백).
  • {BASE64IMAGE}: 라이브 이미지 데이터 URL입니다. 원본 base64 인코딩된 바이트이므로 필요에 따라 포맷합니다(예:
    p=data:image/jpeg;base64,{BASE64IMAGE}
    ). (v4.5.9.0+ 버전 사용 가능). 라이브 이미지는 너비 640px로 크기 조정됩니다.
  • {BASE64IMAGE-LG}: 라이브 이미지 데이터 URL입니다. 원본 base64 인코딩된 바이트이므로 필요에 따라 포맷합니다(예:
    p=data:image/jpeg;base64,{BASE64IMAGE-LG}
    ). (v6.0.8.0+ 버전 사용 가능). 라이브 이미지는 너비 1280px로 크기 조정됩니다.
  • {BASE64IMAGE-NATIVE}: 라이브 이미지 데이터 URL입니다. 원본 base64 인코딩된 바이트이므로 필요에 따라 포맷합니다(예:
    p=data:image/jpeg;base64,{BASE64IMAGE-NATIVE}
    ). (v6.0.8.0+ 버전 사용 가능). 네이티브 라이브 이미지입니다.
  • {TRIPCOUNT}, {TRIPCOUNTLEFT} 및 {TRIPCOUNTRIGHT}: 줄넘기 교차 카운터(합계, 왼쪽 및 오른쪽)는 카메라의 모든 줄넘기에 대해 합산됩니다. 카메라가 줄넘기 검출기를 사용하지 않는 경우 0입니다. (v7.7.4.0+)
  • {TRIPJSON}: JSON 형식의 줄넘기 카운터(예:
    {"left":3,"right":2,"total":5,"wires":[{"wire":1,"left":3,"right":2,"total":5}]}
    (v7.7.4.0+)

예를 들어, AI: 얼굴 인식됨 이벤트의 경우, 텍스트가

안녕하세요 {AI}
인 그러면 작업 문자 음성 변환은 각 인식된 사람을 이름으로 인사합니다.

참고: "사진 촬영됨"과 같은 파일 관련 이벤트와 함께 {BASE64IMAGE} 태그를 사용하면 파일의 전체 크기 이미지를 사용합니다. 그렇지 않으면 현재 라이브 뷰 이미지의 크기를 조정합니다.

순환 경로를 피하기 위해 동작의 트리거 알림에 주의하십시오. 예를 들어 카메라 1의 알림이 카메라 2의 알림을 트리거하고, 이는 다시 카메라 1의 알림을 트리거하는 경우입니다.

동작이 추가되면 표 컨트롤에 동작의 요약이 표시됩니다. 녹색 확인 표시는 활성화된 동작을 나타냅니다.

Example Action Table

스케줄러를 사용하여 동작을 활성화/비활성화하거나 동작을 트리거할 수 있습니다. 예를 들어 특정 시간에 2개의 이미지가 포함된 이메일을 보내도록 동작을 예약할 수 있습니다.

Schedule Actions

이 예에서는 2개의 이미지가 포함된 이메일을 보내도록 동작을 추가했고, 없음 이벤트로 설정했습니다. 그런 다음 일정 항목을 만들어 일요일과 토요일 오전 8시에 해당 동작을 실행하도록 했습니다.