Przewodnik użytkownika: Integracje Integracje

Interfejs programowania aplikacji

Przykłady API i dokumentacja zostały przeniesione do https://ispysoftware.github.io/Agent_API/

Opakowanie Python'a

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

Parametry URL

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

Polecenia

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 "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/OSX) 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
Ta linia wskazuje, że plik powinien być przetwarzany wewnętrznie przez Agent, a nie uruchamiany jako samodzielna aplikacja.

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ń.

Pamiętaj, aby używać & zamiast ? do oddzielania parametrów w swoich poleceniach.

Po ponownym załadowaniu interfejsu użytkownika i naciśnięciu "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ń!

Amazon Alexa

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.

Asystent domowy

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 (Jeśli To, To)

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.

Powiadomienia push

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

Telegram

Przykład bota Telegram

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 Przewodnik użytkownika
Filtr zastosowany