NDI 附带 XML 标签读不全，怎样核对 UTF-8 字节长度与终止符

XML读不全时，先核对UTF-8字节数与NUL终止，不能拿字符串字符数代替缓冲长度。NDI元数据可以承载自定义XML，但某个标签的意义由应用约定；能够正确解析XML，不代表接收软件会执行其中的动作。

先固定输入与适用条件

本题区分独立metadata frame与视频、音频帧附带的p_metadata。独立帧有length字段；附带字符串必须按接口约定终止，不能把两种结构混为一谈。例子中的exhibit和caption都是原创标签，没有设备命令语义，不含客户名称或任何凭据；中文用于验证UTF-8多字节差异。

本篇按NDI官方滚动SDK文档解释视频v2或音频v3帧描述。文档核对日期为2026-10-24；这不是本地已安装NDI运行库的版本声明，设备与第三方软件需另录版本。

按字段与边界执行

1. 先声明使用哪一种结构，保存原始XML字节与字段来源。若上层只给出一个解码后的字符串，要求另外保留原始长度，避免解码库已掩盖截断。

2. 把XML按UTF-8编码，计算实际数据字节数，并检查结尾NUL。对于独立元数据帧，按接口要求设置length；本例显式长度包含终止符，避免依赖隐式计算。

3. 做一次完整XML解析，再把声明长度故意改成字符数，检查截断反例。错误可能发生在多字节字符中，也可能发生在结束标签，不能只看开头文字可读。

4. 与接收应用明确标签名、命名空间和未知标签处理方式。若需要确认某条元数据被消费，应有应用层日志；NDI传输成功不能代替业务确认。

用具体样例核对结果

样例为带中文“展项甲”的XML，Python分别输出Unicode字符数、UTF-8数据字节数以及加终止符后的缓冲长度。正确数据可完整解析，按字符数截取的反例不能通过XML解析。附件同时保留hex，便于在不依赖终端字体的情况下核对字节。length为零时的自动长度行为应按官方接口理解，不能拿零当作已证明没有元数据。

判断条件包括UTF-8可解码、终止边界符合接口、XML结构完整、接收应用明确识别或忽略自定义标签。任何一项未知都应独立列出，不要以“XML是合法的”覆盖业务未接入。若第三方应用要求固定schema，应使用它的公开版本规则；本题不会把这份自定义标签伪装成通用NDI字幕协议。

下载与复现

analyze.py、input.json、result.json。

下载输入、解析器和结果后可重复检查字符与字节差异。交付真实项目时，把XML schema约定及脱敏原始hex放在同一证据包，注明独立帧还是附带元数据，避免后续开发接错结构。

把输入与脚本保存到同一个本地目录后执行 python analyze.py，脚本只读取输入、计算并重写同目录的结果文件。先保留原始附件副本，再将自己的脱敏输入另存为新版本，记录输入摘要与执行日期；不要把合成字段覆盖成看似真实的现场日志。

已用 Python 3.12.4 实际运行附件算法并检查断言。结果来自同目录合成输入；没有接入真实NDI源、控制器、灯具、接收卡或LED屏，不能据此填写现场验收通过。

对接下一步与一级来源

基础背景可看NDI 网络视频传输协议详解。相关流程收在多媒体播放专题；需要项目对接时，带上本文输入及结果向SoftPlayer核对实际能力。

• 元数据帧length和NUL终止XML；帧内元数据须UTF-8。

一级来源核对日期：2026-10-24。原始协议规则、本文原创运算和目标系统行为应分别留证；附件计算正确，不等于设备已经按该参数工作。