跳转至正文

更改日志

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 插件。 若要将 Unity 与 3.x SDK 配合使用，请 Inverse SDK 3.1.x 必须升级到此版本以上。

新功能​

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

API 改进内容​

  • 更改组件和事件名称：

    • 为了提高可读性，我们对名称进行了简化和标准化：
      • DeviceBehaviour → DeviceControllerBase.
      • CursorBehaviour → CursorBase.
      • Inverse3 → Inverse3Controller.
      • VerseGrip → VerseGripController.
    • 因此，我们也更新了 Editor 类（例如： 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) 版本。

警告

此版本与2021.3.0f1 之前的Unity 版本不兼容。如果遇到兼容性问题，请更新至最新版本。

破坏兼容性的更改及已弃用的功能​

在此版本中，为适应新更新和改进的功能，部分功能已进行调整或被停用。 建议开发者查阅详细的变更日志，以了解被停用的功能及其替代功能的完整列表。

新功能​

  • Inverse3Body 组件：将Inverse3 设备的人体方向应用到指定的 GameObject 上。
  • Inverse3 改进内容：新增了与设备方向、电源供应、控制模式以及传输至设备的输出相关的新属性与事件。
  • VerseGrip 改进：新增了对坐标转换设置的支持，并添加了 ErrorEvent。
  • 检查员: 现在 ControlMode并显示最近的设备输出。
  • DeviceMapper 的改进：新增了动态设备映射、状态轮询以及断开连接后的设备重新连接功能。
  • OrientationSettings：已添加到 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设备的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。
  • 稳定性与性能：稳定性得到了提升，此外还进行了一系列修正和改进。

详情请参阅变更日志。