跳至主要内容

更新日志

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 优化，以及简化的事件处理。

重要兼容性说明​

由于 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 该事件现已改为使用 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 字段，用于控制空间变换矩阵的更新。
  • 事件处理：
    • 为 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。
  • 检查员：现在会显示 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 事件。
  • 光标组件：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。
  • 稳定性与性能：提高了稳定性，并完成了许多其他修复和改进。

查看详细的更新日志。