关于 Agent DVR: 插件

安装插件

插件是可选的附加模块，可以扩展Agent DVR的功能，提供额外的音频和视频处理功能，例如条码扫描、天气叠加层和音频滤波器。

安装插件最简便的方法是通过远程web门户。连接后，点击右上角的Server图标，在System下导航到"Plugins"。在这里，您可以从右上角的下拉菜单中选择要使用的插件，然后点击"Install"开始。

更喜欢手动安装？没问题！您可以从源代码构建插件，然后将构建的输出复制到Agent/Plugins/PLUGINNAME。这种方法让您对安装过程有更多的控制权。

可用的插件

Agent DVR配备了先进的视频处理功能，如CodeProject AI集成，以及先进的对象跟踪、音频识别和计数检测器。为了进一步增强您的体验，我们提供了一系列插件，您可以在AgentDVR中使用以扩展其功能。

插件列表

条形码

从摄像头扫描几乎任何条形码（仅限Windows）。

触发事件：条形码已识别
支持：视频

截图

增益

对来自音频设备的音频应用实时频段滤波器。

触发事件：无
支持：音频

截图

实时延迟

为实时音频和视频添加延迟（适用于体育分析）。

触发事件：无
支持：视频、音频

截图

天气

根据您的位置向实时视频添加天气状态叠加层。在天气变化时触发事件 - 例如暴风雨即将来临或风阵或温度限制超过时。您可以自定义天气数据的布局和显示模式，从仅图标到完整详细信息。

天气配置采用格式字符串来布局信息。以下是您可以使用的一些示例格式字符串：

完整信息：

{icon}{main}: {description} 
 风速: {wind} 阵风: {gust} 
 温度: {temp} 体感温度: {feelsLike} 
 湿度: {humidity} 紫外线指数: {uvi}

仅图标：

{icon}

单行：

{main} {wind} {temp} {humidity} 紫外线指数: {uvi}

触发事件：高温、阵风、状态
支持：视频

截图

如果您在摄像头上使用音频插件（如Listen），您需要编辑摄像头，选择音频标签并点击配置麦克风。从那里您可以访问音频设备的插件标签。或者，您可以点击服务器图标，编辑设备，并从该列表编辑麦克风。

配置插件

准备好利用插件的功能了吗?只需添加设备(摄像头和/或麦克风),然后进入其编辑设置。在右上角的下拉菜单中查找"插件"选项卡。在这里,您可以选择所需的插件,点击"..."按钮根据需要配置它。

某些插件会触发事件,您可以为其附加操作。例如,天气插件在阵风速度超过指定值(可在插件中配置)时触发阵风事件。编辑摄像头并导航到"操作"选项卡可提供响应选项 - 例如触发警报或开始录制。只需在"如果"选择框中选择插件名称:事件(例如 Weather: Gust),然后分配操作。

创建您自己的插件

插件是可动态添加到 Agent DVR 的模块，用于增强其音频和视频处理功能。通过插件，您可以在 Agent DVR 中应用实时效果、叠加层、触发事件和警报，实现高级自定义操作。

要开始为 Agent DVR 创建插件，请从克隆我们的开源插件开始，地址为 https://github.com/ispysoftware/AgentDVR-Plugins。您需要最新版本的 Visual Studio 来构建它们。

我们建议以演示插件作为基础开始。确保您已安装最新版本的 Agent。构建演示插件后，将输出文件夹中的所有文件复制到 Agent\Plugins\Demo\ 目录。重启 Agent DVR，编辑摄像头，转到插件选项卡。启用插件，从下拉列表中选择演示，然后单击"..."按钮进行配置。

演示插件完全跨平台兼容，展示了使用插件可以构建的广泛功能。它包括实时视频效果、图形叠加、实时音量控制以及与 Agent DVR 事件子系统的集成。插件菜单提供了各种输入控件如何工作的见解。

开发者插件说明：

配置：Agent DVR 使用 JSON 和类文件进行设置存储。要配置设置，请编辑 config.cs 文件。

Agent DVR 的配置渲染依赖于 .json 文件。编辑 json 目录中的 config_en.json 以进行 UI 显示，您可以添加多个部分作为选项卡呈现。json 中的"bindto"键字段链接到配置字段。Agent DVR 自动化控件渲染、设置存储和更新。

在 json 条目中添加

"live": true

可启用即时更新，无需等待 OK 按钮点击，非常适合实时调整。"converter"字段利用 Utils.cs 中的"PopulateResponse"进行值格式化。

媒体支持：选择处理"视频"、"音频"或两者。Main.cs 中的"Supports"字段可以硬编码。

连续处理：来自设备的每一帧视频和音频都被发送到插件进行分析或处理，如演示中所示。

运动/警报处理：通过利用演示插件中的"ProcessEvent"方法在运动或警报时处理帧。这允许仅在这些事件期间处理帧。

自定义事件：插件中的"GetCustomEvents"方法应返回其生成的自定义事件列表。这些事件随后会出现在 Agent DVR UI"If"列表的操作下。使用"Result"项触发这些事件，指定操作名称和可选的 MSG、Tag、Filename 和 AIJSON。

警报、检测和标记：通过添加 eventName 为"alert"或"detect"的 Result 来触发警报或检测事件。使用"tag"eventName 标记正在进行的录制，并根据需要设置标记。

API 调用：Agent DVR 使用设备信息和本地服务器端口初始化插件，可用于设备的 API 命令。还设置了 AppDataPath 和 AppPath 属性，用于显示或文件保存位置。

发布：创建了一个很酷或有用的插件？与我们分享并为社区做出贡献！

语言