Q10.NDI Analysis 专业NDI视频流分析工具使用指南

NDI Analysis.exe 专业网络视频流分析工具使用指南

文档目的

本文档旨在帮助您掌握 NDI Analysis.exe 工具的使用方法 ，通过命令行实现对本地网络中 NDI 信号源的快速发现、性能诊断及数据导出。

适用产品/版本：所有支持NDI编码的千视设备；

适用环境：安装有 NDI Tools 的 Windows 系统 。

问题现象与适用场景

当您遇到以下情况时，可参考本文：

• 需要确认当前局域网内存在哪些 NDI 信号源及其 IP 地址 。
• NDI 视频流出现卡顿、丢帧，需要分析传输性能指标（如 Video recv 延迟） 。
• 需要导出音视频帧的详细编解码数据进行深度故障排查

解决方案

步骤 1：启动工具

在 Windows“开始”菜单搜索 “NDI Analysis” 并运行命令行程序 。

步骤 2：发现网络中的信号源

通过以下命令扫描网络中的 NDI 设备 ：

基础扫描：NDIAnalysis.exe /find（列出所有可用信号源） 。

持续监控：NDIAnalysis.exe /find /time:5（扫描 5 秒并显示新出现的源） 。

按组筛选：NDIAnalysis.exe /find "Cameras"（仅列出特定组的信号源） 。

步骤 3：诊断指定信号源性能

针对特定源进行详细分析（需替换 My Source 为实际名称） ：

• 全面诊断：NDIAnalysis.exe /source:"My Source (Channel 1)" 。
• 限时诊断：添加 /time:120 参数进行 2 分钟持续检测 。
• 专项检测：使用 /videoonly 或 /audioonly 仅诊断视频或音频部分 。

步骤 4：高级分析与数据导出

帧错误检测：使用 /framecheck 分析视频帧编解码错误 。

导出 CSV：使用 /csv:"filename.csv" 将详细帧数据导出，便于后续分析 。

诊断结果解读

1、NDIAnalysis.exe /find回显主要信息字段

• 名称（Name）：括号内为具体视频通道，同一设备可能有多个通道
• Host（IP地址）：显示NDI源设备的本地网络IP地址，用于确认设备在网络中的位置和可达性
• Type（流类型）：标识为"NDI"
• Port（端口）：显示NDI源的监听端口号

2、NDIAnalysis.exe /source回显主要字段

• 14:21:57.759-764：视频/音频接收器创建成功，视频/音频连接已建立
• 14:21:57.769：源设备信息：NDI版本：6.2.0.3，平台：Linux，控制接口：http://192.168.28.86
• 14:21:57.791：分辨率：1920x1080、编码：SpeedHQ Mode 7 + Alpha，帧率：25.00 fps（Progressive逐行扫描、Interlaced隔行扫描）、宽高比：16:9 (1.78)
• 14:22:02.769 & 14:22:07.776：视频传输性能指标，我们一般只看Video recv（接收）的平均值来判断是否丢帧，计算方式如下：

如帧率60，那么1000ms产生60帧，每毫秒产生1000/60=16.66帧，因此可以计算出丢一帧会变成1000/59=16.9帧，一帧内都是正常标准，超过16.9则说明丢了一帧以上

根因分析

无