통합

모바일 애플리케이션

우리의 모바일 앱은 LAN 또는 원격 서비스를 통해 연결할 수 있습니다. Android 및 iOS 장치 모두에서 사용할 수 있습니다.

Agent DVR Remote Android App 를 다운로드하세요.

Agent DVR Remote IOS App 를 다운로드하세요.

파이썬 래퍼

기본 UI 기능을 위한 파이썬 래퍼가 여기에 있습니다: agent-py .

Parâmetros de URL

다음(대소문자 구분)을 사용하여 Agent DVR URL을 호출하여 특정 뷰로 Agent DVR을 열 수 있습니다:

  • ?start=Live&viewIndex=3 (뷰 3의 라이브 뷰)
  • ?start=Live&viewIndex=3&ot=2&oid=2&max=true (뷰 3의 라이브 뷰, 카메라 ID 2 최대화). "oid"는 장치의 객체 ID입니다(카메라를 편집할 때 대화상자 상단에 표시됨). "ot"는 객체 타입입니다. 1 = 마이크, 2 = 카메라.
  • ?start=TimeMachine (타임머신 뷰)
  • ?start=Timeline (타임라인 뷰)
  • ?start=Photos (사진 뷰)
  • ?start=Recordings (녹화 뷰)
  • ?start=Floorplans&planIndex=2 (평면도 뷰, 평면도 2)
  • ?start=VR (가상 현실)

특정 언어로 Agent DVR을 열 수 있습니다(언어 선택 건너뛰기). 2자 언어 코드를 입력하면 됩니다: ?lang=fr

필터 매개변수를 사용하여 저장된 필터의 이름을 전달하여 적용할 수 있습니다. 예: ?start=Recordings&filter=intruder. JavaScript 틱을 사용하여 필터의 시작 및 종료 시간을 전달할 수도 있습니다. 예: ?start=timeline&from=1657841514949&to=1657852514949.

기본 테마 옵션 설정(테마 옵션은 계정 메뉴의 테마 설정에서 사용 가능):

  • ?theme=darkly&variant=dark&large=false
  • ?theme=sketchy&variant=primary&large=true

로드 시 오디오 자동 재생(브라우저 설정 변경이 필요할 수도 있음):

  • ?playaudio=true

최소화 모드로 시작(상단 및 하단 UI 막대 숨김):

  • ?mini=true

자동 로그인을 위해 로컬 사용자명과 암호를 전달하십시오(주의: 이렇게 하면 네트워크에 자격 증명이 노출됩니다):

  • ?un=username&pwd=password

경고 ID로 특정 경고 열기(경고 JSON에 있음):

  • ?alertid=xxx

명령어

Agent DVR에서 Commands에 접근하려면 Agent DVR UI의 오른쪽 위에 있는 Server 아이콘 을 클릭하고 System에서 "Commands"를 선택하세요. 빠른 단축키는 "Alt-C"를 누르는 것입니다.

Agent DVR에는 여러 장치를 동시에 제어할 수 있는 미리 구축된 명령어들이 포함되어 있습니다. 이 명령어들은 API를 사용하여 다양한 작업을 수행합니다. API를 호출하거나 컴퓨터에서 소프트웨어를 실행하기 위해 자신의 맞춤형 명령어를 추가할 수 있는 유연성이 있습니다.

스크립트 파일 호출

일반 스크립트 파일을 실행하려면 commands 디렉토리에 .bat 파일(Linux/macOS에서는 .sh 파일)을 추가하기만 하면 됩니다. 스크립트의 파일명(확장자 제외)이 Commands 목록에 나타나며 클릭하여 실행할 수 있습니다. 참고: UI를 다시 로드해야 표시될 수 있습니다.

API 호출

Agent DVR이 설치된 Commands 폴더에 새 .bat 파일을 생성하세요. 첫 번째 줄은 다음과 같아야 합니다: 

REM ispy-internal

이 줄은 파일이 Agent DVR에 의해 내부적으로 처리되어야 하며 독립 실행형 애플리케이션으로 실행되지 않아야 함을 나타냅니다.

그 다음 줄들은 Agent DVR의 API에 대한 명령어로 해석됩니다. 예를 들어:


 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

