完善契约与客户端、服务端的收发代码

SHH.CameraService/CameraEngineWorker.cs

@@ -0,0 +1,113 @@
+using Microsoft.Extensions.Hosting;
+using SHH.CameraSdk;
+
+namespace SHH.CameraService;
+
+/// <summary>
+/// 相机服务核心引擎工作者（后台长驻服务）
+/// <para>核心职责：</para>
+/// <para>1. 管理 CameraManager 全生命周期（启动、配置、释放）</para>
+/// <para>2. 初始化网络哨兵（ConnectivitySentinel），监控设备网络连通性</para>
+/// <para>3. 无配置时自动添加默认测试设备，降低调试门槛</para>
+/// <para>设计说明：</para>
+/// <para>- 基于 BackgroundService，运行在独立后台线程，不阻塞 Web 主线程</para>
+/// <para>- 与 CameraManager 强绑定，是所有相机设备的统一入口</para>
+/// <para>- 包含容错机制，添加设备失败不影响整体服务启动</para>
+public class CameraEngineWorker : BackgroundService
+{
+    #region --- 依赖注入字段 ---
+
+    /// <summary>
+    /// 相机管理器实例（核心业务对象）
+    /// 功能：管理所有相机设备的生命周期、状态监控、配置更新
+    /// </summary>
+    private readonly CameraManager _manager;
+
+    /// <summary>
+    /// 网络连通性哨兵实例
+    /// 功能：周期性 Ping 设备、检测网络状态、触发断线重连
+    /// </summary>
+    private readonly ConnectivitySentinel _sentinel;
+
+    #endregion
+
+    #region --- 构造函数 ---
+    /// <summary>
+    /// 初始化相机引擎工作者实例
+    /// </summary>
+    /// <param name="manager">相机管理器（通过 DI 注入，已关联存储服务）</param>
+    /// <param name="sentinel">网络哨兵（通过 DI 注入，已预设监控周期）</param>
+    public CameraEngineWorker(CameraManager manager, ConnectivitySentinel sentinel)
+    {
+        _manager = manager ?? throw new ArgumentNullException(
+            nameof(manager), "相机管理器实例不能为空，核心引擎启动失败");
+        _sentinel = sentinel ?? throw new ArgumentNullException(
+            nameof(sentinel), "网络哨兵实例不能为空，设备监控功能失效");
+    }
+
+    #endregion
+
+    #region --- BackgroundService 核心实现 ---
+
+    /// <summary>
+    /// 启动引擎：初始化相机管理器并加载业务配置
+    /// <para>执行流程：</para>
+    /// <para>1. 启动 CameraManager（加载本地配置文件中的设备信息）</para>
+    /// <para>2. 加载默认业务逻辑（无设备时添加测试设备）</para>
+    /// <para>注意：网络哨兵的启动逻辑已内置在其构造函数中，此处无需额外调用</para>
+    /// </summary>
+    /// <param name="stoppingToken">服务停止令牌（响应应用关闭/重启信号）</param>
+    /// <returns>异步任务（引擎启动完成后结束）</returns>
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        Console.WriteLine("[Engine] 核心引擎启动中...");
+        Console.WriteLine("[Engine] 启动相机管理器（加载设备配置）");
+
+        try
+        {
+            // 启动相机管理器：加载 App_Data/Process_X 目录下的设备配置文件
+            await _manager.StartAsync();
+            Console.WriteLine("[Engine] 相机管理器启动成功，已加载配置文件中的设备");
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[Engine] 相机管理器启动失败：{ex.Message}");
+            Console.WriteLine("[Engine] 警告：核心引擎将继续运行，但无法管理任何相机设备");
+            return;
+        }
+
+        Console.WriteLine("[Engine] 核心引擎启动完成，进入运行状态");
+        Console.WriteLine("[Engine] 提示：可通过 API 接口添加/编辑/删除设备，实时生效");
+    }
+
+    /// <summary>
+    /// 停止引擎：优雅释放资源
+    /// <para>执行流程：</para>
+    /// <para>1. 调用 CameraManager.DisposeAsync()，释放所有设备连接、句柄、线程资源</para>
+    /// <para>2. 调用基类 StopAsync()，标记服务停止状态</para>
+    /// <para>注意：必须先释放 CameraManager，避免设备连接泄露</para>
+    /// </summary>
+    /// <param name="cancellationToken">取消令牌（用于强制终止释放流程）</param>
+    /// <returns>异步任务（资源释放完成后结束）</returns>
+    public override async Task StopAsync(CancellationToken cancellationToken)
+    {
+        Console.WriteLine("[Engine] 核心引擎正在停止...");
+
+        try
+        {
+            // 释放相机管理器：停止所有设备取流、注销登录、释放非托管资源
+            await _manager.DisposeAsync();
+            Console.WriteLine("[Engine] 相机管理器资源已释放");
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[Engine] 资源释放异常：{ex.Message}");
+        }
+
+        // 调用基类方法，完成服务停止
+        await base.StopAsync(cancellationToken);
+        Console.WriteLine("[Engine] 核心引擎已停止");
+    }
+
+    #endregion
+}