using Newtonsoft.Json;
using System;
using System.Collections.Generic;
namespace SHH.Contracts
{
///
/// 视频数据传输契约(增强版)
///
public class VideoPayload
{
public List SubscriberIds { get; } = new List(16);
// ==========================================
// 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)
// ==========================================
///
/// 原始图像数据 (例如海康SDK出来的原始 JPG)
/// JsonIgnore 防止误操作导致序列化性能崩塌
///
[JsonIgnore]
public byte[] OriginalImageBytes { get; set; }
///
/// 处理后的目标图像 (例如 Yolo 画框后的图,或者缩放后的图)
/// 可为空
///
[JsonIgnore]
public byte[] TargetImageBytes { get; set; }
// ==========================================
// 4. 辅助方法
// ==========================================
///
/// 仅获取元数据的 JSON 字符串
///
public string GetMetadataJson()
{
// 创建一个纯净的匿名对象用于序列化
var meta = new
{
CameraId,
CaptureTime,
DispatchTime,
OriginalWidth,
OriginalHeight,
TargetWidth,
TargetHeight,
SubscriberIds,
// 标记一下是否有目标图,方便接收端判断要不要读第3帧
HasTargetImage = (TargetImageBytes != null && TargetImageBytes.Length > 0)
};
return JsonConvert.SerializeObject(meta);
}
///
/// 从 JSON 还原元数据 (还原出来的对象 ImageBytes 默认为空,需后续填充)
///
public static VideoPayload FromMetadataJson(string json)
{
return JsonConvert.DeserializeObject(json);
}
}
}