이 명령어들은 /command.cgi?cmd=... 형식으로 API 호출에 추가됩니다. 따라서 API에서 사용 가능한 모든 명령어를 사용할 수 있습니다.

위의 예제 명령어들은 "external"로 레이블된 모든 장치를 활성화하고, "internal" 장치를 모두 비활성화하며, "external" 장치에서 녹화를 시작하고, 연결된 모든 클라이언트에 브로드캐스트 메시지를 전송합니다.

readme 명령어 버튼에서 예제를 참조하고 API 설명서에서 사용 가능한 명령어 목록을 확인하세요.

명령어에서 매개변수를 구분할 때 ? 대신 &를 사용하세요.

UI를 다시 로드하고 "Alt-C"를 누른 후 새 명령어가 목록에 표시되어야 합니다. 이를 클릭하여 실행하세요.

버전 3.8.1.0 이상에서는 명령어에 위치 이름을 사용할 수 있습니다(예: switchon&location=home). 먼저 장치에 위치를 할당하세요!

아마존 알렉사

버전 2.9.5.0부터, Agent DVR은 Amazon Alexa 통합을 제공합니다. 이 기능을 사용하면 Alexa 활성화 장치를 통해 음성 명령을 사용하여 Agent DVR을(를) 제어할 수 있습니다. 시스템을 활성화하거나 비활성화하거나 Alexa Show 장치에서 실시간 비디오 피드를 표시할 수 있습니다.

설정하려면, Agent DVR의 서버 메뉴에서 'Integrations' 아래에 'Alexa'를 선택하십시오. 이렇게 하면 계정 연결을 위해 Amazon으로 리디렉션됩니다.

연결한 후, Alexa의 검색 프로세스를 실행하십시오. 보안 패널과 카메라 제어 두 개의 장치를 찾아야 합니다.

이제 다음과 같은 음성 명령을 사용할 수 있습니다:

  • "Alexa, arm Agent in home mode"
  • "Alexa, show Agent camera"

인증이 필요한 작업에 대한 Agent 설정에서 보안 코드를 설정하십시오. 기본 코드는 1234입니다.

Alexa 프로필(홈 / 외출 / 야간)은 Agent DVR의 프로필과 일치합니다. 이를 서버 - 프로필에서 구성하십시오.

여러 서버의 경우, 설정에서 서버 이름을 설정하고 음성 명령에서 사용하십시오.

홈 어시스턴트

Agent DVR는 Home Assistant와 완전히 통합되어 Agent DVR을 Home Assistant 설정에 추가할 수 있습니다. Agent DVR 패널을 lovelace UI에 포함시키거나 개별 카메라를 선택할 수 있습니다. 또한 주 보안 패널에 대한 제어 기능도 포함되어 있습니다. 자세한 내용은 Server - Integrations 아래의 Home Assistant 링크를 참조하십시오.

Agent DVR은 또한 MQTT를 통해 장치를 센서 및 스위치로 Home Assistant에 게시할 수 있습니다: Home Assistant MQTT discovery를 참조하십시오.

만약 이것이면 저것,

IFTTT는 IoT 장치와 작업 및 트리거를 설정할 수 있게 해줍니다. 먼저 IFTTT 계정을 iSpyConnect.com과 연결하세요. 이는 Server - Integrations에서 액세스할 수 있습니다.

푸시 알림

모바일 푸시 알림 설정은 푸시 알림 설정에서 자세히 설명되어 있습니다.

텔레그램

Telegram Bot Example

텔레그램 챗봇과 Agent DVR을 연결하여 제어 및 실시간 알림을 받으세요. 실시간 알림을 위해 장치 설정에서 푸시 알림을 활성화하세요. 원격 웹 인터페이스에서 서버 아이콘 아래의 텔레그램 버튼을 선택하여 시작하세요.

웹훅 (Discord, Slack 등)

Agent DVR은 Discord, Slack, Mattermost, Google Chat, Microsoft Teams, ntfy 등 수신 웹훅을 지원하는 모든 서비스로 알림을 보낼 수 있습니다. 계정 연동이 필요 없습니다. 대상 서비스에서 웹훅 URL을 만들면 Agent DVR이 알림을 직접 전송하므로 원격 접속이 없는 서버에서도 작동합니다.

