02-快速开始
快速开始
TUIO 发送端 — 模拟触控输入
- 启动 NexTuio
- 选择 TUIO 发送端 模式
- 配置参数：
| 参数 | 值 |
|---|
| 目标地址 | 127.0.0.1 |
| 目标端口 | 3333 |
| 本地端口 | 9000 |
- 模拟模式选择 光标 (Cursor)
- 点击 连接
- 在右侧触控画布上：
- 点击 = 光标按下（发送 cursor down）
- 拖拽 = 光标移动（发送 cursor move）
- 松开 = 光标抬起（发送 cursor up）
- 日志区显示发送的 TUIO 消息：
[TX] /tuio/2Dcur source simulator
[TX] /tuio/2Dcur alive 0
[TX] /tuio/2Dcur set 0 0.5 0.3 0 0 0
示例：物体追踪模式
- 模拟模式选择 物体 (Object)
- 在画布上点击，弹窗设置物体参数：
| 参数 | 说明 |
|---|
| CID (Class ID) | fiducial 标记类型，如 0-255 |
| Angle | 旋转角度（弧度） |
- 确认后，物体出现在画布上
- 可拖拽移动物体，拖拽旋转手柄调整角度
TUIO 接收端 — 监听触控数据
- 选择 TUIO 接收端 模式
- 设置监听端口：
- 点击 监听
- 当 TUIO 发送端（如 TouchOSC、其他 TUIO 应用）向
本机IP:3333 发送数据时：
- 日志区显示解析后的 TUIO 消息
- 对象树实时更新活跃对象列表
- 画布可视化展示触控点位置
与 reacTIVision 配合
reacTIVision 是经典的 fiducial 标记识别引擎，通过摄像头识别标记并通过 TUIO 发送。
- 启动 reacTIVision
- 使用 NexTuio 接收端 模式，监听 reacTIVision 默认端口
3333 - 将 fiducial 标记放在摄像头下
- NexTuio 的对象树和画布将实时显示识别到的物体
快速提示
- 多点触控模式支持最多 10 个同时触控点
- 物体追踪模式中每个物体有唯一的 SID（Session ID）
- 画布坐标归一化到 0.0-1.0（符合 TUIO 规范）
- 接收端不区分消息来源，任何向指定端口发送的 TUIO 数据都会被处理