跳过至主要内容

变更记录

3.2.0​

2025年4月

在本次更新中，新增了用于有效载荷管理的新 DevicesCache 我们引入了组件，在优化设备控制器在 Unity 检查器中的显示效果的同时，也对性能进行了优化。

  • DevicesCache 并添加了该功能，从而实现了对有效载荷的集中访问。
  • Inverse3 并修复了 VerseGrip 控制器在检查器中的显示问题。
  • 为了提高性能，我们缩减了输出有效载荷的大小。
  • 适用于 SDK 3.x.x Haptics and Physics Engine 已更新示例。

详情请参阅更改历史记录。

3.1.0​

2024年12月

Haply Inverse Unity 3.1.0 是，无线 VerseGrip 触控笔 添加了对……的支持，Inverse SDK 3.x.x 这是为实现与通信协议的兼容所迈出的重要一步。

本次发布包含对设备探测功能的增强、旨在提高清晰度和一致性的 API 改进，以及对事件处理的优化。

关于兼容性的重要注意事项​

Inverse SDK 3.0.x 由于引入了 JSON 格式的有效载荷更新，目前没有与 SDK 3.0.x 兼容的 Unity 包。 若要在 3.x SDK 中使用 Unity，请：Inverse SDK 3.1.x 此后需要进行升级。

新功能​

  • 已新增对新款无线 VerseGrip 触控笔的支持。
  • Inverse SDK 为了支持 3.x.x 版本，我们已对 ClientConnection 进行了升级。
  • 增强了设备的映射和管理选项。
  • 改进了光标和角度位置的探测功能。
  • 为了改进坐标处理，我们更新了 Inverse3Gizmos。

API 的改进​

  • 组件和事件的重命名：

    • 为了提高可读性，我们对名称进行了简化并统一：
      • DeviceBehaviour → DeviceControllerBase。
      • CursorBehaviour → CursorBase。
      • Inverse3 → Inverse3Controller。
      • VerseGrip → VerseGripController。
    • 随之，编辑器类也进行了更新（例如： DeviceBehaviourEditor → DeviceControllerBaseEditor）。

  • 事件处理的改进：

    • Inverse3Controller 以及 VerseGripController 的 DeviceStateChanged 将活动，通过专用的 EventArgs（Inverse3EventArgs、VerseGripEventArgs）的使用 EventHandler 已迁移至。

待处理的功能​

  • 以下功能因尚未准备就绪，已暂时移除。预计将在今后的版本中恢复：
    • 连接监控窗口
    • 客户端配置
    • 性能数据
    • 已删除与身体朝向相关的方法及相关事件。

本次发布是Haply Inverse Unity 开发过程中的一个重要里程碑，旨在扩充功能、提高清晰度，并为今后的功能增强做好准备。

详情请参阅更改历史记录。

2.2.0​

2024年8月

本次更新重点提升了Inverse3 以及 VerseGrip 设备的用户体验，并提供了一些新功能和改进。 主要更新包括：新增平滑选项、用于工作区管理的新属性，以及对设备就绪事件处理的改进。 此外，通过多项修复和改进，系统稳定性和性能均得到提升，并与旧版本 Unity 的兼容性也已恢复。

依赖关系​

  • 在此版本中，已恢复了在 2.1.1版本中丢失的与Unity 2021.3.0f1 及以上版本的兼容性。
  • 本软件包与Haply Inverse SDK 2.0.0 及更高版本兼容，但要实现完全兼容， Haply Inverse SDK（>=2.2）。

新功能​

  • 增强平滑处理:
    • Inverse3Cursor 以及 VerseGripCursor 该组件现已支持平滑处理后的位置和旋转。
  • 工作区管理:
    • Inverse3 在设备上，为了提高空间感知能力， WorkspaceCenterPosition、WorkspaceRadius、WorkspaceScaledRadius 已添加属性。
    • 一种控制空间变换矩阵更新的新方法 SpaceTransformationUpdateEnabled 已添加字段。
  • 事件处理:
    • Inverse3 以及 VerseGrip 两者都 Ready 已添加一项事件。该事件用于通知设备初始化已完成且已可投入使用。
  • 设备映射器:
    • 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 以及 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 创建菜单：新增了一个用于添加所有必要 GameObject 的新菜单，从而简化了场景的设置流程。
  • DeviceMapper：自动分配Inverse3 以及 VerseGrip 设备。
  • 客户端配置：现在可以控制触觉循环的频率和连接用例了。
  • Inverse3 组件：用于替代 HapticThread，以实现设备的定位和力控制。其中包含适用于高频操作的新方法和事件。
  • VerseGrip 组件：用于替换 HandleThread。它包含用于按钮状态和附加状态的方法，以及用于场景交互的新 Unity 事件。
  • 光标组件：用于可视化设备位置和方向的 Inverse3Cursor 和 VerseGripCursor。
  • HapticOrigin GameObject：便于对工作区进行缩放和定位。
  • Gizmo：可直观显示设备的位置、方向以及可到达的工作区域。

破坏性变更​

  • 替换：HapticThread 和 HandleThread 分别被替换为Inverse3 和 VerseGrip。
  • 新事件：DeviceStateChanged 事件取代了 Run(callback) 方法。
  • DeviceOpened 事件：已将 onInitialized 事件替换为Inverse3.DeviceOpened 和 VerseGrip.DeviceOpened。
  • 触觉回调的参数：已移除光标位置和速度的传递。
  • AdditionalData：已删除线程安全的受管 AdditionalData，并将其替换为用户自定义的数据处理。

错误修复与改进​

  • 惯用手检测：无需打开设备，现在在设备检测时即可提供该功能。
  • 自动设备检测：已通过Haply Inverse Service 和 DeviceMapper 进行了增强。
  • 频率提升：将触觉反馈回路的频率从约 1000Hz 提高至约 4000kHz。
  • 稳定性和性能：改进了稳定性，并进行了其他多项修复和优化。

详情请参阅“更改历史”。