reacTIVision：桌面互动展项的标记识别怎么做

它到底解决什么

展厅里有一类很受欢迎的展项：一张互动桌面，观众把一个实物（一个模型、一块牌子、一个道具）放到桌上，桌面上就出现对应的内容；挪动它，内容跟着走；转动它，内容跟着转。

这类展项的技术核心是识别桌上有什么、在哪、朝向如何。实现路径有几条：

• RFID / NFC：在道具里埋标签，桌面下埋读卡器。识别可靠，但位置精度低、成本随点位增加、且改动困难；
• 专用识别硬件：成本更高；
• 摄像头加标记码：在道具底部贴一张特殊图案的标记，摄像头从桌面下方（或上方）拍，靠图像识别算出是哪个标记、在什么位置、转了多少度。

第三条路成本最低——一个摄像头加打印的标记纸。reacTIVision 就是走这条路的开源工具（GPL-3.0）：它处理摄像头画面，识别出画面里的标记，然后把结果按 TUIO 协议发出去。

TUIO 是一个专门用于桌面互动的开放协议，基于 OSC。互动引擎（TouchDesigner、Chataigne 等）都能接收 TUIO 数据。所以整条链路是：

摄像头 → reacTIVision 识别标记 → TUIO 数据 → 互动引擎 → 画面反应

这个分层的好处是：识别这一环是独立的、可替换的、可单独调试的。展项没反应时，先看 reacTIVision 有没有识别出标记，就能把责任链切开。

展厅哪道工序会用到它

方案阶段的可行性验证，这一步最关键。 摄像头方案能不能做成，决定因素是光照，而不是软件。做法是：在接近实际的光照条件下搭一个临时测试——摄像头、一张标记、一台笔记本，看识别稳不稳。这个测试必须做在方案确定之前，因为如果现场光照条件不支持，整个方案要换。

桌体结构设计阶段的配合。 摄像头装在哪、距离多远、桌面材质是什么（背投式的要透光但要匀）、桌内的补光怎么做——这些是桌体结构设计的一部分，要在做桌子之前定。做完桌子再来调摄像头位置，往往改不动。

标记设计与制作。 标记的尺寸、印刷质量、贴在道具上的位置，都影响识别率。

现场调试与标定。 摄像头视野与桌面显示区域的坐标对应关系要标定。

怎么获取

项目主页 reactivision.sourceforge.net，开源免费，三大平台都有。

它使用的标记图案（fiducial marker）有配套的标记集，官网提供，打印出来即可用。

最短可用路径

1. 接好摄像头，运行 reacTIVision。
2. 软件会显示摄像头的实时画面和识别结果。
3. 先调摄像头本身的参数：对焦、曝光、增益。这一步比软件参数更重要——画面不清楚，后面调什么都没用。
4. 把标记放进画面，看能不能识别出来（识别到的标记通常会被标注出编号和方向）。
5. 调整识别参数（阈值之类），让识别在实际光照下稳定。
6. 标定坐标映射：摄像头看到的画面坐标和桌面显示的画面坐标要对应起来，这样标记的物理位置才能对应到画面的正确位置。
7. 确认 TUIO 数据在往外发，接收端（互动引擎）能收到。

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

光照是这类方案的命门，值得单独说。

摄像头识别依赖画面对比度。展厅里的挑战有几个：

• 环境光变化：白天和晚上、开灯和关灯、附近展项的动态灯光，都会改变桌面的光照条件。而识别参数通常是按某一种条件调好的，条件一变识别率就掉。
• 不均匀：桌面一边亮一边暗，暗的那边识别不到。
• 反光和阴影：观众的手和身体会在桌面上投下阴影，遮住标记。

对策是主动控光：桌体内部做均匀的补光（通常用红外补光加红外摄像头，这样可见光的变化不影响识别），而不是依赖环境光。这是专业做法，也是这类展项能不能长期稳定的分水岭。方案阶段就要把这部分成本算进去。

标记要做耐用。 观众会反复拿放道具，标记会磨损、会被摸脏、会翘边。贴纸打印的标记撑不了多久。正式交付应该用耐磨的工艺，并且准备备用道具——道具丢失和损坏在展厅里是必然事件，要有补充方案。

标定参数要备份。 坐标映射的标定结果要保存并写进文档。摄像头被碰了、换了，要能快速重新标定。

识别参数要在展厅实际条件下调。 办公室调好的参数拿到现场基本要重调，因为光照完全不同。

踩坑与排错清单

什么时候别用它

不能贴标记的场合别用它。 它识别的是标记码，不是物体本身。如果需求是"把任意实物放上去都能认出来"，那是完全不同的技术路线（图像识别、AI 视觉），成本和难度都高一个量级。

光照不可控的开放区域别用它。 前面讲透了。如果展项在开放大厅、旁边有大窗户、或者有动态灯光秀，摄像头方案的稳定性会成为长期困扰。这种情况下 RFID 方案虽然位置精度低，但可靠性高得多。

高精度定位别用它。 摄像头方案的精度受分辨率、镜头畸变、标定质量影响。需要毫米级精度的场合要另想办法。

主展项要谨慎。 C 位展项一旦不稳定，甲方的容忍度很低。这类方案更适合体验型、趣味型的辅助展项。

与本站方案的衔接

标记识别展项的稳定性，本质上取决于一堆现场条件：光照、桌体结构、道具耐用度、摄像头位置。这些条件在交付时都是好的，之后会缓慢劣化——灯泡变暗、标记磨损、摄像头被碰偏。

而这类劣化的表现是"识别率下降"，观众感受到的是"这个展项反应迟钝"，不会有任何报警。企服君在互动展项运维上的做法是把识别成功率这类业务指标也纳入采集，让劣化趋势可见。集成商如果交付的展项里有这类对现场条件敏感的方案，配套的监控和定期巡检应该写进服务内容——见集成商年费方案。

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