using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services;
/// 接口调用失败(能拿到后端的 message 就透出去)
public sealed class ApiException : Exception
{
public ApiException(string message, int statusCode = 0, string? status = null, DateTimeOffset? expireAt = null)
: base(message)
{
StatusCode = statusCode;
Status = status;
ExpireAt = expireAt;
}
/// HTTP 状态码(网络层失败为 0)
public int StatusCode { get; }
/// 后端 envelope 里的 `status`(如 `subject_expired` / `subject_disabled`)
public string? Status { get; }
/// 主体到期时间(仅 `subject_expired` 时有)
public DateTimeOffset? ExpireAt { get; }
/// 主体已过期:上报循环应暂停,等心跳探测到续期后再恢复
public bool IsSubjectExpired => Status == "subject_expired";
/// 主体不可用(过期 / 停用 / 被删):都不该继续上报
public bool IsSubjectUnavailable => Status is "subject_expired" or "subject_disabled" or "subject_missing";
}
/// 登录用户(后端 `/api/web/auth/login` 返回的 user 子集)
public sealed record ApiUser(int Id, string? Username, string? Nickname)
{
/// 界面显示名
public string DisplayName =>
!string.IsNullOrWhiteSpace(Nickname) ? Nickname!
: !string.IsNullOrWhiteSpace(Username) ? Username!
: $"#{Id}";
}
/// 主体(租户)
public sealed record ApiSubject(int Id, string Name, string? ExpireAt, bool Expired, int Role, int MemberCount, string? MemberName)
{
/// 1 = 管理员(只有管理员能看到 / 使用「开启设备服务」)
public bool IsAdmin => Role == 1;
/// 下拉/列表里的显示文案
public string Display => Expired ? $"{Name}(已到期)" : Name;
}
/// 登录结果:会话 + 用户 + 可进入的主体列表(后端登录接口一起下发)
public sealed record LoginResult(Session Session, ApiUser User, IReadOnlyList Subjects);
/// 微信扫码登录:发码结果(`State` 是本地会话 id,轮询用它;`QrUrl` 是本站画的二维码图片)
public sealed record WechatTicket(string State, string QrUrl);
/// 微信扫码登录:轮询结果(`Message` 只在失败时有值)
public sealed record WechatPollResult(string Status, Session? Session, ApiUser? User, string? Message = null);
/// 本机设备(scanners 表的一行,够桌面端展示用)
public sealed record ApiDevice(int Id, string Sn, string? Name, string? LastSeenAt);
/// 录像机登录凭据(**含明文密码**,只在内存里用,别落盘/别打日志)
public sealed record NvrCredential(int Id, string Name, string Host, int Port, string Username, string Password);
/// 录像机(列表用,不含密码)
public sealed record ApiNvr(int Id, string Name, string Host, int Port, string? SerialNumber);
/// 摄像头 = 录像机上的一个通道(校时按 走)
public sealed record ApiCamera(int Id, int ChannelNo, string Name, string? ChannelName)
{
/// 界面显示名
public string Display => string.IsNullOrWhiteSpace(Name)
? (string.IsNullOrWhiteSpace(ChannelName) ? $"通道{ChannelNo}" : ChannelName!)
: Name;
}
/// 激活设备服务的结果
public sealed record DeviceActivation(
int Id,
string Sn,
string? Name,
string Token,
string TokenType,
string? ExpiresIn,
bool FirstTime,
IReadOnlyList Kicked,
string RefreshToken,
string? RefreshExpiresIn);
/// 刷新设备令牌的结果
public sealed record DeviceTokenRefresh(
string Sn,
string Token,
string TokenType,
string? ExpiresIn,
string RefreshToken,
string? RefreshExpiresIn);
/// 设备所属主体状态(心跳返回;`Expired` 由服务端按缓存计算,客户端不要用本地时间判断)
public sealed record DeviceSubjectState(
int Id,
string? Name,
int Status,
DateTimeOffset? ExpireAt,
bool Expired,
bool Disabled,
long? RemainingSeconds);
/// 设备心跳结果:保活信息 + 主体租约状态
public sealed record DeviceHeartbeat(
string? Sn,
DateTimeOffset? LastSeenAt,
DateTimeOffset? ServerTime,
DeviceSubjectState? Subject);
///
/// 后端接口客户端(登录 / 主体 / 设备服务 / 上报)
///
/// 契约见 backend/README:成功 `{ ok:true, data }`,失败 `{ ok:false, message }`。
/// 业务接口除了 `Authorization` 还要带 `X-Subject-Id`(主体范围)。
///
public sealed class ApiClient
{
private static readonly HttpClient Http = new() { Timeout = TimeSpan.FromSeconds(15) };
/// 长轮询专用:挂起时间比 15 秒长,必须用不限时的客户端
private static readonly HttpClient LongPollHttp = new() { Timeout = Timeout.InfiniteTimeSpan };
private static readonly JsonSerializerOptions Json = new()
{
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
public ApiClient(string serverBaseUrl)
{
BaseUrl = AppSettings.Normalize(serverBaseUrl);
}
/// 后端根地址(已去掉末尾斜杠)
public string BaseUrl { get; }
// ==================== 登录 ====================
/// 账号密码登录(`POST /api/web/auth/login`),返回令牌 + 用户 + 主体列表
/// 账号密码错 / 网络不通 / 返回格式不对
public async Task LoginAsync(string account, string password, CancellationToken ct = default)
{
var body = JsonSerializer.Serialize(new { account, password }, Json);
using var content = new StringContent(body, Encoding.UTF8, "application/json");
using var response = await SendAsync(
() => new HttpRequestMessage(HttpMethod.Post, $"{BaseUrl}/api/web/auth/login") { Content = content },
"登录", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
var token = GetString(data.Value, "token") ?? throw new ApiException("登录返回里没有令牌");
var user = ReadUser(data.Value);
var subjects = ReadSubjects(data.Value, "subjects");
var session = new Session
{
Token = token,
UserId = user.Id,
DisplayName = user.DisplayName,
ServerBaseUrl = BaseUrl,
};
return new LoginResult(session, user, subjects);
}
/// 微信扫码登录:申请一张二维码(`POST /api/web/auth/wechat-gateway/qrcode`,无需令牌)
public async Task StartWechatLoginAsync(CancellationToken ct = default)
{
using var response = await SendAsync(
() => new HttpRequestMessage(HttpMethod.Post, $"{BaseUrl}/api/web/auth/wechat-gateway/qrcode")
{
Content = new StringContent("{}", Encoding.UTF8, "application/json"),
},
"生成登录二维码", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
var state = GetString(data.Value, "state") ?? throw new ApiException("没有拿到扫码会话");
var qrUrl = GetString(data.Value, "qrUrl")
?? $"/api/wechat-gateway/qrcode.svg?state={Uri.EscapeDataString(state)}";
return new WechatTicket(state, qrUrl);
}
/// 微信扫码登录:轮询一次(`GET /api/web/auth/wechat-gateway/login?state=&wait=`)
public async Task PollWechatLoginAsync(string state, int waitSeconds, CancellationToken ct = default)
{
var url = $"{BaseUrl}/api/web/auth/wechat-gateway/login?state={Uri.EscapeDataString(state)}&wait={waitSeconds}";
using var response = await SendAsync(
() => new HttpRequestMessage(HttpMethod.Get, url), "等待扫码", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
var status = GetString(data.Value, "status") ?? "pending";
if (status != "confirmed")
{
return new WechatPollResult(status, null, null, GetString(data.Value, "message"));
}
var token = GetString(data.Value, "token") ?? throw new ApiException("扫码确认了但没有令牌");
var user = ReadUser(data.Value);
var session = new Session
{
Token = token,
UserId = user.Id,
DisplayName = user.DisplayName,
ServerBaseUrl = BaseUrl,
};
return new WechatPollResult(status, session, user);
}
/// 拉图片字节(二维码用;`qrcode.gif` 返回 GIF,WPF 能直接显示)
public async Task GetImageAsync(string urlOrPath, CancellationToken ct = default)
{
var url = urlOrPath.StartsWith("http", StringComparison.OrdinalIgnoreCase)
? urlOrPath
: $"{BaseUrl}{urlOrPath}";
using var response = await SendAsync(() => new HttpRequestMessage(HttpMethod.Get, url), "下载二维码", ct)
.ConfigureAwait(false);
if (!response.IsSuccessStatusCode)
{
throw new ApiException($"二维码下载失败(HTTP {(int)response.StatusCode})", (int)response.StatusCode);
}
return await response.Content.ReadAsByteArrayAsync(ct).ConfigureAwait(false);
}
/// 校验令牌是否还有效(`GET /api/web/me`)
/// 令牌有效返回用户;**401/403 返回 null**(真失效,调用方可以清掉本地令牌)
public async Task MeAsync(string token, CancellationToken ct = default)
{
using var response = await SendAsync(() =>
{
var request = new HttpRequestMessage(HttpMethod.Get, $"{BaseUrl}/api/web/me");
request.Headers.TryAddWithoutValidation("Authorization", $"Bearer {token}");
return request;
}, "校验登录态", ct).ConfigureAwait(false);
if (response.StatusCode is HttpStatusCode.Unauthorized or HttpStatusCode.Forbidden) return null;
if (!response.IsSuccessStatusCode)
{
throw new ApiException($"校验登录态失败(HTTP {(int)response.StatusCode})", (int)response.StatusCode);
}
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, _) = ReadEnvelope(response, text);
return data is null ? null : ReadUser(data.Value);
}
// ==================== 主体 ====================
/// 我可进入的主体列表(`GET /api/web/subjects`)
public async Task> SubjectsAsync(string token, CancellationToken ct = default)
{
using var response = await SendAuthorizedAsync(HttpMethod.Get, "/api/web/subjects", token, 0, null, "读取主体", ct)
.ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
return ReadSubjects(data.Value, "list");
}
// ==================== 设备服务(本机作为扫码中控) ====================
/// 本主体已绑定的设备(开启前检查用;`GET /api/web/devices/active`)
public async Task> DevicesAsync(string token, int subjectId, CancellationToken ct = default)
{
using var response = await SendAuthorizedAsync(HttpMethod.Get, "/api/web/devices/active", token, subjectId, null,
"读取设备", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
var devices = new List();
if (data.Value.TryGetProperty("list", out var list) && list.ValueKind == JsonValueKind.Array)
{
foreach (var item in list.EnumerateArray())
{
devices.Add(new ApiDevice(
GetInt(item, "id"),
GetString(item, "sn") ?? string.Empty,
GetString(item, "name"),
GetString(item, "lastSeenAt")));
}
}
return devices;
}
///
/// 开启设备服务(`POST /api/web/devices/activate`,**仅主体管理员**)
///
/// 服务端保证「一个主体只有一台设备在线」:同主体其他设备的令牌会被作废(踢下线)。
///
public async Task ActivateDeviceAsync(
string token, int subjectId, string sn, string name, CancellationToken ct = default)
{
var payload = JsonSerializer.Serialize(new { sn, name }, Json);
using var response = await SendAuthorizedAsync(HttpMethod.Post, "/api/web/devices/activate", token, subjectId,
payload, "开启设备服务", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
var kicked = new List();
if (data.Value.TryGetProperty("kicked", out var kickedElement) && kickedElement.ValueKind == JsonValueKind.Array)
{
foreach (var item in kickedElement.EnumerateArray())
{
kicked.Add(new ApiDevice(GetInt(item, "id"), GetString(item, "sn") ?? string.Empty,
GetString(item, "name"), null));
}
}
return new DeviceActivation(
GetInt(data.Value, "id"),
GetString(data.Value, "sn") ?? sn,
GetString(data.Value, "name"),
GetString(data.Value, "token") ?? throw new ApiException("开启成功但没拿到设备令牌"),
GetString(data.Value, "tokenType") ?? "Bearer",
GetString(data.Value, "expiresIn"),
data.Value.TryGetProperty("firstTime", out var first) && first.ValueKind == JsonValueKind.True,
kicked,
GetString(data.Value, "refreshToken") ?? string.Empty,
GetString(data.Value, "refreshExpiresIn"));
}
///
/// 用刷新令牌换新的设备访问令牌(`POST /api/device/refresh`,无需用户登录)
///
/// 后台服务在访问令牌快到期/已 401 时调用;成功后**刷新令牌也会轮换**,必须覆盖保存。
///
public async Task RefreshDeviceTokenAsync(string sn, string refreshToken,
CancellationToken ct = default)
{
var payload = JsonSerializer.Serialize(new { sn, refreshToken }, Json);
using var response = await SendAsync(() =>
{
var request = new HttpRequestMessage(HttpMethod.Post, $"{BaseUrl}/api/device/refresh");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");
return request;
}, "刷新设备令牌", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
return new DeviceTokenRefresh(
GetString(data.Value, "sn") ?? sn,
GetString(data.Value, "token") ?? throw new ApiException("刷新成功但没拿到设备令牌"),
GetString(data.Value, "tokenType") ?? "Bearer",
GetString(data.Value, "expiresIn"),
GetString(data.Value, "refreshToken") ?? string.Empty,
GetString(data.Value, "refreshExpiresIn"));
}
/// 关闭设备服务(`POST /api/web/devices/:id/logout` → 令牌作废)
public async Task DeactivateDeviceAsync(string token, int subjectId, int deviceId, CancellationToken ct = default)
{
using var response = await SendAuthorizedAsync(HttpMethod.Post, $"/api/web/devices/{deviceId}/logout", token,
subjectId, "{}", "关闭设备服务", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
}
///
/// 设备心跳(`POST /api/scanner/heartbeat`):刷新服务端 `last_seen_at`,
/// 同时带回主体状态(`subject.expired`),上报循环据此暂停/恢复。
///
public async Task HeartbeatAsync(string deviceToken, CancellationToken ct = default)
{
using var response = await SendDeviceAsync("/api/scanner/heartbeat", deviceToken, "{}", "设备心跳", ct)
.ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, message) = ReadEnvelope(response, text);
if (data is null) throw Failure(response, text, message);
return new DeviceHeartbeat(
GetString(data.Value, "sn"),
GetDateTime(data.Value, "lastSeenAt"),
GetDateTime(data.Value, "serverTime"),
ReadSubjectState(data.Value));
}
///
/// 上传成片(分片,原始字节)
///
/// 用原始流而不是 base64:4MB 分片做 base64 会多 1.3MB,没有意义。
/// 用不限时的客户端:上行慢时单个分片可能超过 15 秒。
///
/// 已上传的总字节数
public async Task UploadEdgeFileAsync(string deviceToken, string uploadTaskId, string filePath,
CancellationToken ct = default)
{
const int chunkSize = 4 * 1024 * 1024;
await using var stream = File.OpenRead(filePath);
var total = stream.Length;
var buffer = new byte[chunkSize];
long sent = 0;
while (sent < total)
{
var read = await stream.ReadAsync(buffer.AsMemory(0, chunkSize), ct).ConfigureAwait(false);
if (read <= 0) break;
sent += read;
var last = sent >= total;
using var request = new HttpRequestMessage(HttpMethod.Post,
$"{BaseUrl}/api/scanner/tasks/{uploadTaskId}/upload?last={(last ? 1 : 0)}");
request.Headers.TryAddWithoutValidation("Authorization", $"Bearer {deviceToken}");
request.Content = new ByteArrayContent(buffer, 0, read);
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
using var response = await LongPollHttp.SendAsync(request, ct).ConfigureAwait(false);
if (!response.IsSuccessStatusCode)
{
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
throw new ApiException($"上传分片失败(HTTP {(int)response.StatusCode}):{text}");
}
}
return sent;
}
/// 跨网下载任务状态
public sealed record EdgeDownloadStatus(string State, long Size, string? Error, string? ScannerSn);
///
/// 创建跨网下载任务(`POST /api/web/edge/download`)
///
/// 云端让能访问 NVR 的设备去拉流合并、传回中转;这里只拿到任务 id。
///
public async Task<(string State, string? TaskId, string? Message)> EdgeDownloadCreateAsync(
string token, int subjectId, string code, CancellationToken ct = default)
{
using var response = await SendAuthorizedAsync(HttpMethod.Post, "/api/web/edge/download",
token, subjectId, JsonSerializer.Serialize(new { code }), "云端下载录像", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, _) = ReadEnvelope(response, text);
if (data is null || data.Value.ValueKind != JsonValueKind.Object) return ("unknown", null, null);
return (GetString(data.Value, "state") ?? "unknown",
GetString(data.Value, "taskId"),
GetString(data.Value, "message"));
}
/// 查跨网下载进度
public async Task EdgeDownloadStatusAsync(string token, int subjectId, string taskId,
CancellationToken ct = default)
{
using var response = await SendAuthorizedAsync(HttpMethod.Get,
$"/api/web/edge/download/{Uri.EscapeDataString(taskId)}", token, subjectId, null,
"查云端下载进度", ct).ConfigureAwait(false);
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, _) = ReadEnvelope(response, text);
if (data is null || data.Value.ValueKind != JsonValueKind.Object) return null;
return new EdgeDownloadStatus(
GetString(data.Value, "state") ?? "",
data.Value.TryGetProperty("size", out var size) && size.TryGetInt64(out var parsed) ? parsed : 0,
GetString(data.Value, "error"),
GetString(data.Value, "scannerSn"));
}
/// 把云端中转的成片取回本地(整文件;要断点续传再按需求加 Range)
public async Task DownloadEdgeFileAsync(string token, int subjectId, string taskId, string savePath,
CancellationToken ct = default)
{
using var request = new HttpRequestMessage(HttpMethod.Get,
$"{BaseUrl}/api/web/edge/download/{Uri.EscapeDataString(taskId)}/file");
request.Headers.TryAddWithoutValidation("Authorization", $"Bearer {token}");
request.Headers.TryAddWithoutValidation("X-Subject-Id", subjectId.ToString());
using var response = await LongPollHttp.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, ct)
.ConfigureAwait(false);
response.EnsureSuccessStatusCode();
var dir = Path.GetDirectoryName(savePath);
if (!string.IsNullOrEmpty(dir)) Directory.CreateDirectory(dir);
await using var source = await response.Content.ReadAsStreamAsync(ct).ConfigureAwait(false);
await using var target = File.Create(savePath);
var buffer = new byte[81920];
long total = 0;
while (true)
{
var read = await source.ReadAsync(buffer, ct).ConfigureAwait(false);
if (read == 0) break;
await target.WriteAsync(buffer.AsMemory(0, read), ct).ConfigureAwait(false);
total += read;
}
await target.FlushAsync(ct).ConfigureAwait(false);
return total;
}
/// 云端校验结论
/// ok / no-plan / no-device / no-credential
/// true/false 可用;null 表示云端也判断不了
/// 试拉到的帧数(SDK 路径不数帧,为 -1)
public sealed record EdgeCheckOutcome(string State, bool? HasVideo, int Frames, string? Message, string? ScannerSn);
///
/// 边缘任务(跨公司取流用):云端入队,设备主动出站领取
///
/// 任务 id(回结果时带上)
/// check / download
/// 任务参数(原样交给 worker)
public sealed record EdgeTask(string Id, string Type, JsonElement Payload);
///
/// 领任务(长轮询)
///
/// ⚠️ 不能用共享的 Http:它的超时是 15 秒,会把 20 秒的长轮询直接掐断
/// (现象是"任务永远要等到下一轮才到")。这里单独用不限时的客户端。
///
public async Task PollEdgeTaskAsync(string deviceToken, int waitSeconds,
CancellationToken ct = default)
{
var wait = Math.Clamp(waitSeconds, 1, 25);
using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
timeout.CancelAfter(TimeSpan.FromSeconds(wait + 15));
using var request = new HttpRequestMessage(HttpMethod.Post,
$"{BaseUrl}/api/scanner/tasks/poll?wait={wait}");
request.Headers.TryAddWithoutValidation("Authorization", $"Bearer {deviceToken}");
HttpResponseMessage response;
try
{
response = await LongPollHttp.SendAsync(request, timeout.Token).ConfigureAwait(false);
}
catch (OperationCanceledException) when (!ct.IsCancellationRequested)
{
// 本次挂起被网络/反代掐断:当作"没有任务",下一轮再领
return null;
}
catch (HttpRequestException ex)
{
throw new ApiException($"无法连接服务器({BaseUrl}):{ex.Message}");
}
using (response)
{
if (response.StatusCode == HttpStatusCode.NoContent) return null;
var text = await response.Content.ReadAsStringAsync(ct).ConfigureAwait(false);
var (data, _) = ReadEnvelope(response, text);
if (data is null || data.Value.ValueKind != JsonValueKind.Object) return null;
var id = GetString(data.Value, "id");
var type = GetString(data.Value, "type");
if (string.IsNullOrWhiteSpace(id) || string.IsNullOrWhiteSpace(type)) return null;
var payload = data.Value.TryGetProperty("payload", out var element) ? element : default;
return new EdgeTask(id!, type!, payload);
}
}
///
/// 回任务结果(失败不抛:结果丢了顶多让查询机超时,不该影响扫码链路)
///
public async Task SubmitEdgeTaskResultAsync(string deviceToken, string taskId, object result,
CancellationToken ct = default)
{
try
{
var body = JsonSerializer.Serialize(result);
using var response = await SendDeviceAsync($"/api/scanner/tasks/{taskId}/result",
deviceToken, body, "回传边缘任务结果", ct).ConfigureAwait(false);
if (!response.IsSuccessStatusCode)
{
AppLog.Write($"[edge] 回传任务 {taskId} 结果失败:HTTP {(int)response.StatusCode}");
}
}
catch (Exception ex)
{
AppLog.Write($"[edge] 回传任务 {taskId} 结果异常:{ex.Message}");
}
}
/// 解析心跳里的 `subject`(老服务端没有这个字段时返回 null)
private static DeviceSubjectState? ReadSubjectState(JsonElement data)
{
if (!data.TryGetProperty("subject", out var subject) || subject.ValueKind != JsonValueKind.Object) return null;
return new DeviceSubjectState(
GetInt(subject, "id"),
GetString(subject, "name"),
GetInt(subject, "status"),
GetDateTime(subject, "expireAt"),
subject.TryGetProperty("expired", out var expired) && expired.ValueKind == JsonValueKind.True,
subject.TryGetProperty("disabled", out var disabled) && disabled.ValueKind == JsonValueKind.True,
GetLong(subject, "remainingSeconds"));
}
///
/// 上报通道(设备令牌;`POST /api/scan/channels`)。
/// `replace = true` = 全量对账:服务器会软删本中控下不在列表里的旧通道,并解绑工作台。
///
public async Task ReportChannelsAsync(string deviceToken, IEnumerable<(string ChannelId, string ChannelName)> channels,
bool replace = false, CancellationToken ct = default)
{
var rows = new List