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 .

Możesz otworzyć Agent w określonym widoku, wywołując adres URL Agent DVR z (z uwzględnieniem wielkości liter):

• ?start=Live&viewIndex=3 (widok na żywo w widoku 3)
• ?start=TimeMachine (widok maszyny czasu)
• ?start=Timeline (widok osi czasu)
• ?start=Photos (widok zdjęć)
• ?start=Recordings (widok nagrań)
• ?start=Floorplans&planIndex=2 (widok planów pięter na planie 2)
• ?start=VR (wirtualna rzeczywistość)

Możesz otworzyć Agent DVR w określonym języku (omijając wybór języka). Po prostu przekaż dwuliterowy kod języka: ?lang=fr

Możesz przekazać nazwę zapisanego filtru do zastosowania za pomocą parametru filtru - np. ?start=Recordings&filter=intruder. Możesz również przekazać czas od i do dla filtra, używając znaczników JavaScript. np. ?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

Odtwarzaj automatycznie dźwięk podczas ładowania (może wymagać również zmiany ustawień przeglądarki):

• ?playaudio=true

Rozpocznij w trybie zminimalizowanym (górna i dolna belka interfejsu użytkownika ukryte):

• ?mini=true

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

• ?un=username&pwd=password

Aby uzyskać dostęp do poleceń w Agent DVR, kliknij ikonę Serwera w lewym górnym rogu interfejsu Agent i wybierz "Polecenia" w sekcji System. Szybkim skrótem jest naciśnięcie "Alt - C".

Agent DVR zawiera kilka predefiniowanych poleceń, które mogą kontrolować jednocześnie wiele urządzeń. Te polecenia wykorzystują API do wykonywania różnych zadań. Masz elastyczność dodawania własnych poleceń niestandardowych do wywoływania API lub uruchamiania oprogramowania na swoim komputerze.

Wywoływanie pliku skryptu

Aby uruchomić ogólny plik skryptu, po prostu dodaj plik .bat (lub .sh na Linux/macOS) do katalogu poleceń. Nazwa pliku skryptu (bez rozszerzenia) pojawi się na liście poleceń i można na nią kliknąć, aby ją uruchomić. Uwaga: Być może konieczne będzie ponowne załadowanie interfejsu użytkownika, aby pojawiła się na liście.

Wywoływanie API

Utwórz nowy plik .bat w folderze Polecenia, gdzie zainstalowany jest Agent. Pierwsza linia powinna być:

REM ispy-internal

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

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Te polecenia są dołączane do wywołań API w formacie /command.cgi?cmd=.... Dlatego możesz użyć dowolnego polecenia dostępnego w API.

Przykładowe polecenia powyżej aktywują wszystkie urządzenia oznaczone jako "zewnętrzne", dezaktywują wszystkie urządzenia "wewnętrzne", rozpoczynają nagrywanie na urządzeniach "zewnętrznych" i wysyłają komunikat rozgłoszeniowy do wszystkich podłączonych klientów.

Sprawdź przycisk polecenia readme dla przykładów oraz dokumentację API, aby uzyskać listę dostępnych poleceń.

Po ponownym załadowaniu interfejsu użytkownika i naciśnięciu "Alt - C", twoje nowe polecenie powinno być widoczne na liście. Kliknij je, aby je wykonać.

Od wersji 3.8.1.0+ możesz używać nazw lokalizacji w poleceniach (np. switchon&location=home). Po prostu przypisz najpierw lokalizację do swoich 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 UI lub wybierz poszczególne kamery. Zawiera również kontrolę dla głównego panelu zabezpieczeń. Aby uzyskać więcej informacji, zobacz link do Home Assistant w sekcji Serwer - Integracje.

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ść.