上位机Qnbot Studio

设备连接与标定

检测并激活手套设备、确认左右手连接,并完成手势与骨长标定。

最新文档

设备连接与标定

设备检测与连接

图 4-1 设备选择与激活界面

设备卡片信息

字段/状态含义与操作
设备名称用于识别设备类型,例如 EMF 左手、EMF 右手。
SN设备序列号。处理售后或多设备场景时应记录完整 SN。
激活设备已被检测到但尚未具备当前环境的使用资格;点击后等待激活结果。
激活中…正在处理激活请求,请保持网络和设备连接。
激活失败,请重试检查网络、账号权限和设备连接,然后点击“重新激活”。
已连接设备已连接到当前会话。

标准连接流程

  1. 点击“检测设备连接”或“重新检测”,等待设备列表刷新。
  2. 核对设备名称、SN 和左右手。多台设备同时出现时,优先依据 SN 确认。
  3. 对未激活的设备点击“激活”,等待状态更新。
  4. 点击卡片选择本次使用的设备。最多同时选择一只左手和一只右手设备。
  5. 点击“确认连接”。若按钮不可用,检查是否至少选择了一台可用设备。

选择约束:同一会话中最多选择一只左手和一只右手。不要把两台同侧设备同时作为输入,以免左右手来源与标定文件不匹配。

未检测到或连接失败

  • 确认设备已开机、供电正常,接收器或 USB 线连接牢固。
  • 拔插设备后等待系统完成识别,再点击“重新检测”。
  • 关闭其他可能占用设备的程序。
  • 如果设备曾可用但突然失联,先停止仿真,再重新检测或重启上位机。
  • 记录界面提示、设备 SN、发生时间和操作步骤,必要时开启 Debug 复现。

手势标定

标定用于建立当前使用者、当前设备和左右手的动作映射基线。左右手应分别标定;更换设备、使用者或出现明显动作偏差时,建议重新标定。

图 5-1 左右手 8 步标定动作总览

标定前条件

  • 目标设备已连接,左右手选择正确。
  • 手套佩戴到位,手腕保持自然,传感区域未折叠或受压。
  • 当前没有仿真、更新或其他程序占用设备。
  • 标定区域光线和空间适宜,操作员可稳定保持示意姿势。

标定动作

左右手标定均包含 8 个步骤:五指展开、五指并拢、五指握拳、五指偏置、双指屈曲、双指屈曲、食指屈曲、小指屈曲。两个“双指屈曲”步骤对应不同示意姿态,应严格按照当前步骤图片执行,不可仅凭文字判断。

动作原则:以向导中的手型示意图、左右手标识和步骤编号为准。每个姿势稳定后再确认;点击确认时不要移动手指,也不要为了达到姿势而过度用力。

图 5-2 标定过程:步骤进度、动作示意与确认按钮

执行标定

  1. 在手势标定总览页确认左手和/或右手动作卡片完整显示。
  2. 点击“开始标定”。系统进入对应手侧的分步向导。
  3. 查看页首“标定左手/标定右手”和 1-8 步进度,确认当前手侧无误。
  4. 按照中央示意图摆出动作,阅读步骤说明。无法实现的动作按界面说明处理。
  5. 姿势稳定后点击“确认”,进入下一步。重复直到全部步骤完成。
  6. 完成页出现后返回主流程,并检查仿真输入是否能正确响应。

标定质量判断

检查项合格表现不合格处理
左右手界面手侧与佩戴设备一致退出并选择正确设备/手侧后重做
姿势稳定确认前保持约 1 秒且无抖动当前步骤异常时退出并重新完整标定
模型响应张合、弯曲与左右手方向一致检查输入来源,必要时重新标定
重复性重复同一动作时模型结果接近检查佩戴位置、设备状态与标定文件

骨长标定

骨长标定通过手机摄像头、打印标定板和手部关键点识别采集使用者的手部尺寸。采集完成后,结果会自动同步到上位机并保存到本机。

打开骨长标定并扫码

  1. 在手势标定页面点击“骨长标定”。
  2. 上位机显示二维码后,使用手机扫码打开骨长采集页面。
  3. 保持上位机二维码窗口打开,等待手机端完成标定并同步结果。

图 5-3 从手势标定页面打开骨长标定

图 5-4 扫描骨长标定二维码

下载并打印标定板

  1. 在手机页面点击“打印标定板”,下载标定板 PDF。
  2. 使用 A4 纸按 100% 原尺寸打印,不要缩放或执行“适合页面”。
  3. 将标定板平整放置在光线均匀、无明显反光的桌面上。
  4. 打印完成后点击“已准备好,下一步”。

使用摄像头采集 50 帧

  1. 点击“启动摄像头”,允许浏览器使用手机摄像头。
  2. 将待标定的手自然平放在标定板中央,并让标定板的 四个角标记完整入镜且不被手或其他物体遮挡。
  3. 调整手机位置,等待页面识别四个角标记和手部关键点。系统会自动识别左手或右手,无需手动选择。
  4. 保持手掌与标定板稳定,等待有效采样达到 50 / 50。移动、遮挡或识别质量不足的画面不会计入有效帧。
  5. 如果长时间没有增加有效帧,重新调整光线、拍摄角度和距离,确保四个角标记均清晰可见;必要时点击“重新采集”。
手机端下载并打印标定板四个角标记完整入镜后采集手部骨长
下载并打印标定板四个角标记完整入镜后采集手部骨长

确认同步与写入

达到 50 帧后等待手机端完成计算。结果会自动同步到上位机,上位机页面刷新并显示“骨长标定成功”,表示当前手的骨长结果已写入并保存到本机。此时可以点击“完成”关闭窗口,或点击“继续标定”采集另一只手。

图 5-7 骨长标定结果同步并写入成功

覆盖规则:系统会自动识别左手和右手。左右手结果分别保存;再次标定同一只手时,新结果会覆盖该手原有的骨长标定结果。