关于 Agent DVR: 插件

安装插件

安装插件的最简单方法是通过远程 Web 门户。连接后，点击左上角的服务器图标，然后在“系统”下找到“插件”。在这里，您可以从右上角的下拉菜单中选择要使用的插件，然后点击“安装”开始使用。

喜欢手动安装？没问题！您可以从源代码构建插件，然后将构建的输出复制到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的音频插件，则需要编辑摄像头，选择音频选项卡，然后点击配置麦克风。从那里，您可以访问音频设备的插件选项卡。或者，您可以点击服务器图标，编辑设备，然后从该列表中编辑麦克风。

配置插件

准备好利用插件的强大功能了吗？只需添加设备（摄像头和/或麦克风），然后进入其编辑设置。在右上角的下拉菜单中找到“插件”选项卡。在这里，您可以选择所需的插件，然后点击“...”按钮根据您的需求进行配置。

一些插件会触发事件，您可以将操作与之关联。例如，天气插件会在阵风超过指定值时（可在插件中配置）触发“阵风”事件。编辑摄像头并导航到“操作”选项卡，您可以选择如何响应此事件 - 例如，触发警报或开始录制。只需在“如果”选择框中选择插件名称：事件 - 例如“天气：阵风”，然后分配一个操作。

创建您自己的插件

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

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

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

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

开发人员插件注意事项：

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

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

在 json 条目中添加 "live": true 可以实现立即更新，无需等待单击“确定”按钮，非常适合实时调整。'converter' 字段利用 Utils.cs 中的 'PopulateResponse' 进行值格式化。

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

持续处理：将设备的每个视频和音频帧发送到插件进行分析或处理，如演示所示。

运动/警报处理：通过在演示插件中利用 'ProcessEvent' 方法在运动或警报时处理帧，可以仅在这些事件期间进行帧处理。

自定义事件:您的插件中的'GetCustomEvents'方法应返回其生成的自定义事件列表。然后这些事件将显示在Agent DVR UI的'If'列表下的操作中。使用'Result'项目触发这些事件，指定操作名称和可选的MSG、Tag、Filename和AIJSON。

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

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

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

语言