TUIO 协议与互动引擎对接

本文限定TUIO 1.1的/tuio/2Dcur对接。先证明正确Profile的OSC数据抵达接收端，再核对坐标和触点生命周期。TUIO 2.0、对象Profile与自定义扩展不能混用本页字段；具体库、端口与版本以设备和接收库说明为准。

服务端、网络和引擎分开观察

记录跟踪软件版本、接收库、目标IP、实际监听端口和进程。3333是常见端口，不能假定现场未改。先在可控同机环境验证，再跨机核对监听地址、允许来源与实际报文。UDP发送成功只说明本机接受了发送请求，不证明对端收到或解析成功。

TUIO建立在OSC之上，实际报文是带类型标记和对齐的二进制消息束。下面文本用于解释字段，不能把这一行UTF-8直接发往端口冒充OSC：

/tuio/2Dcur set 7 0.2 0.3 0.0 0.0 0.0
/tuio/2Dcur alive 7
/tuio/2Dcur fseq 100

set的参数依次为会话ID、x/y、X/Y速度与运动加速度。alive列出该帧仍存在的会话。fseq标记帧序，用于按接收库策略辨认新旧、重复或缺帧；它不重传丢失包，也不保证恢复所有输入，更不是“丢包兜底机制”。

可以离线解析的最小生命周期

合成帧	alive	set位置	预期接收事件
100	7	0.2,0.3	add 7
101	7	0.4,0.3	update 7
102	空	无	remove 7

可下载100帧OSC束、101帧OSC束、102帧OSC束及十六进制对照。它们是本地生成的标准结构合成输入，没有联网发送，也不是设备现场抓包。

接收端应按完整有效帧的alive集合比较增删，不等待统一的up命令。如果移除帧丢失，下一份完整alive仍可表达不含该会话；应用额外的断流超时必须另写策略，不能把无数据直接等同抬手。详细的重复、乱序与缺帧测试见触点会话结束事件核验。

坐标映射使用明确的像素约定

TUIO位置是归一化值，先记录跟踪平面原点、轴方向、屏幕旋转及实际渲染区域。若目标为从0起的像素索引，可用px=round(x×(W−1))、py=round(y×(H−1))；若引擎使用连续画布坐标，边界处理按引擎约定，不能混为同一种整数索引。

左右镜像在一层写x2=1−x，需要翻Y时在约定位置写y2=1−y。不要在驱动和引擎同时翻转。点中心无法发现镜像，按四角与中心坐标夹具逐点核对，并保存原始坐标、变换结果与真实落点录像。

把协议事件接到业务之后还要验一次

add分配交互对象，update更新同一会话，remove释放拖动锁与占用资源。session ID是一次存在过程的标识，不能当长期观众身份；对象class ID也不能代替会话。手势、惯性和灯光联动属于上层逻辑，需要指定输入与独立预期，不是收到TUIO就自动拥有。

依据：TUIO 1.1官方规范与官方参考实现，核对日期2026-10-23。本轮已离线解析合成坐标和生命周期；真实OSC网络收发、触摸设备精度、引擎释放行为及落点录像均未测。