92 lines
2.7 KiB
C#
92 lines
2.7 KiB
C#
using Newtonsoft.Json;
|
||
// 注意：如果不想依赖 Newtonsoft，也可以用 System.Text.Json，但 Newtonsoft 在 Std 2.0 中兼容性更好
|
||
|
||
namespace SHH.Contracts
|
||
{
|
||
/// <summary>
|
||
/// 视频数据传输契约（纯净版 POCO）
|
||
/// </summary>
|
||
public class VideoPayload
|
||
{
|
||
/// <summary>
|
||
/// 构造函数
|
||
/// </summary>
|
||
public VideoPayload()
|
||
{
|
||
SubscriberIds = new List<string>(16);
|
||
Diagnostics = new Dictionary<string, object>(4);
|
||
}
|
||
|
||
#region --- 1. 元数据 (Metadata) ---
|
||
|
||
public string CameraId { get; set; } = string.Empty;
|
||
|
||
/// <summary>采集时间戳 (Unix 毫秒)</summary>
|
||
public long CaptureTimestamp { get; set; }
|
||
|
||
/// <summary>分发时间戳 (Unix 毫秒)</summary>
|
||
public long DispatchTimestamp { get; set; }
|
||
|
||
/// <summary>原始图像宽度</summary>
|
||
public int OriginalWidth { get; set; }
|
||
|
||
/// <summary>原始图像高度</summary>
|
||
public int OriginalHeight { get; set; }
|
||
|
||
/// <summary>目标图像宽度</summary>
|
||
public int TargetWidth { get; set; }
|
||
|
||
/// <summary>目标图像高度</summary>
|
||
public int TargetHeight { get; set; }
|
||
|
||
/// <summary>订阅Ids</summary>
|
||
public List<string> SubscriberIds { get; set; }
|
||
|
||
/// <summary>诊断信息</summary>
|
||
public Dictionary<string, object> Diagnostics { get; set; }
|
||
|
||
/// <summary>
|
||
/// 指示标志：是否存在原始图
|
||
/// </summary>
|
||
public bool HasOriginalImage { get; set; }
|
||
|
||
/// <summary>
|
||
/// 指示标志：是否存在处理图
|
||
/// </summary>
|
||
public bool HasTargetImage { get; set; }
|
||
|
||
#endregion
|
||
|
||
#region --- 2. 二进制数据 (Binary) ---
|
||
|
||
// 标记 JsonIgnore，防止被错误序列化
|
||
[JsonIgnore]
|
||
public byte[]? OriginalImageBytes { get; set; }
|
||
|
||
[JsonIgnore]
|
||
public byte[]? TargetImageBytes { get; set; }
|
||
|
||
#endregion
|
||
|
||
#region --- 3. 辅助方法 (仅保留 JSON 逻辑) ---
|
||
|
||
/// <summary>
|
||
/// 获取纯元数据的 JSON 字符串
|
||
/// </summary>
|
||
public string GetMetadataJson()
|
||
{
|
||
// 在序列化前自动更新标志位，防止逻辑不同步
|
||
HasOriginalImage = (OriginalImageBytes != null && OriginalImageBytes.Length > 0);
|
||
HasTargetImage = (TargetImageBytes != null && TargetImageBytes.Length > 0);
|
||
|
||
return JsonConvert.SerializeObject(this);
|
||
}
|
||
|
||
public static VideoPayload? FromMetadataJson(string json)
|
||
{
|
||
return JsonConvert.DeserializeObject<VideoPayload>(json);
|
||
}
|
||
|
||
#endregion
|
||
}
|
||
} |