NDI 拉取时重复返回同一帧，怎样区分 FrameSync 补帧与新画面

FrameSync的一次有效返回不一定代表收到一幅新画面。拉取时钟与输入时钟不同，帧同步器可能重复上一帧；从未收到视频时还可能返回零结构。应分别统计调用次数、有效描述次数和唯一内容身份，不能把它们都记成输入帧率。

先固定输入与适用条件

本例是离线的调用结果分类，不启动NDI FrameSync，也不用合成统计推断网络质量。输入包含首次空描述、重复帧ID及新帧ID；ID仅用于夹具辨认，不是NDI自带的标准帧序号。实际程序需要选择可解释的内容标识或时间字段，并说明源本身重复画面的可能性。

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

按字段与边界执行

1. 先检查返回描述是否有有效宽高与数据，再决定是否进入渲染路径。尚无首帧时显示明确定义的等待画面，避免访问空指针或把它当黑场内容。

2. 为每次拉取记录调用时刻和有效性，把渲染次数与新内容次数分成两列。重复返回可以是正常重定时行为，不应立即发出丢包告警。

3. 用夹具中的帧ID比较相邻返回，标出重复、新内容和空返回。若只靠图像hash，必须承认静止画面会有相同hash，不能借此证明源没有发送新帧。

4. 现场分析时加入实际输入统计与输出时钟参数。需要判断网络丢帧时另采接收证据，FrameSync后的重复次数不能独立定位问题发生在哪一段。

用具体样例核对结果

合成序列依次为无有效图像、A、A、B、C，共五次拉取，四次有效图像返回，三种内容身份，其中一次重复A。脚本对此分别计数，并拒绝把第一个空描述算作新帧。结果用名称明确区分pull_calls、valid_returns和unique_content_ids；没有把三除以某个任意时长写成真实NDI帧率。

本例通过说明分类规则能处理首帧未到及重复内容，不能说明目标应用已经正确使用FrameSync。重复太多还可能来自源静止、显示时钟重定时或上游阻塞，需要更多证据。程序如果同时从绑定的接收器直接抓视频和从FrameSync拉视频，还应依官方生命周期说明复核调用关系，不能把两个消费路径的统计混加。

下载与复现

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

输入是带有效尺寸的调用序列，结果保存每次分类和总计。交接时附时钟驱动方式、实际SDK版本与首帧策略；相机验收多屏同步属于另一个测试任务，不以本例三个内容ID替代。

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

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

对接下一步与一级来源

基础背景可看多屏同步验收怎样拍：用帧号样片记录偏差与测量限制。相关流程收在多媒体播放专题；需要项目对接时，带上本文输入及结果向SoftPlayer核对实际能力。

• 拉取可能重复帧，无首帧时返回零结构。

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