기본 설정은 모든 서비스에서 동일합니다. 카메라 또는 마이크를 편집하고 작업 탭을 열어 작업을 추가하세요:

  • If: 알림 (또는 다른 이벤트)
  • Then: 호출 URL
  • URL: 서비스에서 발급받은 웹훅 URL
  • 방법: POST
  • 본문: 메시지 (서비스별 형식은 아래 참조)

본문 필드에서 {NAME}, {MESSAGE}, {AI}, {ZONE} 같은 태그를 사용해 메시지를 동적으로 구성할 수 있습니다.

JSON 형식 본문은 Agent DVR v7.8.7.0 이상이 필요합니다. 이전 버전에서는 헤더 필드에 다음 줄을 추가하세요: 
Content-Type: application/json

Discord

Discord에서 채널 설정(톱니바퀴 아이콘)을 열고 연동 - 웹후크 - 새 웹후크를 선택한 다음 웹후크 URL 복사를 클릭하세요. Agent DVR 작업에서 다음과 같이 설정합니다:

  • URL: 복사한 웹훅 URL
  • 본문: 
    {"content":"{MESSAGE}: {NAME} ({SERVER}) {AI}"}

Discord 메시지에 스냅샷을 첨부하려면 이미지 업로드 슬라이더를 1 이상으로 설정하세요 (v7.8.7.0+). 두 번째 이후의 이미지는 0.5초 간격으로 캡처됩니다.

Slack

api.slack.com/apps에서 Slack 앱을 만들고 Incoming Webhooks를 활성화한 뒤 Add New Webhook to Workspace를 클릭하고 채널을 선택해 URL을 복사하세요 (hooks.slack.com으로 시작). Agent DVR 작업에서 다음과 같이 설정합니다:

  • URL: 복사한 웹훅 URL
  • 본문: 
    {"text":"{MESSAGE}: {NAME} ({SERVER}) {AI}"}

Slack 수신 웹훅은 텍스트만 지원하므로 이미지 업로드는 0으로 두세요.

Mattermost

Mattermost에서 메인 메뉴 - 통합 - 수신 웹훅 - 수신 웹훅 추가로 이동해 채널을 선택하고 URL을 복사하세요. 본문 형식은 Slack과 동일합니다: 

{"text":"{MESSAGE}: {NAME} ({SERVER})"}

Google Chat

Google Chat 스페이스(Workspace 계정)에서 스페이스 이름을 클릭하고 앱 및 통합 - 웹훅 - 웹훅 추가를 선택한 뒤 URL을 복사하세요. 본문 형식은 Slack과 동일합니다: 

{"text":"{MESSAGE}: {NAME} ({SERVER})"}

Microsoft Teams

Teams에서 채널 옆의 점 3개를 클릭하고 워크플로를 선택한 다음 웹후크 요청을 받으면 채널에 게시 템플릿을 추가하고 발급된 URL을 복사하세요. Teams는 메시지를 Adaptive Card 형식으로 요구합니다:

{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"{MESSAGE}: {NAME} ({SERVER})","wrap":true}]}}]}

ntfy

ntfy는 계정 없이 휴대폰으로 푸시 알림을 보내며 자체 호스팅도 가능합니다. 추측하기 어려운 토픽 이름을 정하세요 (이름을 아는 사람은 누구나 구독할 수 있습니다):

  • URL: https://ntfy.sh/your-topic-name
  • 본문: 일반 텍스트 (JSON 아님), 예: 
    {MESSAGE}: {NAME} ({SERVER})
  • 헤더 (선택 사항, 한 줄에 하나씩): 
    Title: Agent DVR
Tags: rotating_light
Priority: high

휴대폰에 ntfy 앱을 설치하고 토픽을 구독하면 알림을 받을 수 있습니다.

기타 서비스

HTTP POST를 받는 서비스라면 무엇이든 같은 방식으로 작동합니다. 예를 들어 Home Assistant 웹훅 트리거 (http://homeassistant.local:8123/api/webhook/your-id, 다만 MQTT 통합이 더 강력합니다). Agent DVR은 JSON 본문은 application/json으로, 그 외에는 폼 인코딩으로 전송합니다. API 키 같은 추가 헤더는 헤더 필드에 Name: Value 형식으로 한 줄에 하나씩 추가할 수 있습니다.