从画面到 results.xml，再到金陵设备接入
两篇操作指南：OCR 快速开始覆盖画面识别的完整流程与排查；金陵设备接入指南覆盖当前界面开放的金陵来源配置与排查。
从画面到 results.xml：六步完成 OCR 输出
适用于本地视频、摄像机或 SRT 画面。开始前先确认目标数字或文字清晰可见，并准备好最终需要的字段名称。
- 1
选择画面来源。在「接入」菜单中打开本地视频、选择 1–3 路摄像机，或配置 SRT 视频流。
- 2
添加识别字段。在「OCR识别」中添加数字、时间或文本字段，并把字段名改成下游系统容易理解的名称。
- 3
框选目标区域。在主画布中只框住需要识别的内容；多机位时，先切换到目标摄像机再创建字段。
- 4
校正和预处理。斜拍时设置透视；根据画面选择二值化、阈值、滤波、开运算、膨胀或人工切线。
- 5
设置无结果策略。短暂遮挡时希望保持数值，选择「保留上次」；希望画面消失后输出为空，选择「清空」。
- 6
开始识别并输出。观察字段当前值，再选择 XML、CSV、Excel 或「开启局域网导出接口」，复制 results.xml 地址给后续系统。
成功标志：不要只看「开始识别」
- ✓字段裁剪预览与目标内容一致，没有包含多余数字或强干扰区域。
- ✓当前值随画面中的一次可控变化而更新。
- ✓多机位字段仍从各自绑定的摄像机取图。
- ✓无结果时的行为符合「保留上次」或「清空」设置。
- ✓XML、CSV、Excel 或 results.xml 中的字段名和当前值正确。
vMix 读取方式
先在本软件中开启局域网 results.xml；再在 vMix Data Sources Manager 中添加 XML 数据源并填写该地址，最后在 Title 的 Data Source 中选择对应字段。vMix 与本软件同机可使用 127.0.0.1；不同电脑使用本机局域网 IP，并确认防火墙放行。
常见排查
画面有内容但识别为空
检查框选是否准确、字符是否清晰、字段类型是否正确，以及二值化是否让笔画断裂或粘连。
识别值短暂跳空
根据下游需要调整「无结果」策略；同时检查遮挡、反光和摄像机曝光。
切换摄像机后找不到原字段
字段绑定到创建时的摄像机。先切回该机位，再检查和修改框选区域。
results.xml 无法访问
检查导出接口是否已开启、端口是否占用、防火墙是否放行，以及访问设备与本机是否在可通信网络中。
SRT 没有画面
核对 Listener/Caller 角色、地址、端口、延迟、Stream ID、口令和密钥长度，并先验证发送端确实在推流。
金陵计时与计分来源
用于接入当前版本可选的金陵 2012、2016、2022、2023 计时系统、CBA ball game 计分协议和金陵篮球比赛打分软件。不同场馆的串口转换设备、网段和连接方向可能不同，参数以现场接口为准。
| 当前来源 | 接入方式 | 当前字段范围 | 说明 |
|---|---|---|---|
| 金陵 2012 | 串口或受支持的网络链路 | 比赛时间、进攻时间 | 常用波特率 9600；以现场转换设备为准。 |
| 金陵 2016 / 2022 / 2023 | 串口或受支持的网络链路 | 比赛时间、进攻时间 | 常用波特率 19200；以现场接口为准。 |
| CBA ball game 计分协议 | UDP 监听 | 节次、比分、犯规、暂停、队伍、比赛与球员数据 | 默认端口 16868；不把分节比分作为该来源字段。 |
| 金陵篮球比赛打分软件 | UDP 监听 | 队名、节次、比分、犯规、暂停、球员名单和上场状态 | 默认端口 14400 |
连接前确认
- ✓确认设备准确型号，以及使用的是计时器帧、CBA ball game 计分协议还是篮球比赛打分软件。
- ✓确认电脑与设备处于可通信环境，串口没有被其它程序占用，网络设备的 IP、端口和连接方向明确。
- ✓确认本场需要的字段：比赛时间、进攻时间、节次、比分、犯规、暂停、队名、名单或球员状态。
- ✓确认现场有一次可控的测试变化，用于核对接收、比赛控制和 XML 输出。
在「设备接入」中完成配置
- 1
打开「设备接入」，新建来源。
- 2
选择与现场一致的金陵型号和连接方式。
- 3
填写串口、主机/IP 或端口等当前连接参数，保存来源。
- 4
如果同时使用计时与计分来源，在字段组/来源规则中指定各字段组的来源；保持自动时，软件按来源能力选择。
- 5
启动来源，观察连接状态、最近数据、诊断信息和接收事件。
- 6
回到「比赛控制」，核对该来源实际提供的比赛时间、进攻时间、节次、比分、犯规、暂停和球员字段。
- 7
如需比赛 XML，打开导出窗口，核对本地文件或网络地址中的一次测试变化。
成功标志：数据、比赛控制和输出都要一致
- ✓最近有效数据持续更新，不只是界面显示「已连接」。
- ✓来源提供的字段与现场状态一致；未提供的字段不以空值猜测。
- ✓多来源场景中，各字段组来自预期来源，没有相互覆盖。
- ✓「比赛控制」中的手动/自动模式符合现场操作安排。
- ✓一次测试变化能够反映到需要使用的 XML 文件或网络地址。
按状态逐层排查
没有可用串口或没有建立网络连接
确认电源、线缆、串口驱动、网段、防火墙、端口占用和连接方向。
已连接但没有原始数据
确认设备或软件正在发送，所选型号、波特率、端口和接收角色与现场一致。
有原始帧但没有有效字段
检查所选金陵型号或计分协议是否匹配；保存诊断与原始帧后再调整。
字段有值但与现场不符
先核对原始数据和来源用途，再检查主客队方向、节次和当前比赛上下文。
接收任务反复重试
查看诊断中的最近事件和重试状态，排查设备断开、端口释放和网络中断。
提交支持材料：请提供设备型号、连接方式、现场接口参数、来源用途、问题发生时间、诊断信息和原始帧/Hex。截图或日志中如包含口令、密钥或其它敏感信息，请先移除。