packServer/backend/app/lib/virtual-channel.js
liufumingren 2ed4fa8483 feat(workstation): 一台工作台支持多路面单摄像头 + 绑定管理可改画布尺寸
- 面单摄像头不再限制一台工作台一路:设置新的不清旧标记,取消最后一路时才清理虚拟通道
- 面单识别配置按 工作台+摄像头 逐路下发,多路共用上报通道;多路时虚拟通道名改用工作台名
- 绑定管理新增画布尺寸(宽×高)编辑:160~7680、自动取偶数;改尺寸时已摆放摄像头按比例缩放
- 画布组件在宽度变化时重新计算等比缩放,避免新画布溢出或缩不满
- 补充后端单测与相关文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-08 23:45:25 +08:00

34 lines
1.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 「纯摄像头工作台」的虚拟扫码通道
*
* 背景:扫码记录的上报结构是「中控 + 通道」,回放定位靠 `scanner+channel → 工作台`
* 反查快照(`pack.snapshotMap`)。工作台只设了面单摄像头、没接扫码枪时,
* 识别结果没有通道可挂 → 这里给它一条虚拟通道 `CAM-<工作台id>`,
* 名字是「面单摄像头·<摄像头名>」(多路时「面单摄像头·<工作台名>」),整条链路(上报、落库、回放定位、安卓播报)都不用特殊处理。
*
* 约定:
* - 前缀固定 `CAM-`,和设备上报的真实通道(纯数字 / `DESKTOP`)不会冲突;
* - 虚拟通道**只由服务端维护**,设备端全量对账(`replace: true`)时必须豁免;
* - 工作台取消最后一路面单摄像头 / 改绑真实通道时,由 `workstation` 服务清理掉。
*/
const VIRTUAL_CHANNEL_PREFIX = 'CAM-';
/** 工作台 id → 虚拟通道 id */
function virtualChannelIdOf(workstationId) {
return `${VIRTUAL_CHANNEL_PREFIX}${Number(workstationId) || 0}`;
}
/** 是否为虚拟通道 id */
function isVirtualChannelId(channelId) {
return String(channelId || '').toUpperCase().startsWith(VIRTUAL_CHANNEL_PREFIX);
}
module.exports = {
VIRTUAL_CHANNEL_PREFIX,
virtualChannelIdOf,
isVirtualChannelId,
};