40 lines
1.6 KiB
C#
40 lines
1.6 KiB
C#
|
namespace SHH.CameraSdk;
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 帧处理任务模型
|
|||
|
|
/// 功能：封装单帧数据的处理任务信息，包含帧数据、分发决策、全链路追踪上下文，是帧处理管道的核心数据载体
|
|||
|
|
/// 用途：在全局处理中心与分发器之间传递，串联帧的二次处理、分发与追踪流程
|
|||
|
|
/// </summary>
|
|||
|
|
public class ProcessingTask
|
|||
|
|
{
|
|||
|
|
#region --- 任务核心标识 (Task Core Identification) ---
|
|||
|
|
|
|||
|
|
/// <summary> 设备唯一标识（关联产生该帧的相机设备ID） </summary>
|
|||
|
|
public long DeviceId { get; set; }
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
|
|||
|
|
#region --- 帧核心数据 (Frame Core Data) ---
|
|||
|
|
|
|||
|
|
/// <summary> 待处理的智能帧数据（包含原始图像数据与引用计数管理） </summary>
|
|||
|
|
/// <remarks> 非空约束：任务必须关联有效帧数据，不可为 null </remarks>
|
|||
|
|
public SmartFrame Frame { get; set; } = null!;
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
|
|||
|
|
#region --- 帧分发决策 (Frame Distribution Decision) ---
|
|||
|
|
|
|||
|
|
/// <summary> 帧处理决策信息（包含是否保留帧、分发目标AppId列表等） </summary>
|
|||
|
|
/// <remarks> 非空约束：任务必须携带决策信息，指导后续分发逻辑 </remarks>
|
|||
|
|
public FrameDecision Decision { get; set; } = null!;
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
|
|||
|
|
#region --- 全链路追踪上下文 (Full-Link Tracing Context) ---
|
|||
|
|
|
|||
|
|
/// <summary> 帧全链路追踪上下文（用于记录帧处理过程中的日志、耗时、状态等信息） </summary>
|
|||
|
|
/// <remarks> 非空约束：支持通过 AddLog 方法补充追踪日志，支撑问题排查 </remarks>
|
|||
|
|
public FrameContext Context { get; set; } = null!;
|
|||
|
|
|
|||
|
|
#endregion
|
|||
|
|
}
|