更新日志
3.2.0
2025 年 4 月
本次更新引入了新的 DevicesCache 管理有效载荷的组件，提高了设备控制器的 Unity 检查器可见性，并进行了性能优化。
- 已添加
DevicesCache以实现有效载荷的集中访问。 - 修正了Inverse3 和 VerseGrip 控制器的检查器可见性。
- 减小输出有效载荷大小，提高性能。
- 已更新
Haptics and Physics EngineSDK 3.x.x 的样本。
请参阅详细的更新日志。
3.1.0
2024 年 12 月
Haply Inverse Unity 3.1.0 在以下方面向前迈出了重要一步 无线 VerseGrip 触控笔 并与 Inverse SDK 3.x.x 通信协议。
该版本包括增强的设备探测功能、改进 API 以提高清晰度和一致性，以及简化事件处理。
重要兼容性说明
中引入了更新的有效载荷 JSON 格式。 Inverse SDK 3.0.x目前没有与 SDK 3.0.x 兼容的 Unity 软件包。
要在 3.x SDK 中使用 Unity，必须升级到 Inverse SDK 3.1.x 或更晚。
新功能
- 新增了对新型无线 VerseGrip 触控笔的支持。
- 为Inverse SDK 3.x.x 升级了 ClientConnection。
- 增强设备映射和管理选项。
- 改进了光标和角度位置的探测功能。
- 更新了 Inverse3Gizmos，以更好地处理坐标。
应用程序接口改进
-
组件和事件重命名
- 简化和标准化命名，提高可读性：
DeviceBehaviour→DeviceControllerBase.CursorBehaviour→CursorBase.Inverse3→Inverse3Controller.VerseGrip→VerseGripController.
- 编辑器类相应更新（如
DeviceBehaviourEditor→DeviceControllerBaseEditor).
- 简化和标准化命名，提高可读性：
-
事件处理改进：
- 已过渡
DeviceStateChanged活动Inverse3Controller和VerseGripController使用EventHandler具体EventArgs(Inverse3EventArgs,VerseGripEventArgs).
- 已过渡
递延功能
- 以下功能因尚未准备就绪而暂时删除。它们将在今后的版本中恢复：
- 连接监控窗口
- 客户端配置
- 性能数据
- 删除了与身体方向和相关事件有关的方法。
该版本是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字段来控制空间变换矩阵的更新。
- 事件处理:
Ready事件都增加了Inverse3和VerseGrip当设备完全初始化并准备就绪时，发出信号。
- 设备映射器:
- 增强了设备检索功能，默认参数为
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 设备的身体方向应用于指定的游戏对象。
- Inverse3 增强功能：与机身方向、电源、控制模式和发送到设备的输出有关的新属性和事件。
- VerseGrip 增强功能：支持坐标转换设置和 ErrorEvent。
- 检查员:现在显示
ControlMode和最近的设备输出。 - 设备映射器改进：动态设备映射、状态轮询以及断开连接后重新连接设备。
- 方向设置：已在 VerseGripCursor 和 Inverse3Body 组件上添加。
- 显式缓存类型:
Inverse3Data和VerseGripData以便更好地处理数据。 - CoordinateConverter（坐标转换器）： 为不同设备位置定义坐标转换设置。
修复和改进
- 各种错误修复和稳定性改进
- 增强场景卸载/加载后的设备映射。
- 设备断开后自动重新连接。
- 在构建退出时清理客户端轮询线程。
请参阅详细的更新日志。
2.0.1
2024 年 3 月
此更新解决了前一版本中发现的几个问题，确保Haply Inverse Unity 的使用体验更加流畅。
修复的问题包括改进客户端轮询线程，以便在构建退出时更干净地关机，以及解决按名称安装软件包时丢失元文件的问题。
依赖关系
与 2.0.0 版的兼容性要求相同。
请参阅详细的更新日志。
2.0.0
2024 年 1 月
Haply Inverse Unity 2.0.0 版的发布引入了多项增强功能，可简化设备管理、可视化和场景设置。
新功能包括一个用于可视化连接设备状态的监控窗口、一个用于轻松设置场景的Haply 创建菜单，以及一个用于自动分配Inverse3 和 VerseGrip 设备的设备映射器。
依赖关系
该软件包要求 Haply Inverse SDK(>=2.0.0) 安装在电脑上。
新功能
- 监控窗口：添加了一个新窗口，用于直观显示连接设备的状态。
- Haply 创建菜单：简化场景设置，新增用于添加所有所需游戏对象的菜单。
- 设备映射器：自动分配Inverse3 和 VerseGrip 设备。
- 客户端配置：允许控制触觉环频率和连接用例。
- Inverse3 组件：取代 HapticThread 用于设备定位和力控制，包括用于高频操作的新方法和事件。
- VerseGrip 组件：取代 HandleThread，包括按钮状态和附件状态方法，以及用于场景交互的新 Unity 事件。
- 光标组件：用于可视化设备位置和方向的 Inverse3Cursor 和 VerseGripCursor。
- HapticOrigin 游戏对象：便于工作区的缩放和定位。
- Gizmos：可视化设备位置、方向和可触及的工作空间。
突破性变化
- 替换：HapticThread 和 HandleThread 分别由Inverse3 和 VerseGrip 取代。
- 新事件：DeviceStateChanged 事件取代了 Run(callback) 方法。
- DeviceOpened 事件：用Inverse3.DeviceOpened 和 VerseGrip.DeviceOpened 代替 onInitialized 事件。
- 触觉回调参数：删除了光标位置和速度的传递。
- 附加数据：删除了线程安全管理的 AdditionalData，改用用户定义的数据处理方式。
错误修复和改进
- 手势检测：设备检测时提供，无需打开设备。
- 自动设备检测：通过Haply 反向服务和设备映射器进行增强。
- 频率增加：触觉回路频率从 ~1000Hz 提高到 ~4000kHz
- 稳定性和性能提高稳定性并进行大量其他修复和改进。
请参阅详细的更新日志。