整合: 整合

API (應用程式介面)

API 的範例和文件已經移至 https://ispysoftware.github.io/Agent_API/

Python包裝器

這裡有一個用於基本 UI 功能的 Python 封裝程式：agent-py 。

URL參數

您可以通過調用Agent DVR的URL以打開特定視圖（區分大小寫）：

?start=Live&viewIndex=3（在第3個視圖上進行實時視圖）
?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 ticks傳入過濾器的起始時間和結束時間，例如：?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

指令

要在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'

這些命令附加到API調用的格式/command.cgi?cmd=...。因此，您可以使用API中可用的任何命令。

上述示例命令將激活所有標記為"external"的設備，停用所有"internal"設備，開始在"external"設備上錄製，並向所有連接的客戶端發送廣播消息。

請參閱readme命令按鈕上的示例以及API文檔中提供的可用命令列表。

請記住在命令中使用&而不是?來分隔參數。

重新加載UI並按下"Alt - C"鍵後，您的新命令應該在列表中可見。點擊它以執行。

從版本3.8.1.0+開始，您可以在命令中使用位置名稱（例如switchon&location=home）。只需首先為您的設備分配一個位置！

Amazon Alexa

從版本2.9.5.0開始，Agent DVR提供Amazon Alexa集成。此功能允許您通過Alexa兼容設備的語音命令來控制Agent DVR。您可以對系統進行布防或撤防，或在Alexa Show設備上顯示實時視頻鏈接。

要設置它，請在Agent DVR的Server菜單中的Integrations下選擇“Alexa”。這將將您重定向到Amazon以連接您的帳戶。

連接後，運行Alexa的發現過程。它應該會找到兩個設備：安全面板和攝像頭控制。

現在，您可以使用以下語音命令：

"Alexa，布防Agent進入家庭模式"
"Alexa，顯示Agent攝像頭"

在Agent設置中設置您的安全代碼以進行需要驗證的操作。默認代碼為1234。

Alexa配置文件（家庭/離開/夜間）與Agent DVR中的配置文件相匹配。請在Server - Profiles中進行配置。

對於多個服務器，請在設置中設置服務器名稱並在語音命令中使用它。

家庭助手

Agent DVR 完全整合了 Home Assistant，允許您將 Agent DVR 添加到您的 Home Assistant 設置中。將 Agent DVR 面板嵌入 lovelace UI 或選擇個別攝像頭。它還包括主要安全面板的控制功能。有關更多信息，請參閱 Server - Integrations 下的 Home Assistant 鏈接。

IFTTT（If This Then That）

IFTTT 讓您可以設定與物聯網設備的動作和觸發器。首先，將您的 IFTTT 帳戶與 iSpyConnect.com 進行連結，可在伺服器 - 整合中找到。

推送警報

設置行動推送警示詳情請參閱設置推送警示。

Telegram [電報]

將Agent DVR與Telegram聊天機器人連接，以進行控制和即時警報通知。在設備設置中啟用推送通知以獲取即時警報。首先，在遠程網頁界面的服務器圖標下選擇Telegram按鈕。