82 lines
2.9 KiB
C#
82 lines
2.9 KiB
C#
|
using System;
|
|||
|
|
using Newtonsoft.Json;
|
|||
|
|
|
|||
|
|
namespace SHH.Contracts
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 视频数据传输契约（增强版）
|
|||
|
|
/// </summary>
|
|||
|
|
public class VideoPayload
|
|||
|
|
{
|
|||
|
|
// ==========================================
|
|||
|
|
// 1. 基础元数据 (将被序列化到 JSON)
|
|||
|
|
// ==========================================
|
|||
|
|
|
|||
|
|
public string CameraId { get; set; } // 摄像头唯一标记
|
|||
|
|
|
|||
|
|
// 时间信息 (建议使用 DateTime，调试看日志更直观)
|
|||
|
|
public DateTime CaptureTime { get; set; } // 采集时间 (SDK产生图的时间)
|
|||
|
|
public DateTime DispatchTime { get; set; } // 分发时间 (Server发出图的时间)
|
|||
|
|
|
|||
|
|
// ==========================================
|
|||
|
|
// 2. 图像规格信息
|
|||
|
|
// ==========================================
|
|||
|
|
|
|||
|
|
public int OriginalWidth { get; set; } // 原始宽度
|
|||
|
|
public int OriginalHeight { get; set; } // 原始高度
|
|||
|
|
|
|||
|
|
public int TargetWidth { get; set; } // 目标/处理后宽度
|
|||
|
|
public int TargetHeight { get; set; } // 目标/处理后高度
|
|||
|
|
|
|||
|
|
// ==========================================
|
|||
|
|
// 3. 核心二进制数据 (严禁序列化到 JSON)
|
|||
|
|
// ==========================================
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 原始图像数据 (例如海康SDK出来的原始 JPG)
|
|||
|
|
/// JsonIgnore 防止误操作导致序列化性能崩塌
|
|||
|
|
/// </summary>
|
|||
|
|
[JsonIgnore]
|
|||
|
|
public byte[] OriginalImageBytes { get; set; }
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 处理后的目标图像 (例如 Yolo 画框后的图，或者缩放后的图)
|
|||
|
|
/// 可为空
|
|||
|
|
/// </summary>
|
|||
|
|
[JsonIgnore]
|
|||
|
|
public byte[] TargetImageBytes { get; set; }
|
|||
|
|
|
|||
|
|
// ==========================================
|
|||
|
|
// 4. 辅助方法
|
|||
|
|
// ==========================================
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 仅获取元数据的 JSON 字符串
|
|||
|
|
/// </summary>
|
|||
|
|
public string GetMetadataJson()
|
|||
|
|
{
|
|||
|
|
// 创建一个纯净的匿名对象用于序列化
|
|||
|
|
var meta = new
|
|||
|
|
{
|
|||
|
|
CameraId,
|
|||
|
|
CaptureTime,
|
|||
|
|
DispatchTime,
|
|||
|
|
OriginalWidth,
|
|||
|
|
OriginalHeight,
|
|||
|
|
TargetWidth,
|
|||
|
|
TargetHeight,
|
|||
|
|
// 标记一下是否有目标图，方便接收端判断要不要读第3帧
|
|||
|
|
HasTargetImage = (TargetImageBytes != null && TargetImageBytes.Length > 0)
|
|||
|
|
};
|
|||
|
|
return JsonConvert.SerializeObject(meta);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 从 JSON 还原元数据 (还原出来的对象 ImageBytes 默认为空，需后续填充)
|
|||
|
|
/// </summary>
|
|||
|
|
public static VideoPayload FromMetadataJson(string json)
|
|||
|
|
{
|
|||
|
|
return JsonConvert.DeserializeObject<VideoPayload>(json);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|