using System;
using System.Buffers.Binary;
using System.IO;
using System.Text.Json;
using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services;
///
/// 服务主进程 ↔ --hik-worker 子进程的管道协议。
///
/// 为什么单独开子进程跑海康:HCNetSDK 是原生库,**访问越界会直接杀掉进程**
/// (0xC0000005),放主进程里等于把扫码收码/上报一起带走。
/// 隔离后 worker 崩了只需重启它,扫码链路无感。
///
/// 传输格式:[4 字节小端长度][UTF-8 JSON]。
/// 选命名管道而不是本机端口:不占端口、管道断开即知对端已死、ACL 天然限制访问者。
///
public sealed record HikWorkerRequest(string Id, string Op, JsonElement? Payload)
{
public static HikWorkerRequest Create(string op, object? payload = null)
{
var element = payload is null
? (JsonElement?)null
: JsonSerializer.SerializeToElement(payload, HikWorkerJson.Options);
return new HikWorkerRequest(Guid.NewGuid().ToString("N"), op, element);
}
}
/// worker 的响应; 由调用方按 自行反序列化
public sealed record HikWorkerResponse(string Id, bool Ok, string? Error, JsonElement? Data);
/// 管道消息的读写(长度前缀 + JSON),两端共用
public static class HikWorkerPipe
{
/// 管道名(服务单实例,固定名即可)
public const string PipeName = "YuncangTrace.HikWorker";
/// 单条消息上限(流计划带十几个通道也远小于这个值)
private const int MaxMessageBytes = 8 * 1024 * 1024;
public static async Task WriteAsync(Stream stream, T payload, CancellationToken ct)
{
var json = JsonSerializer.SerializeToUtf8Bytes(payload, HikWorkerJson.Options);
var header = new byte[4];
BinaryPrimitives.WriteInt32LittleEndian(header, json.Length);
await stream.WriteAsync(header, ct).ConfigureAwait(false);
await stream.WriteAsync(json, ct).ConfigureAwait(false);
await stream.FlushAsync(ct).ConfigureAwait(false);
}
/// 读一条消息;对端正常关闭返回 null
public static async Task ReadAsync(Stream stream, CancellationToken ct) where T : class
{
var header = new byte[4];
if (!await ReadExactAsync(stream, header, ct).ConfigureAwait(false)) return null;
var length = BinaryPrimitives.ReadInt32LittleEndian(header);
if (length is <= 0 or > MaxMessageBytes)
{
throw new InvalidDataException($"管道消息长度非法:{length}");
}
var buffer = new byte[length];
if (!await ReadExactAsync(stream, buffer, ct).ConfigureAwait(false))
{
throw new EndOfStreamException("管道消息被截断");
}
return JsonSerializer.Deserialize(buffer, HikWorkerJson.Options);
}
private static async Task ReadExactAsync(Stream stream, byte[] buffer, CancellationToken ct)
{
var offset = 0;
while (offset < buffer.Length)
{
var read = await stream.ReadAsync(buffer.AsMemory(offset), ct).ConfigureAwait(false);
if (read == 0) return offset > 0 ? throw new EndOfStreamException("管道消息被截断") : false;
offset += read;
}
return true;
}
}
/// 统一的序列化选项(两端必须一致,否则时间/枚举会解析出偏差)
public static class HikWorkerJson
{
public static readonly JsonSerializerOptions Options = new()
{
PropertyNameCaseInsensitive = true,
// 中文警告/错误直接可读,不转 \uXXXX
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
}
/// worker 支持的操作名(两端共用,避免拼错)
public static class HikWorkerOps
{
/// 自检:返回 SDK / ffmpeg 是否就绪、录像根目录
public const string Probe = "probe";
/// 校验某时段有没有录像(真拉一小段)
public const string Check = "check";
/// 按流计划下载并合并
public const string Download = "download";
/// 优雅退出
public const string Shutdown = "shutdown";
}
///
/// 局域网发现用的端口(与 17300/17301 同族,但独立进程独立端口)。
///
/// - :收桌面端的广播询问(**询问-应答**,不是主动公告);
/// - :取流健康端点,桌面端用一次 TCP 连接就能判定"是否同 LAN"。
///
public static class HikWorkerPorts
{
/// 可用 YUNCANG_EDGE_UDP_PORT 临时覆盖(同机并行跑两个实例测试时用)
public static int UdpQuery { get; } = Resolve("YUNCANG_EDGE_UDP_PORT", 17310);
/// 可用 YUNCANG_EDGE_HTTP_PORT 临时覆盖
public static int Http { get; } = Resolve("YUNCANG_EDGE_HTTP_PORT", 17311);
///
/// 监听地址。默认 0.0.0.0(局域网可发现可直连);
/// 设 YUNCANG_EDGE_BIND=127.0.0.1 则只给本机用,不对局域网暴露。
///
public static string BindAddress { get; } = ResolveBind();
private static int Resolve(string name, int fallback)
{
var raw = Environment.GetEnvironmentVariable(name);
return int.TryParse(raw, out var port) && port is > 0 and < 65536 ? port : fallback;
}
private static string ResolveBind()
{
var raw = Environment.GetEnvironmentVariable("YUNCANG_EDGE_BIND");
return string.IsNullOrWhiteSpace(raw) ? "0.0.0.0" : raw.Trim();
}
}
/// 局域网询问/应答的报文(两端共用)
public static class HikWorkerDiscovery
{
public const string QueryType = "edge.query";
public const string ReplyType = "edge.reply";
///
/// 规范化后端地址,只保留「协议 + 主机 + 端口」用于比对。
///
/// 主体 id 在各个环境的库里都可能从 1 开始,光比 subjectId 挡不住跨环境串台
/// (开发库和生产库的「测试仓库」都是 1),所以询问和应答都必须带上后端地址。
///
public static string NormalizeServer(string? raw)
{
if (string.IsNullOrWhiteSpace(raw)) return string.Empty;
var text = raw.Trim();
if (!text.Contains("://", StringComparison.Ordinal)) text = "http://" + text;
return Uri.TryCreate(text, UriKind.Absolute, out var uri)
? uri.Scheme.ToLowerInvariant() + "://" + uri.Host.ToLowerInvariant() + (uri.IsDefaultPort ? "" : ":" + uri.Port)
: string.Empty;
}
}