구성: 동작

정보

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시에 해당 동작을 실행하도록 했습니다.