更新日志
3.2.0
2025年4月
本次更新引入了用于管理 payload 的新组件 DevicesCache，改进了设备控制器在 Unity Inspector 中的可见性，并包含多项性能优化。
- 新增
DevicesCache，用于集中访问 payload。 - 修复了 Inverse3 和 VerseGrip 控制器在 Inspector 中的可见性问题。
- 减小了输出 payload 的大小，以提升性能。
- 更新了
Haptics and Physics Engine示例，以适配 SDK 3.x.x。
详见完整的更新日志。
3.1.0
2024年12月
Haply Inverse Unity 3.1.0 迈出了重要一步，新增了对无线 VerseGrip Stylus的支持，并与 Inverse SDK 3.x.x 通信协议保持一致。
本次发布包含增强的设备探测功能、为提高清晰度和一致性而进行的 API 优化，以及简化的事件处理。
重要兼容性说明
由于 Inverse SDK 3.0.x 引入了更新后的 payload JSON 格式，目前没有与 SDK 3.0.x 兼容的 Unity 包。
若要在 3.x SDK 中使用 Unity，您必须升级到 Inverse SDK 3.1.x 或更高版本。
新功能
- 新增对新款无线 VerseGrip Stylus 的支持。
- 为 Inverse SDK 3.x.x 升级了 ClientConnection。
- 增强了设备映射与管理选项。
- 改进了光标位置和角度位置的探测功能。
- 更新了 Inverse3Gizmos，以改善坐标处理。
API 优化
-
组件与事件重命名：
- 为提高可读性，简化并统一了命名：
DeviceBehaviour→DeviceControllerBase。CursorBehaviour→CursorBase。Inverse3→Inverse3Controller。VerseGrip→VerseGripController。
- 相应更新了编辑器类（例如
DeviceBehaviourEditor→DeviceControllerBaseEditor）。
- 为提高可读性，简化并统一了命名：
-
事件处理改进：
Inverse3Controller和VerseGripController中的DeviceStateChanged事件已改为使用EventHandler，并配合专用的EventArgs（Inverse3EventArgs、VerseGripEventArgs）。
暂缓的功能
- 以下功能因尚未就绪已被暂时移除，将在后续版本中恢复：
- ConnectionMonitorWindow
- ClientConfiguration
- PerformanceData
- 移除了与身体姿态相关的方法及其关联事件。
本次发布是 Haply Inverse Unity 开发过程中的一个里程碑，提供了更丰富的功能、更清晰的表达，并为后续增强做好了准备。
详见完整的更新日志。
2.2.0
2024年8月
本次发布带来了多项新功能和增强，重点改善 Inverse3 和 VerseGrip 设备的用户体验。 主要更新包括新增平滑选项、用于工作空间管理的新属性，以及针对设备就绪状态的更完善事件处理。 此外，多项修复与改进提升了稳定性和性能，并恢复了与旧版 Unity 的兼容性。
依赖项
- 本次发布恢复了与 Unity 版本 >= 2021.3.0f1 的兼容性（该兼容性在 2.1.1 版本中被破坏）。
- 本软件包兼容 Haply Inverse SDK 2.0.0 及更高版本，但要获得完整兼容性，需要 Haply Inverse SDK（>=2.2）。
新功能
- 平滑增强：
Inverse3Cursor和VerseGripCursor组件现在支持平滑后的位置与旋转。
- 工作空间管理：
Inverse3设备新增了WorkspaceCenterPosition、WorkspaceRadius和WorkspaceScaledRadius属性，以提升空间感知能力。- 新增
SpaceTransformationUpdateEnabled字段，用于控制空间变换矩阵的更新。
- 事件处理：
- 为
Inverse3和VerseGrip新增了Ready事件，用于表示设备已完成初始化并可以使用。
- 为
- 设备映射器（Device Mapper）：
- 增强了设备获取功能：
GetInverse3(handedness)新增默认参数，并新增GetVerseGrip(handedness)功能，用于查找关联的握把。
- 增强了设备获取功能：
修复与改进
- 修复了
ClientConnection、DeviceMapper以及光标行为相关的问题，以防止错误并提高稳定性。 - 改进了设备连接与轮询的处理，尤其是在出错情况下。
- 稳定了编辑器中
HapticOrigin的统一缩放计算。
如需了解详细的变更列表，包括具体的已弃用功能及其替代方案，请参阅完整的更新日志。
详见完整的更新日志。
2.1.1
2024年6月
本次发布重点引入了与 Inverse3 设备身体姿态相关的新方法和组件，提供电源信息，改进了对设备输出和控制模式的控制，并改进了用于管理不同设备位置的坐标转换器。
此外，DeviceMapper 得到了显著改进，新增了带过滤功能的设备获取器，并提升了设备映射能力。
依赖项
本软件包兼容 Haply Inverse SDK 2.0.0 及更高版本，但要获得完整兼容性，需要 Haply Inverse SDK（>=2.1）。
本次发布与 2021.3.0f1 之前 的 Unity 版本不兼容。如遇兼容性问题，请更新到较新的版本。
破坏性变更与已弃用功能
本次发布对若干功能进行了更改或弃用，以与新的更新和改进的功能保持一致。 建议开发者查阅详细的更新日志，以获取完整的已弃用功能及其替代方案列表。
新功能
- Inverse3Body 组件：将 Inverse3 设备的身体姿态应用到指定的 GameObject 上。
- Inverse3 增强：新增与身体姿态、电源、控制模式以及发送至设备的输出相关的属性和事件。
- VerseGrip 增强：支持坐标转换设置，并新增 ErrorEvent。
- Inspector：现在会显示
ControlMode以及最近的设备输出。 - DeviceMapper 改进：支持动态设备映射、状态轮询，以及断开后自动重新连接设备。
- OrientationSettings：已添加到 VerseGripCursor 和 Inverse3Body 组件上。
- 显式缓存类型：新增
Inverse3Data和VerseGripData，以更好地处理数据。 - CoordinateConverter：为不同的设备位置定义坐标转换设置。
修复与改进
- 多项缺陷修复与稳定性改进。
- 增强了场景卸载/加载后的设备映射。
- 设备断开后自动重新连接。
- 构建退出时清理客户端轮询线程。
详见完整的更新日志。
2.0.1
2024年3月
本次更新解决了上一版本中发现的若干问题，并确保 Haply Inverse Unity 的使用体验更加流畅。
修复内容包括：改进客户端轮询线程，使构建退出时的关闭更加干净；并解决了按名称安装软件包时缺少 meta 文件的问题。
依赖项
兼容性要求与 2.0.0 版本相同。
详见完整的更新日志。
2.0.0
2024年1月
Haply Inverse Unity 2.0.0 版本带来了多项增强，简化了设备管理、可视化和场景设置。
新功能包括：用于可视化已连接设备状态的监视窗口、便于快速搭建场景的 Haply 创建菜单，以及用于自动分配 Inverse3 和 VerseGrip 设备的 DeviceMapper。
依赖项
使用本软件包需要在计算机上安装 Haply Inverse SDK（>=2.0.0）。
新功能
- 监控窗口： 新增一个窗口，用于可视化已连接设备的状态。
- Haply 创建菜单： 新增菜单，可一键添加所有必需的 GameObjects，简化场景设置。
- DeviceMapper： 自动分配 Inverse3 和 VerseGrip 设备。
- 客户端配置： 支持控制触觉循环频率，并适配不同的连接使用场景。
- Inverse3 组件： 替代 HapticThread，用于设备定位与力控制，并新增面向高频操作的方法和事件。
- VerseGrip 组件： 替代 HandleThread，包含按钮状态与吸附状态相关的方法，并新增用于场景交互的 Unity 事件。
- Cursor 组件： Inverse3Cursor 和 VerseGripCursor，用于可视化设备的位置与姿态。
- HapticOrigin GameObject： 便于工作空间的缩放与定位。
- Gizmos： 可视化设备的位置、姿态以及可达工作空间。
破坏性变更
- 替换项： HapticThread 和 HandleThread 分别由 Inverse3 和 VerseGrip 替代。
- 新增事件： DeviceStateChanged 事件取代了 Run(callback) 方法。
- DeviceOpened 事件： 将 onInitialized 事件替换为 Inverse3.DeviceOpened 和 VerseGrip.DeviceOpened。
- 触觉回调参数： 移除了光标位置和速度的传递。
- AdditionalData： 移除了线程安全的托管 AdditionalData，改由用户自行定义数据处理方式。
问题修复与改进
- 左右手方向检测： 检测到设备时即可提供，无需打开设备。
- 设备自动检测： 通过 Haply Inverse Service 和 DeviceMapper 进行了增强。
- 频率提升： 触觉循环频率从约 1000Hz 提升至约 4000kHz。
- 稳定性与性能： 提升了稳定性，并完成了众多其他修复与改进。
查看详细的更新日志。