跳转至主要内容

更新日志

3.2.0​

2025年4月

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

  • DevicesCache 已添加该功能，用于集中访问有效载荷。
  • 已修复Inverse3 和VerseGrip控制器中Inspector的可见性问题。
  • 为提高性能，已缩减输出有效载荷的大小。
  • 示例 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 软件包。 若要使用 3.x 版 SDK 运行 Unity，您需要访问 Inverse SDK 3.1.x 或升级到更高版本。

新功能​

  • 已新增对新型无线设备 VerseGrip Stylus 的支持。
  • ClientConnection 已针对Inverse SDK 3.x.x 进行更新。
  • 扩展了设备分配和管理选项。
  • 改进了光标和角度位置的识别功能。
  • 已更新 Inverse3Gizmos，以实现对坐标的更好处理。

API 优化​

  • 组件和事件的重命名：

    • 为便于阅读，已对名称进行简化和统一：
      • DeviceBehaviour → DeviceControllerBase.
      • CursorBehaviour → CursorBase.
      • Inverse3 → Inverse3Controller.
      • VerseGrip → VerseGripController.
    • 已相应更新编辑器类（例如 DeviceBehaviourEditor → DeviceControllerBaseEditor).

  • 事件处理方面的改进：

    • DeviceStateChanged-事件在 Inverse3Controller und 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 und VerseGripCursor 现已支持平滑位置和旋转。
  • 工作区管理:
    • 该设备 Inverse3 列举了这些特性 WorkspaceCenterPosition, WorkspaceRadius und WorkspaceScaledRadius ein，以增强空间感知能力。
    • 新字段 SpaceTransformationUpdateEnabled 用于控制空间变换矩阵的更新。
  • 事件处理:
    • 新事件 Ready 用于 Inverse3 und VerseGrip，该指示灯用于提示设备何时已完全初始化并可投入使用。
  • 设备映射器:
    • 设备调用功能已扩展：标准参数为 GetInverse3(handedness) 以及新功能 GetVerseGrip(handedness)，以便找到相关的思路。

修改与改进​

  • 关于 ClientConnection, DeviceMapper 并修复了光标行为问题，以避免错误并提高稳定性。
  • 改进了设备连接和轮询的处理，特别是在出现错误情况时。
  • 计算以下内容的统一缩放比例： HapticOrigin im Editor 已稳定。

有关所有更改的详细列表（包括具体的已弃用功能及其替代功能），请参阅完整的变更日志。

请参阅详细的更新日志。

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 und 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：便于对工作空间进行缩放和定位。
  • Gizmos：可视化设备的位置、方向以及可及的工作空间。

不兼容的更改​

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

错误修复与改进​

  • 手性识别：在设备识别过程中提供该功能，无需打开设备。
  • 自动设备识别：新增了Haply 反向服务和DeviceMapper功能。
  • 频率提高：触觉回路的频率从约1000Hz提高到约4000kHz。
  • 稳定性与性能：提升了稳定性，并进行了多项其他修正和改进。

请参阅详细的更新日志。