3.1.0 变更历史
依赖关系
- Haply Inverse SDK 版本 3.1.0:
Inverse SDK 3.x.x已更新以支持该通信协议。Inverse SDK 3.1.0已针对该有效载荷格式增强了 JSON 序列化功能。
破坏性变更
-
库的删除与重构:
Haply.Inverse已删除 2.x.x 版本的库。- 为了提高一致性,我们对命名空间进行了重构:
Haply.Inverse.Unity→Haply.Inverse。Haply.Inverse.Unity.Internal→Haply.Inverse。
-
组件名称更新:
DeviceBehaviour→DeviceControllerBase。CursorBehaviour→CursorBase。- 编辑器类的更新:
DeviceBehaviourEditor→DeviceControllerBaseEditor。
-
控制器重构:
Inverse3→Inverse3Controller。VerseGrip→VerseGripController。Inverse3Controller更新属性名和方法名:Joint3→Angle3。JointsAngles→AngularPosition。JointsAngularVelocity→AngularVelocity。JointsAnglesOutput→AngularPositionOutput。JointsSetAngles→SetAngularPosition。JointsSetTorques→SetAngularTorque。
-
坐标转换系统:
- 为了校正默认设备控制器的旋转(90°和-90°),
Icon Forward Pose已更新预设。 - 转换逻辑 轴的替换 → 比例 → 偏移 按该顺序进行了更新,并使其与 Unity 的内置逻辑保持一致。
以前的顺序是“更换坐标轴 → 平移 → 偏移(应用缩放)”,但这种顺序不够直观,且与优化的内置方法兼容性较低。
Vector3SettingsをPositionConverter,QuaternionSettingsをRotationConverter已更名为。
- 为了校正默认设备控制器的旋转(90°和-90°),
-
活动系统的变更:
Inverse3Controller的DeviceStateChanged活动是,Inverse3EventArgs伴随EventHandler开始使用它了。VerseGripController的DeviceStateChanged活动是,VerseGripEventArgs伴随EventHandler开始使用它了。
未提供或已删除的功能
-
推迟推出的功能:
- ConnectionMonitorWindow、ClientConfiguration和PerformanceData已被暂时删除。这些功能预计将在未来的更新中恢复。
-
API 变更:
Inverse3Controller.RequestOrientation()已删除该方法。OrientationChangedAsync已删除该活动。
新功能
-
无线设备支持:
- 现已全面支持新款无线VerseGrip Stylus设备。
-
协议升级:
ClientConnection但Inverse SDK 3.x.x已升级以支持该通信协议。
-
设备映射:
- 在运行时的设备设置中,新增了启用/禁用自动映射和自动连接的选项。
- 已添加一种用于改进设备管理的新方法:
- 获取设备列表
FetchDeviceListOnce和StartFetchingDeviceListWithRetry。 - 获取已连接设备的列表
GetInverse3Devices和GetVerseGripDevices。 - 根据惯用手或设备类型等条件筛选并获取场景控制器
GetInverse3Controllers和GetVerseGripControllers。 - 将设备映射到特定控制器
MapDevices。 - 取消设备映射
UnmapDevices。 - 在控制器之间切换设备
SwapInverse3和SwapVerseGrip。
- 获取设备列表
-
增强探测功能:
Inverse3Controller到ProbeCursorPosition已添加该方法。无需发送控制命令即可获取光标位置。Inverse3Controller到ProbeAngularPosition已添加该方法。无需发送控制命令即可获取角度位置。
-
Inverse3Gizmos:
- Gizmo 现已在运行时模式和编辑器模式下,能够正确反映坐标变换、惯用手设置以及场景变换。
- 已将设备的3轴手柄显示在工作区中央(反映实际设备轴向)。
修正与改进
- 表演:
- 为了提高性能和稳定性,我们对坐标转换器进行了优化。
- 光标半径的计算:
CursorBase现在,系统会针对所有基本网格计算缩放后的半径。
- 安全性检查:
- 已防止在控制模式之间进行不安全的切换。