跳转至主要内容

变更日志

3.2.0​

2025年4月

此更新引入了新的组件 DevicesCache 用于有效载荷管理，提高了 Unity 检查器在设备控制器中的可见性，并包含性能优化。

  • 添加 DevicesCache 以便集中访问有效载荷。
  • 修正了Inverse3 和VerseGrip控制器上检查器的可见性。
  • 缩小输出有效载荷的尺寸，以提升性能。
  • 示例更新 Haptics and Physics Engine 适用于 SDK 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 软件包。 若要将 Unity 与 SDK 3.x 配合使用，您需要升级至 Inverse SDK 3.1.x 或更高版本。

新品​

  • 新增对新款VerseGrip无线触控笔的支持。
  • Inverse SDK 3.x.x 的 ClientConnection 升级。
  • 增强的设备映射和管理选项。
  • 针对游标位置和角度的探测功能已得到改进。
  • 更新了 Inverse3Gizmos，以实现更好的坐标管理。

API 的改进​

  • 组件和事件的重命名：

    • 为提高可读性，对名称进行了简化和规范：
      • DeviceBehaviour → DeviceControllerBase.
      • CursorBehaviour → CursorBase.
      • Inverse3 → Inverse3Controller.
      • VerseGrip → VerseGripController.
    • 相应地更新了编辑器类（例如， DeviceBehaviourEditor → DeviceControllerBaseEditor).

  • 活动管理方面的改进：

    • 活动 DeviceStateChanged de Inverse3Controller et 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 et VerseGripCursor 现已支持平滑的位置和旋转。
  • 工作区管理 :
    • 环城公路 Inverse3 介绍了这些性质 WorkspaceCenterPosition, WorkspaceRadius et WorkspaceScaledRadius 以增强空间感知能力。
    • 新字段 SpaceTransformationUpdateEnabled 用于控制空间变换矩阵的更新。
  • 活动管理 :
    • 活动 Ready 添加用于 Inverse3 et 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) 才能实现完全兼容。

注意

此版本不兼容 Unity2021.3.0f1 之前的版本。如果您遇到兼容性问题，请更新至更高版本。

不兼容的更改和已弃用的功能​

为了与最新更新保持一致并改善运行效果，本版本对多项功能进行了修改或将其标记为已弃用。 建议开发者查阅详细的更改日志，以获取已弃用功能及其替代方案的完整列表。

新功能​

  • Inverse3Body 组件：将Inverse3 中某个设备的姿态应用到指定的 GameObject 上。
  • Inverse3 的改进：新增了与设备方向、电源、控制模式以及发送至设备的输出相关的属性与事件。
  • VerseGrip 的改进：支持坐标转换参数和 ErrorEvent。
  • 督察 : 现在显示 ControlMode 以及该设备最近发布的机型。
  • DeviceMapper 的改进：动态设备映射、状态查询以及断开连接后的设备重新连接。
  • OrientationSettings：已添加到 VerseGripCursor 和 Inverse3Body 组件中。
  • 显式缓存类型 : Inverse3Data et 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 ），可轻松配置场景；以及一个“设备映射器”（DeviceMapper），用于自动分配Inverse3 和 VerseGrip 设备。

依赖项​

该软件包需要在计算机上安装 Haply Inverse SDK (>=2.0.0) 才能在计算机上运行。

新功能​

  • 监控窗口：新增了一个窗口，用于查看已连接设备的状态。
  • Haply 创建菜单：通过一个新菜单，可添加所有所需的 GameObject，从而简化场景配置。
  • DeviceMapper：自动为Inverse3 和VerseGrip设备分配名称。
  • 客户端配置：用于控制触觉反馈循环的频率以及连接的使用场景。
  • Inverse3 组件：取代 HapticThread，用于设备定位和力反馈控制；它包含用于高频操作的新方法和新事件。
  • VerseGrip 组件：取代 HandleThread；它包含用于按钮状态和附着状态的方法，以及用于与场景交互的新的 Unity 事件。
  • 光标组件：Inverse3Cursor 和 VerseGripCursor，用于显示设备的位姿。
  • GameObject HapticOrigin：便于对工作区进行缩放和定位。
  • 小工具：用于显示设备的的位置和方向，以及可访问的工作区域。

不兼容的更改​

  • 替换：HapticThread 和 HandleThread 分别被Inverse3 和 VerseGrip 取代。
  • 新事件：DeviceStateChanged 事件取代了 Run(callback) 方法。
  • DeviceOpened 事件：onInitialized 事件已被Inverse3.DeviceOpened 和 VerseGrip.DeviceOpened 取代。
  • 触觉反馈参数：移除光标位置和速度的反馈。
  • AdditionalData：取消对线程的安全 AdditionalData 管理，转而采用用户定义的数据管理方式。

错误修复与功能改进​

  • 手性检测：设备一经检测即可使用，无需打开设备。
  • 设备自动检测：借助Haply 反向服务和DeviceMapper得到了改进。
  • 频率提升：触觉回路的频率从约1000Hz提升至约4000kHz。
  • 稳定性与性能：提升了稳定性，并进行了多项其他修复和改进。

请查阅详细的变更日志。