Azure Kinect Viewer：体感展项调试的第一个窗口

它到底解决什么

体感互动展项——观众站在屏幕前，挥手、走动、做动作，画面跟着反应——依赖的是深度相机：一种既能看到画面、也能测出每个像素距离的相机。

这类展项现场调试时，故障现象几乎总是同一句话："站上去没反应。"

这句话背后可能是完全不同的原因：

• 相机没通电或者 USB 没识别；
• 相机在工作，但装的位置不对，观众根本不在它的视野里；
• 相机看得到人，但现场有反光地面、玻璃、或者强光，深度数据是乱的；
• 相机和数据都正常，是互动程序的识别逻辑或参数问题。

这四种的处理方式完全不同，而不打开查看器的话，你分不清是哪一种。现场的常见做法是直接去调互动程序的参数，调半天没用，因为问题根本不在那。

Azure Kinect Viewer 是微软 Azure Kinect 开发工具包里带的查看器工具。它做的事很简单：把相机当前看到的东西显示出来——彩色画面、深度画面，以及在支持的场景下人体骨骼的识别结果。

有了这个窗口，判断就变得直接：能看到人、深度画面正常、骨骼识别出来了 → 相机侧没问题，去查程序；看不到人或者深度画面一片混乱 → 问题在相机、安装或环境上。

展厅哪道工序会用到它

安装定位时确定相机位置。 这是最该用它的一步，而且应该在打孔固定之前用。做法是：把相机临时架在计划的位置，打开查看器，让人在展项区域里走动，看覆盖范围够不够、有没有死角、观众常站的位置深度数据是否稳定。位置确认了再固定。

跳过这一步、按图纸直接固定的后果是：装完发现覆盖不对，要重新打孔——而展厅的墙面和吊顶往往是精装完成面，重新打孔的代价不只是麻烦。

现场排障的第一步。 前面讲透了。

环境影响的确认。 深度相机对环境敏感——地面反光、大面积玻璃、直射的强光、以及某些材质的表面，都可能让深度数据出错。这些问题在查看器的深度画面上是看得见的（表现为空洞、噪点、跳变），而在互动程序里只会表现为"识别不准"。

验收前的稳定性确认。 让相机连续工作几小时，间歇性地看数据是否稳定。深度相机长时间运行有发热问题，个别情况下会影响数据质量。

怎么获取

微软官方文档站：Azure Kinect DK 文档。查看器随开发工具包一起提供，按官方文档的说明获取和安装。

关于硬件的供应状态，请以微软官方的信息为准——本站不对硬件产品的销售与支持状态作断言，因为这类信息会变化。如果你在做新项目的选型，硬件能不能买到、后续能不能维保，这是必须在方案阶段确认的事，不要假设。

最短可用路径

1. 按官方文档装好驱动和工具包。
2. 相机接电、接 USB。USB 的供电和带宽都要够——深度相机的数据量不小，接在扩展坞或者劣质延长线上是常见的故障源。
3. 打开查看器，选择相机。
4. 先看彩色画面：能看到画面说明相机在工作。
5. 再看深度画面：正常的深度画面应该是平滑的层次，能清楚区分人和背景。如果满屏噪点、大片空洞、或者数值乱跳，那是环境或安装的问题。
6. 让人走进画面，看在观众实际会站的位置上，深度数据是否稳定、骨骼是否能识别出来。
7. 确认覆盖范围的边界——走到哪里就检测不到了。

展厅工程里真正要改的那几个设置

安装高度和俯仰角决定一切。 深度相机有它的视场角和有效距离范围，这两项决定了它能覆盖多大的区域。装得太高俯角太大，观众近处会出画；装得太低，远处的人会被前面的人挡住。这些参数在查看器里边看边调是最快的方式。

观众的活动区域要标出来。 相机的有效范围往往小于展项的物理区域。如果观众走出了有效范围但展项还应该有反应，那就是设计问题，要在方案阶段解决（加相机、缩小区域、或者加地面引导标识让观众站在对的位置）。

地面材质要留意。 高反光的地面（抛光石材、玻璃）会让深度数据出错。这一条要在装修阶段就提出来——地面材质定了之后再来说这个问题就晚了。

USB 线材和供电别省。 深度相机对 USB 链路的要求比普通设备高。用劣质延长线或者接在拥挤的扩展坞上，表现是间歇性断连——这类故障非常难查，因为它时有时无。

环境光要控制。 深度相机的工作原理决定了它可能受某些光源干扰。展厅的灯光设计如果有直射到相机的强光，要调整。

踩坑与排错清单

什么时候别用它

别的深度相机别用它。 各家有各家的 SDK 和工具。

互动逻辑的问题别用它查。 它显示原始数据，不管你的程序怎么用这些数据。判断标准：如果查看器里一切正常，问题就不在它管的范围里，去看 TouchDesigner 或展项程序那一侧。

别把它留在展厅长期运行。 它是调试工具。展项运行时应该跑的是展项程序，查看器占着相机会导致程序拿不到数据。

别用它判断体验好坏。 数据正常不代表展项好玩。互动的响应速度、识别的宽容度、引导是否清晰，这些要靠人实际站上去试，而且最好找没参与开发的人来试。

与本站方案的衔接

体感展项跟雷达展项有同一个问题：坏了不报警，只是变得不好玩。相机断连、识别变差、覆盖偏移，观众不会投诉，只会走开。而这种"沉默的故障"往往持续很久才被发现。

企服君在互动展项的运维上，把感知设备的在线状态和数据活跃度纳入监控，让这类问题在发生时就被发现。集成商如果交付的展厅里体感和雷达类展项占比高，这层监控的价值远大于它的实现成本——见集成商年费方案。

互动展项没触发的完整排查见互动展项没触发怎么查；互动引擎的取舍见互动展项引擎六选一。