TUIOSimulator v1.2使用指南：虚拟交互开发的利器
项目地址: https://gitcode.com/gh_mirrors/tu/TUIOSimulator TUIOSimulator v1.2是一款基于Unity/C#开发的简单TUIO v1.1模拟器，支持MacOS、Windows、iOS和Android平台。该工具能够模拟带有触控对象的虚拟桌面环境，跟踪虚拟物体在桌面上的ID、位置及方向，并通过网络连接将这些数据以TUIO协议的形式发送给客户端应用程序。
项目简介
TUIO（Tangible User Interface Objects）协议基于Open Sound Control（OSC），专门用于多点触控和物理互动界面开发。TUIOSimulator能够发送和接收TUIO光标和对象数据，实现与TUIO服务器/客户端应用程序的无缝交互。
默认配置下，模拟器向127.0.0.1:3333发送TUIO数据，并在33333端口接收传入的TUIO数据。设置界面会保存最近的连接历史记录。
快速启动
预构建版本使用
项目提供了预构建的可执行文件，可以直接下载使用：
- TUIOSimulator v1.2.app (MacOS)
- TUIOSimulator v1.2 (Windows x64)
启动后，模拟器将显示一个虚拟桌面界面，用户可以通过触摸或鼠标点击进行操作。
源码构建
如需从源码构建，需要Unity 2017.1或更高版本。早期版本可以使用Unity 5.x或更高版本构建。
项目依赖的库包括：
- TouchScript (v9.0)
- Unity PostProcessing (v1)
功能特性
支持的操作类型
光标支持：模拟触摸/鼠标操作，创建和发送TUIO光标数据。
对象支持：支持标记对象，模拟器目前包含8个对象/标记，用户可以根据需要轻松添加更多并自定义它们。
使用方式
在表面上触摸或鼠标点击可以创建并发送TUIO光标。在对象上触摸或鼠标按下并拖动可以在表面上移动并发送TUIO对象数据。
对象旋转支持两种方式：
- 双指手势旋转
- Alt + 鼠标点击放置第一个触摸点，然后再次鼠标按下放置第二个触摸点。
核心配置
模拟器的核心配置通过Settings类管理：
客户端配置：
- 默认IP地址：127.0.0.1
- 默认端口：3333
- 发送光标：开启
- 发送对象：开启
- 发送Blob：关闭（暂不支持）
服务器配置：
- 默认监听端口：33333
- 监听状态：开启
应用场景
链式连接
模拟器可以与其他TUIO应用程序或自身的另一个实例进行链式连接。它能够接收和渲染TUIO光标和对象信息（在本地监听端口上），然后再次发送出去（到目标服务器:端口）。
开发测试
在没有实体交互硬件的情况下，开发人员可以使用模拟器验证TUIO协议的接收与处理逻辑，大大提升开发效率。
技术细节
屏幕尺寸适配
模拟器会持续监测屏幕尺寸变化，确保在不同分辨率设备上的正确显示。当检测到屏幕尺寸变化时，会自动更新内部尺寸计算。
对象交互优化
对象的命中区域当前比其可见精灵图更大，这样在iOS上移动和使用双指手势旋转时会更加容易。这些扩展的命中区域也用于确定表面上的活动对象，因此对象在比精灵图显示更远离表面时仍保持活动状态。
注意事项
模拟器主要用于横向方向使用，纵向和其他常规调整可能需要一些额外配置。
项目结构
核心源码位于：
- 主程序：Assets/scripts/main/Main.cs
- TUIO设置：Assets/scripts/TUIO/Settings.cs
- TUIO传输：Assets/scripts/TUIO/TUIOTransmitter.cs
许可信息
项目采用MIT许可证，用户可以自由使用、修改和分发软件，只需保留原始版权声明和许可声明。
通过TUIOSimulator，开发者可以更加高效地进行多点触控和物理交互项目的开发与测试，为虚拟交互开发提供强大的支持工具。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
