触觉接触标定

触觉接触标定为「单个用户 + 单只手套」训练专属的接触检测模型,让触觉热力图准确区分接触与未接触。每个「用户 + 手套」组合至少完成一次标定,更换用户或手套后重新标定即可。

开始前需先登录 Studio 用户。触觉标定模型按用户保存,未登录无法开始标定。创建方法见使用前准备 > 用户档案

触觉接触标定仅适用于 Wuji Glove(触觉手套),与设备标定(指尖捏合、四指弯曲等姿态标定)相互独立,互不影响。

标定主页

进入前请先在 设备管理 页连接要标定的 Wuji Glove。点击 Activity bar 的 Tactile Calibration 图标 进入标定主页:左侧 Devices 边栏列出已连接手套及其标定状态,右侧居中显示标题、流程说明与启动按钮。

标定主页

在边栏选中手套,点击 Start calibration 进入标定流程。已标定手套显示 Re-calibrate,点击为重新标定,两者流程相同。

启动按钮在以下情况不可用:

  • 未连接手套:提示 Connect a Wuji Glove first
  • 已连接但未选中:提示 Select a Wuji Glove in the device tree on the left
  • 后台服务启动中:提示 sidecar starting…,稍候即可

开始标定

全程戴着手套做空手动作,不要触碰任何物体。这一步在建立「未接触」基线,碰到桌面、手指或其他物体都会污染数据,导致接触判定不准。

标定按顺序采集 4 个引导动作,每个采集 10 秒。各动作的图示与操作要点见下方 动作总览

完成一个动作

每个动作的操作一致:

  1. 阅读当前动作的提示和图示
  2. 点击 Start,开始 10 秒采集倒计时,在这 10 秒内把该动作重复做 3 次
  3. 采集结束后点击 Next motion 进入下一个动作

对结果不满意点击 Re-record 重录当前动作。采集中可随时点击 Cancel 取消并返回主页。

动作总览

步骤图示动作操作要点
1Fold four fingers down, then thumb inFold four fingers down, then thumb in四指伸直并拢,在指根处下折约 90° 再张开,反复进行。最后一次下折时,拇指横向收进掌心
2Five-finger clawFive-finger claw五指(含拇指)一起向掌心蜷曲成爪形,再张开,反复进行
3Spread & closeSpread & close五指伸直,尽量张开到最大,再并拢,反复进行
4Curl fingers one by oneCurl fingers one by one从食指到小指,依次将每根手指弯向掌心

标定完成

采完第 4 个动作后自动开始训练,界面显示 Training… 与进度。训练完成后进入实时验证:按压手套不同位置(指尖、掌心),对应区域在热力图上变红,并提示 Press different spots on the glove (fingertips, palm) — matching areas should light up red.

完成页提供三个操作:

操作说明
Done确认效果,完成标定。界面显示 Calibration complete,模型已为当前用户与该手套保存
Re-calibrate效果不理想时从头重新标定
Back返回标定主页

标定模型自动保存,绑定当前 Studio 用户与手套 SN,下次订阅触觉数据时自动加载。

模型保存位置

标定生成的触觉接触模型按当前 Studio 用户档案与手套隔离保存:

~/.wuji/sdk/models/users/<用户档案 ID>/<手套 SN>/

目录下包含 contact.safetensors(模型权重)和 contact.npz(参考数据)两个文件。每个用户档案独立保存一份,切换用户或更换手套互不影响,SDK 按当前用户与手套自动加载对应模型,无需手动指定。

何时需要重新标定

出现以下情况建议重新标定:

  • 更换使用者或更换手套
  • 触觉热力图接触判定明显异常(轻触不亮,或未接触却变红)
  • 设备维修或更换部件后

操作:在验证页点 Re-calibrate,或回到标定主页选中手套、点 Start calibration(已标定显示 Re-calibrate)重做。

调整接触灵敏度

页面右上角的 Contact sensitivity 控件控制热力图中「多大压力判定为接触」:

说明
范围0.5×–3.0×,默认 1.0×(Less 更难触发,More 更易触发)
作用数值越高,更轻的按压也会判定为接触
生效按手套独立保存,调整后立即生效,无需重新标定

异常处理

触觉标定中可能遇到以下情况:

现象原因处理
主页提示 sidecar starting…,启动按钮不可用后台标定服务尚未就绪稍候几秒,服务就绪后按钮自动可用
提示 Sidecar stopped,标定已中止后台服务中断重新进入主页点 Start calibration 重试
采集或训练失败,提示 Operation failed. Check the device connection and try again.设备连接异常或数据中断检查手套连接,重新开始标定
反复失败重启 Studio,仍失败请联系 support@wuji.tech