针对界面显示的优化

SHH.CameraSdk/Core/Scheduling/FrameRequirement.cs

@@ -13,25 +13,85 @@ public class FrameRequirement
     /// <remarks> 用于区分不同的帧消费模块，作为帧分发路由的关键标识 </remarks>
     public string AppId { get; set; } = string.Empty;
 
+    /// <summary> 订阅业务类型（描述视频流的最终去向和处理逻辑） </summary>
+    /// <remarks> 决定了后端流控引擎后续的资源分配（如录像机或渲染器） </remarks>
+    public SubscriptionType Type { get; set; } = SubscriptionType.LocalWindow;
+
     #endregion
 
-    #region --- 帧需求参数 (Frame Requirement Parameters) ---
+    #region --- 帧率控制参数 (Frame Rate Control Parameters) ---
 
-    /// <summary> 目标帧率（单位：fps，订阅者期望的每秒接收帧数，0 表示无特定需求） </summary>
-    /// <remarks> 例如：UI 预览需 8fps，AI 分析需 2fps，按需分配以节省计算资源 </remarks>
-    public int TargetFps { get; set; } = 0;
+    /// <summary> 目标帧率（单位：fps，订阅者期望的每秒接收帧数） </summary>
+    /// <remarks> 范围 1-25 fps。例如：UI 预览需 15fps，AI 分析需 5fps </remarks>
+    public int TargetFps { get; set; } = 15;
 
-    /// <summary> 上次获取帧的时间点（单位：毫秒，通常为 Environment.TickCount64） </summary>
-    /// <remarks> 用于帧率控制算法，判断是否达到订阅者的目标帧率需求 </remarks>
+    /// <summary> 上次成功分发帧的时间点（单位：毫秒，基于 Environment.TickCount64） </summary>
+    /// <remarks> 帧率控制算法的核心，用于判断当前时刻是否应向此订阅者推送帧 </remarks>
     public long LastCaptureTick { get; set; } = 0;
 
     #endregion
 
-    #region --- 需求状态控制 (Requirement Status Control) ---
+    #region --- 业务动态参数 (Business Dynamic Parameters) ---
+
+    /// <summary> 备注信息（记录订阅用途、申请人或关联业务系统） </summary>
+    public string Memo { get; set; } = string.Empty;
+
+    /// <summary> 窗口句柄（仅在 Type 为 HandleDisplay 时有效） </summary>
+    /// <remarks> 格式通常为十六进制或十进制字符串，用于跨进程或底层渲染对接 </remarks>
+    public string Handle { get; set; } = string.Empty;
+
+    /// <summary> 录像持续时长（单位：分钟，仅在 Type 为 LocalRecord 时有效） </summary>
+    public int RecordDuration { get; set; } = 5;
+
+    /// <summary> 录像存放路径（仅在 Type 为 LocalRecord 时有效） </summary>
+    /// <remarks> 服务器本地磁盘的绝对路径，例如：D:\Recordings\Camera_01 </remarks>
+    public string SavePath { get; set; } = string.Empty;
+
+    /// <summary> 通讯传输协议（仅在网络转发模式下有效） </summary>
+    public TransportProtocol Protocol { get; set; }
+        = TransportProtocol.Tcp;
+
+    /// <summary> 目标接收端 IP 地址（仅在网络转发模式下有效） </summary>
+    public string TargetIp { get; set; } = "127.0.0.1";
+
+    /// <summary> 目标接收端端口号（仅在网络转发模式下有效） </summary>
+    public int TargetPort { get; set; } = 8080;
+
+    #endregion
+
+    #region --- 运行统计与控制 (Runtime Stats & Control) ---
+
+    /// <summary> 实时计算的输出帧率（单位：fps，实际分发给订阅者的频率） </summary>
+    /// <remarks> 反映系统真实运行状态，若低于 TargetFps 则说明分发链路存在瓶颈 </remarks>
+    public double RealFps { get; set; } = 0.0;
 
     /// <summary> 需求是否激活（true=正常接收帧，false=暂停接收，保留配置） </summary>
-    /// <remarks> 支持动态启停订阅，无需删除需求配置，提升灵活性 </remarks>
     public bool IsActive { get; set; } = true;
 
     #endregion
+
+    #region --- 内部逻辑控制 (Internal Logic Control) ---
+
+    private int _frameCount = 0;
+    private long _lastFpsCalcTick = Environment.TickCount64;
+
+    /// <summary>
+    /// 更新实际帧率统计
+    /// </summary>
+    /// <remarks> 每当成功分发一帧后调用，内部自动按秒计算 RealFps </remarks>
+    public void UpdateRealFps()
+    {
+        _frameCount++;
+        long currentTick = Environment.TickCount64;
+        long elapsed = currentTick - _lastFpsCalcTick;
+
+        if (elapsed >= 1000) // 达到 1 秒周期
+        {
+            RealFps = Math.Round(_frameCount / (elapsed / 1000.0), 1);
+            _frameCount = 0;
+            _lastFpsCalcTick = currentTick;
+        }
+    }
+
+    #endregion
 }