Integracje

Nasze aplikacje mobilne pozwalają na połączenie przez LAN lub za pośrednictwem naszych usług zdalnych. Są dostępne zarówno dla urządzeń z systemem Android, jak i iOS.

Pobierz aplikację Agent DVR Remote na Androida .

Pobierz aplikację Agent DVR Remote na iOS .

Tutaj znajduje się nakładka Pythona dla podstawowej funkcjonalności interfejsu użytkownika: agent-py .

Agent DVR można otworzyć do określonego widoku, wywołując adres URL Agent DVR z (uwzględniającymi wielkość liter):

• ?start=Live&viewIndex=3 (widok na żywo dla widoku 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (widok na żywo dla widoku 3, kamera id 2 zmaksymalizowana). "oid" to identyfikator obiektu urządzenia (widoczny w górnej części okna dialogowego podczas edycji kamery), "ot" to typ obiektu - 1 = mikrofon, 2 = kamera.
• ?start=TimeMachine (widok TimeMachine)
• ?start=Timeline (widok osi czasu)
• ?start=Photos (widok zdjęć)
• ?start=Recordings (widok nagrań)
• ?start=Floorplans&planIndex=2 (widok planów pięter dla planu 2)
• ?start=VR (wirtualna rzeczywistość)

Agent DVR można otworzyć z określonym językiem (pomijając wybór języka). Wystarczy przekazać kod języka z 2 literami: ?lang=fr

Możesz przekazać nazwę zapisanego filtru do zastosowania za pomocą parametru filter - na przykład: ?start=Recordings&filter=intruder. Możesz również przekazać czas początkowy i końcowy dla filtru za pomocą znaczników javascript. na przykład ?start=timeline&from=1657841514949&to=1657852514949.

Ustaw domyślne opcje motywu (opcje motywu są dostępne w menu konta - ustawienia motywu):

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

Automatyczne odtwarzanie audio podczas ładowania (może również wymagać zmiany ustawień przeglądarki):

• ?playaudio=true

Uruchomienie w trybie zminimalizowanym (paski interfejsu użytkownika u góry i u dołu ukryte):

• ?mini=true

Przekaż lokalną nazwę użytkownika i hasło do automatycznego logowania (ostrożnie - ujawni to Twoje dane uwierzytelniające sieci):

• ?un=username&pwd=password

Otwórz konkretny alert według identyfikatora alertu (w pliku json alertu):

• ?alertid=xxx

Aby uzyskać dostęp do poleceń w Agent DVR, kliknij na ikonę serwera w prawym górnym rogu interfejsu Agent DVR i wybierz "Commands" (Polecenia) w sekcji System. Szybką skrótem jest naciśnięcie "Alt-C".

Agent DVR zawiera kilka wbudowanych poleceń, które mogą sterować wieloma urządzeniami jednocześnie. Polecenia te wykorzystują API do wykonywania różnych zadań. Masz możliwość dodania własnych niestandardowych poleceń do wywoływania API lub uruchamiania oprogramowania na komputerze.

Wywoływanie pliku skryptu

Aby wykonać ogólny plik skryptu, po prostu dodaj plik .bat (lub plik .sh w systemie Linux/macOS) do katalogu poleceń. Nazwa pliku skryptu (bez rozszerzenia) pojawi się na liście poleceń i będzie można ją kliknąć, aby uruchomić. Uwaga: możesz potrzebować przeładować interfejs, aby się pojawił.

Wywoływanie API

Utwórz nowy plik .bat w folderze Commands tam, gdzie zainstalowany jest Agent DVR. Pierwsza linia powinna brzmieć:

REM ispy-internal

Kolejne linie są interpretowane jako polecenia dla API Agent DVR. Na przykład:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Polecenia te są dołączane do wywołań API w formacie /command.cgi?cmd=.... W ten sposób możesz użyć dowolnego polecenia dostępnego w API.

Powyższe przykładowe polecenia aktywują wszystkie urządzenia oznaczone jako "external", dezaktywują wszystkie urządzenia "internal", rozpoczynają nagrywanie na urządzeniach "external" i wysyłają komunikat rozgłoszeniowy do wszystkich podłączonych klientów.

Zapoznaj się z przyciskiem polecenia readme w celu zapoznania się z przykładami oraz dokumentacją API, aby uzyskać listę dostępnych poleceń.

Po przeładowaniu interfejsu i naciśnięciu "Alt-C" nowe polecenie powinno być widoczne na liście. Kliknij na niego, aby wykonać.

Od wersji 3.8.1.0+, możesz używać nazw lokalizacji w poleceniach (np. switchon&location=home). Wystarczy najpierw przypisać lokalizację do urządzeń!

Od wersji 2.9.5.0 Agent DVR oferuje integrację z Amazon Alexa. Ta funkcja pozwala kontrolować Agent DVR za pomocą poleceń głosowych za pośrednictwem urządzeń obsługujących Alexę. Możesz uzbroić lub rozbroić system lub wyświetlić transmisje wideo na urządzeniach Alexa Show.

Aby to skonfigurować, wybierz 'Alexa' w sekcji Integracje w menu Serwera Agent DVR. Spowoduje to przekierowanie do Amazon w celu połączenia kont.

Po połączeniu, uruchom proces odkrywania Alexy. Powinna ona znaleźć dwa urządzenia: panel zabezpieczeń i kontrolę kamery.

Teraz możesz używać poleceń głosowych takich jak:

• "Alexa, uzbrajaj Agent w trybie domowym"
• "Alexa, pokaż kamerę Agent"

Ustaw swój kod zabezpieczeń w Ustawieniach Agent dla operacji wymagających uwierzytelnienia. Domyślny kod to 1234.

Profile Alexy (Dom / Wyjście / Noc) odpowiadają tym w Agent DVR. Skonfiguruj je w Serwerze - Profile.

Dla wielu serwerów, ustaw nazwę serwera w ustawieniach i używaj jej w poleceniach głosowych.

Agent DVR w pełni integruje się z Home Assistant, umożliwiając dodanie Agent DVR do konfiguracji Home Assistant. Osadź panel Agent DVR w interfejsie lovelace lub wybierz poszczególne kamery. Zawiera również kontrolę dla głównego panelu bezpieczeństwa. Aby uzyskać więcej informacji, zobacz link Home Assistant w sekcji Server - Integrations.

Agent DVR może również publikować swoje urządzenia w Home Assistant jako czujniki i przełączniki za pośrednictwem MQTT: zobacz Autodetekcja MQTT Home Assistant.

IFTTT pozwala ustawić akcje i wyzwalacze z urządzeniami IoT. Zacznij od połączenia konta IFTTT z iSpyConnect.com, dostępnym w zakładce Serwer - Integracje.

Skonfigurowanie powiadomień mobilnych push jest szczegółowo opisane na Ustawienia powiadomień Push.

Połącz Agent DVR z czatem Telegram, aby kontrolować i otrzymywać powiadomienia na żywo. Włącz Powiadomienia push w ustawieniach urządzenia, aby otrzymywać powiadomienia na żywo. Zacznij od wybrania przycisku Telegram pod ikoną Serwera w zdalnym interfejsie internetowym.

Agent DVR może wysyłać alerty do dowolnej usługi przyjmującej webhooki przychodzące, w tym Discord, Slack, Mattermost, Google Chat, Microsoft Teams i ntfy. Nie trzeba łączyć kont: tworzysz adres URL webhooka w usłudze docelowej, a Agent DVR wysyła tam alerty bezpośrednio, więc działa to również na serwerach bez zdalnego dostępu.

Ogólna konfiguracja jest taka sama dla każdej usługi. Edytuj kamerę lub mikrofon, otwórz zakładkę Akcje i dodaj akcję:

• Jeśli: Alert (lub dowolne inne zdarzenie)
• Wtedy: Wywołaj URL
• URL: adres URL webhooka z usługi
• Metoda: POST
• Ciało: wiadomość w formacie pokazanym poniżej dla każdej usługi

W polu Ciało możesz używać tagów takich jak {NAME}, {MESSAGE}, {AI} i {ZONE}, aby dynamicznie budować wiadomość.

Content-Type: application/json

Discord

W Discordzie otwórz ustawienia kanału (ikona zębatki) i wybierz Integracje - Webhooki - Nowy webhook, a następnie Kopiuj adres URL webhooka. W akcji Agent DVR użyj:

• URL: skopiowany adres URL webhooka
• Ciało:

  {"content":"{MESSAGE}: {NAME} na {SERVER} {AI}"}

Aby dołączyć zrzuty do wiadomości Discord, ustaw suwak Prześlij obraz na 1 lub więcej (v7.8.7.0+). Każdy kolejny obraz jest przechwytywany co pół sekundy.

Slack

Utwórz aplikację Slack na api.slack.com/apps, włącz Incoming Webhooks, kliknij Add New Webhook to Workspace, wybierz kanał i skopiuj adres URL (zaczyna się od hooks.slack.com). W akcji Agent DVR użyj:

• URL: skopiowany adres URL webhooka
• Ciało:

  {"text":"{MESSAGE}: {NAME} na {SERVER} {AI}"}

Webhooki przychodzące Slacka obsługują tylko tekst, więc pozostaw Prześlij obraz na 0.

Mattermost

W Mattermost przejdź do Menu główne - Integracje - Webhooki przychodzące - Dodaj webhook przychodzący, wybierz kanał i skopiuj adres URL. Użyj tego samego formatu Ciała co dla Slacka:

{"text":"{MESSAGE}: {NAME} na {SERVER}"}

Google Chat

W przestrzeni Google Chat (konta Workspace) kliknij nazwę przestrzeni i wybierz Aplikacje i integracje - Webhooki - Dodaj webhooka, a następnie skopiuj adres URL. Użyj tego samego formatu Ciała co dla Slacka:

{"text":"{MESSAGE}: {NAME} na {SERVER}"}

Microsoft Teams

W Teams kliknij trzy kropki obok kanału, wybierz Przepływy pracy i dodaj szablon Opublikuj w kanale po odebraniu żądania elementu webhook, a następnie skopiuj otrzymany adres URL. Teams wymaga wiadomości w formie Adaptive Card:

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

ntfy

ntfy wysyła powiadomienia push na telefon bez konieczności zakładania konta i może być też hostowany samodzielnie. Wybierz trudną do odgadnięcia nazwę tematu (każdy, kto ją zna, może subskrybować), a następnie:

• URL: https://ntfy.sh/twoja-nazwa-tematu
• Ciało: zwykły tekst (bez JSON), np.

  {MESSAGE}: {NAME} na {SERVER}

• Nagłówki (opcjonalnie, po jednym w wierszu):

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

Zainstaluj aplikację ntfy na telefonie i zasubskrybuj swój temat, aby otrzymywać alerty.

Inne usługi

Wszystko, co przyjmuje HTTP POST, działa w ten sam sposób, na przykład wyzwalacze webhook w Home Assistant (http://homeassistant.local:8123/api/webhook/twoje-id - choć integracja MQTT jest bogatsza). Agent DVR wysyła ciała JSON jako application/json, a wszystko inne w kodowaniu formularza. Dodatkowe nagłówki (np. klucze API) możesz dodać w polu Nagłówki, po jednym w wierszu jako Nazwa: Wartość.