통합

모바일 애플리케이션

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

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

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

파이썬 래퍼

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

Parâmetros de URL

Você pode abrir o Agente em uma visualização específica chamando a URL do Agente DVR com (sensível a maiúsculas e minúsculas):

  • ?start=Live&viewIndex=3 (visualização ao vivo na visualização 3)
  • ?start=TimeMachine (visualização de máquina do tempo)
  • ?start=Timeline (visualização de linha do tempo)
  • ?start=Photos (visualização de fotos)
  • ?start=Recordings (visualização de gravações)
  • ?start=Floorplans&planIndex=2 (visualização de plantas baixas no plano 2)
  • ?start=VR (realidade virtual)

Você pode abrir o Agente DVR com um idioma específico (ignorando a seleção de idioma). Basta passar o código de idioma de 2 letras: ?lang=fr

Você pode passar o nome de um filtro salvo para aplicar usando um parâmetro de filtro - por exemplo: ?start=Recordings&filter=intruder. Você também pode passar um horário de início e término para o filtro usando ticks de JavaScript. por exemplo ?start=timeline&from=1657841514949&to=1657852514949.

Definir opções de tema padrão (as opções de tema estão disponíveis no menu da conta - configurações de tema):

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

Reproduzir áudio automaticamente ao carregar (também pode exigir alteração nas configurações do navegador):

  • ?playaudio=true

Iniciar no modo minimizado (barras de interface superior e inferior ocultas):

  • ?mini=true

Passar o nome de usuário e senha local para login automático (atenção - isso exporá suas credenciais para a rede):

  • ?un=username&pwd=password

명령어

Agent DVR에 있는 명령어에 접근하려면, Agent UI의 왼쪽 상단에 있는 서버 아이콘 를 클릭하고, "시스템" 아래에서 "명령어"를 선택하십시오. 빠른 단축키는 "Alt - C"를 누르는 것입니다.

Agent DVR에는 여러 기기를 동시에 제어할 수 있는 몇 가지 미리 만들어진 명령어가 포함되어 있습니다. 이러한 명령어는 다양한 작업을 수행하기 위해 API를 활용합니다. 사용자는 API를 호출하거나 컴퓨터에서 소프트웨어를 실행하기 위해 사용자 정의 명령어를 추가할 수 있습니다.

스크립트 파일 호출

일반적인 스크립트 파일을 실행하려면, 명령어 디렉토리에 .bat 파일(또는 Linux/macOS에서는 .sh 파일)을 추가하면 됩니다. 스크립트 파일의 이름(확장자 제외)은 명령어 목록에 표시되며 클릭하여 실행할 수 있습니다. 참고: 표시되려면 UI를 다시 로드해야 할 수도 있습니다.

API 호출

Agent가 설치된 Commands 폴더에 새로운 .bat 파일을 생성하십시오. 첫 번째 줄은 다음과 같아야 합니다: 

REM ispy-internal

이 줄은 파일이 독립 실행형 응용 프로그램으로 실행되는 것이 아니라 Agent에 의해 내부적으로 처리되어야 함을 나타냅니다.

다음 줄은 Agent의 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" 기기에서 녹화를 시작하고, 모든 연결된 클라이언트에게 방송 메시지를 보냅니다.

예시와 API 문서에서 사용 가능한 명령어 목록을 확인하려면 readme 명령 버튼을 참조하십시오.

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

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와 완전히 통합되어 있으며, Home Assistant 설정에 Agent DVR을 추가할 수 있습니다. 러브레이스 UI에 Agent DVR 패널을 임베드하거나 개별 카메라를 선택할 수 있습니다. 또한 주요 보안 패널을 제어하는 기능도 포함되어 있습니다. 자세한 정보는 서버 - 통합 항목 아래의 Home Assistant 링크를 참조하십시오.

만약 이것이면 저것,

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 형식으로 한 줄에 하나씩 추가할 수 있습니다.