新通讯图像协议对接成功

SHH.CameraService/GrpcImpls/ImageFactory/PipelineConfigurator.cs

@@ -0,0 +1,83 @@
+using Microsoft.Extensions.Hosting;
+using SHH.CameraSdk;
+
+namespace SHH.CameraService;
+
+/// <summary>
+/// 图像处理管道配置服务（基于责任链模式）
+/// <para>核心职责：</para>
+/// <para>1. 组装图像处理集群的执行顺序，形成 "缩放 → 增强" 的固定流程</para>
+/// <para>2. 将组装好的管道挂载到全局路由，统一接收驱动层输出的帧数据</para>
+/// <para>设计说明：</para>
+/// <para>- 采用责任链模式，支持动态扩展处理节点（如后续新增滤镜、裁剪等功能）</para>
+/// <para>- 依赖 IHostedService 生命周期，确保在应用启动时完成管道初始化</para>
+/// <para>- 与 GlobalPipelineRouter 强关联，是帧数据进入处理流程的唯一入口</para>
+public class PipelineConfigurator : IHostedService
+{
+    #region --- 依赖注入字段 ---
+
+    /// <summary>
+    /// 图像缩放集群实例（责任链第一节点）
+    /// 功能：根据配置缩放帧分辨率、控制图像放大/缩小开关
+    /// </summary>
+    private readonly ImageScaleCluster _scale;
+
+    /// <summary>
+    /// 图像增强集群实例（责任链第二节点）
+    /// 功能：调整图像亮度、对比度等增强效果（基于 ProcessingConfigManager 配置）
+    /// </summary>
+    private readonly ImageEnhanceCluster _enhance;
+
+    #endregion
+
+    #region --- 构造函数 ---
+
+    /// <summary>
+    /// 初始化管道配置服务实例
+    /// </summary>
+    /// <param name="scale">图像缩放集群（通过 DI 注入，已预设并行度和配置管理器）</param>
+    /// <param name="enhance">图像增强集群（通过 DI 注入，已预设并行度和配置管理器）</param>
+
+    public PipelineConfigurator(ImageScaleCluster scale, ImageEnhanceCluster enhance)
+    {
+        _scale = scale;
+        _enhance = enhance;
+    }
+
+    #endregion
+
+    #region --- IHostedService 实现 ---
+
+    /// <summary>
+    /// 启动服务：组装责任链并挂载到全局路由
+    /// <para>执行时机：应用启动时，在所有 Singleton 服务初始化完成后触发</para>
+    /// </summary>
+    /// <param name="cancellationToken">服务停止令牌（用于响应应用关闭信号）</param>
+    /// <returns>异步任务（无返回值）</returns>
+    public Task StartAsync(CancellationToken cancellationToken)
+    {
+        // 1. 建立责任链关系：缩放集群处理完成后，将帧数据传递给增强集群
+        // 设计逻辑：Scale 是入口节点，Enhance 是后续节点，可按需求插入更多处理节点
+        _scale.SetNext(_enhance);
+
+        // 2. 将责任链入口挂载到全局路由：驱动层输出的所有帧数据都会进入该管道
+        // 关键作用：统一帧数据处理入口，屏蔽驱动层与处理层的直接依赖
+        GlobalPipelineRouter.SetProcessor(_scale);
+
+        // 启动日志：打印管道组装结果，便于运维排查
+        Console.WriteLine("[Pipeline] 图像处理链组装完成: ImageScaleCluster -> ImageEnhanceCluster");
+        Console.WriteLine("[Pipeline] 提示：帧数据将按 '缩放 → 增强' 顺序处理，可通过 GlobalPipelineRouter 调整流程");
+
+        return Task.CompletedTask;
+    }
+
+    /// <summary>
+    /// 停止服务：空实现（无资源需要释放）
+    /// <para>说明：图像处理集群的资源释放由各自的 Dispose 方法管理，此处无需额外操作</para>
+    /// </summary>
+    /// <param name="cancellationToken">服务停止令牌</param>
+    /// <returns>空异步任务</returns>
+    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+
+    #endregion
+}