加载中...

面向 Haply 设备的 Service Runtime 和 Runtime SDK,已打包为便捷安装程序。也称为“external”Service。
3.5.8 是一个补丁版本,重点是热插拔与重连以及挂载预设。公共 C API 与 3.5.7 保持不变,也没有删除任何路由。凡是影响使用默认配置客户端的改动,都是对 3.5.7 中已发布缺陷的修复,外加更清晰的诊断信息。本周期的新功能位于 SDK 的选择性启用开关之后,这些开关默认仍为关闭状态,默认客户端完全感知不到。
与 3.5.7 不同,本版本确实会改变默认客户端的观察结果,共有八处。其中五处影响面较广:设备在会话注册之前不会出现在该会话中;state.current_cursor_position 改为以应用空间为基准;力反馈门控改为按会话隔离;挂载写入需要单位旋转;居中预设会应用到设备当前的旋转状态,并可能报告 custom 或 defaults。另外三处影响范围较窄:在 Minverse 上,arm_front 和 defaults 会重置会话挂载,state.body_orientation 的取值也会随之改变;device-connection-loop 可能会针对未指定设备的接收器触发。每一项都列在"潜在的破坏性变更"下,其中说明了哪些用户会受影响以及如何迁移。
工程配套变更日志(__CODE_code-1__)包含受阶段门控的 API 细节、这些修复背后的内部机制、设计记录指引以及问题编号。
device-safety-triggered 事件也会重新送达。在 3.5.7 中,这些功能在服务重启之前都会丢失。device-connection-loop 事件;重新插拔后,握持力会立即恢复。state.body_orientation 和设备挂载参考不再绕 Y 轴旋转四分之一圈:设备在其校准姿态下重新读取为单位矩阵。state.current_cursor_position 现在以会话的应用空间报告,与其旁边的 cursor_position 一致,因此下发的目标位置会以发送时的坐标原样回传。device not found 警告,之后每 10 秒提醒一次并附带丢弃的命令数,设备重新出现时记录一条 device found again。此前是每条命令打印一行(台架测试中 2.5 秒内产生 16 939 行)。POST /ports/{port}/reset 现在也会取消无数据接收器的退避,因此下一次重新打开尝试会立即进行。热插拔与重连
GET /devices?session=)。Unable to serialize 日志,一次接收器重新插拔期间 3 毫秒内出现 11 条)。安装方式与预设
[1, 5.5] 范围的有效缩放值。现在两种传输方式采用相同规则:任一轴上接近零的缩放值之外的所有有限缩放值均有效。DELETE config/mount 后,config.preset 仍指向旧预设,因此重新应用该预设会让已删除的安装方式重新生效;在 Minverse 上,arm_front / defaults 会保留当前安装方式,而不是将其重置。state.body_orientation 及其已存储的安装参考值会偏差绕 Y 轴四分之一圈(左手型设备会将其单位参考报告为绕 Y 轴 +90 度的旋转)。设备配置
config.gravity_compensation(v3.0 和 v3.1)以及 GET /{device_type}/{id}/config/gravity_compensation 会在一次串口往返内更新,并且持有该设备的每个会话会在其下一条消息中收到一条完整回复。3.5.7 中,设备发出的变更通知被忽略,直到设备重新连接,旧值才会更新。更早的固件不会发送该通知,因此那里没有变化。线值
cursor_position、cursor_velocity 和 current_cursor_force 使用的是应用空间。在非单位基底下,回显结果会发生置换(XZ-Y:发送 (x, 0.090, 0.197),回显为 (x, -0.197, 0.090))。现在在 v3.1 完整帧和流式帧中,该值会使用会话基底和安装方式进行转换。自 3.5.0 起存在。34),而同一帧中的 session.session_id 携带的是真实 ID。现在它是完整的 32 位 ID,与文档中规定的 uint32 结构一致。自 3.5.0 起存在。GET /devices?session=)。在 3.5.7 中,设备在热插拔窗口期间会以裸数据形式出现。JSON 结构保持不变,当所有自定义抓握都被省略时,默认输出仍保留 custom_verse_grip: []。谁会注意到: 按数组位置跨帧索引设备的客户端,将某一帧中缺失的设备视为已拔出的客户端,或读取该设备首帧裸值的客户端。迁移方法: 使用 device_id 作为设备键;将设备首次出现的那一帧视为其接入时刻;通过事件通道而非数组成员关系来检测拔出。cursor_position 及指令目标一致。GET/POST/DELETE /{device_type}/{id}/config/filters/force_gate 以及 config.filters.force_gate.gain 报告的是该会话自身的值(默认 0.3),而非设备的实时增益。谁会注意到: 从监视或配置会话设置力门控的客户端,或期望读取到设备实时值的客户端。迁移方法: 从驱动该设备的会话中设置力门控;读取驱动会话的值以获取实际生效的数值。POST|PATCH config/mount 会返回 400 invalid mount transform (non-finite, non-unit rotation or ~zero scale axis);WebSocket configure.mount 会记录警告并保留之前的 mount。3.5.7 中被拒绝的、超出 [1, 5.5] 范围的 scale 现在会被接受。谁会注意到: 发送未归一化四元数的客户端,或依赖服务端限制 scale 的客户端。迁移方法: 发送前先归一化四元数;在客户端 UI 中自行限制所需的 scale 范围。arm_front_centered / led_front_centered 在应用时基于当前设备旋转来确定位置;当设备自应用后旋转超过 1 度时,config.preset 会读取为 custom(并针对 config.preset 触发一次 session-updated),包括重新插拔或墨水瓶重新校准之后的情况,且无需客户端写入;在会话范围内执行 DELETE config/mount 后,它会读取为 defaults。谁会注意到: 依据 config.preset 名称做出行为判断的客户端。迁移方法: 移动设备后重新应用预设以重新居中;将 custom 理解为"该预设已不再描述当前姿态"。arm_front_centered 的位置从 x = -0.13 调整为 x = -0.12(经硬件实测微调)。谁会注意到: 依赖这些预设保留自定义 mount 的 Minverse 用户,或基于旧中心点完成校准的用户。迁移方法: 重新检查基于旧中心点所做的 Minverse 校准。device_id 为该端口上最后一次见到的就绪 id;如果从未就绪过,则为空字符串;attempts 统计本次异常周期内的失败次数;window_ms 为自首次失败以来的时间。载荷结构保持不变。谁会注意到: 假定 device_id 永远不为空的客户端。迁移方法: 处理空的 device_id。此版本的所有可用下载: