切换识别模式
仅限游戏模式：在 AI 识别与普通识别模式间切换。
KINECT MOTION RECOGNITION
动捕测试相关
文档
动捕测试、动作数据录制及测试关卡使用说明。
01
快速操作
游戏中最常用的切换和关卡命令。
打开 Unreal 控制台
输入关卡切换命令并按 Enter 执行。
open LV_KinectTest进入测试关卡
用于动捕参数调整、普通模式核对与训练数据录制。
open MainMap返回游戏主地图
完成调试或数据采集后回到正常游戏流程。
02
测试模式界面
确认玩家追踪、预览画面与普通模式调试数据。
玩家状态：玩家未进入
红色状态文本表示 Kinect 尚未识别到玩家。请站在 Kinect 有效范围内，确保身体尽量完整出现在画面中，等待骨骼追踪稳定后再开始动作；可减少关节丢失和首次追踪抖动造成的误判。
中央预览区
中央白色区域为 Kinect 图像的显示位置。
普通模式的动作提示
按提示完成动作，并在动作最标准、最稳定的一帧保存文本框内调试数据，避免保存起始、结束或快速移动中的帧。
03
AI 模式与训练数据采集
正确录制动作片段，是提高识别稳定性的关键。
数据集保存位置
Saved/STGCNPPPoseAI/Dataset选择动作
在“当前动作”下拉框中选择本次录制的动作标签。
确认追踪
确认“玩家未进入”提示消失，身体与骨骼追踪稳定。
录制片段
点击开始记录，连贯完成一次目标动作后停止记录。
录制规则
- 每个动作类别至少采集 200 个片段，覆盖不同人物、速度、站位、朝向和左右手自然抖动。
- 每段数据只录制一个动作，不要把多个动作连续录入同一条样本。
- 录制前后保留少量静止时间，方便模型学习动作的开始与结束。
- 完成动作后立即停止记录；误录、空白过长或标签错误的片段建议删除，不纳入训练集。
模型识别信息
界面左下角会按分类头顺序显示：举手确认、向左滑动、向右滑动、胸前比 X 的置信度。模型以连续 100 帧姿态计算概率；最高值低于默认置信度阈值 0.65 时，视为未做出相应动作。若错误动作置信度更高，应补充不同站位、身高、速度与朝向的区分性样本。
04
测试关卡
专用于动捕参数调整、数据核对和训练样本录制。
Unreal Console
> open LV_KinectTest
进入后先确认玩家状态、中央预览区与骨骼追踪均正常，再开始调参或采集。完成测试后，打开控制台输入 open MainMap，即可返回游戏主地图。
05
需要提供的测试数据
请按识别模式整理测试结果，便于后续调试与 AI 模型训练调优。
普通模式每个动作相应的输出数据，使用表格记录；可提供多组以便调试。
AI 模式将
Saved\STGCNPPPoseAI 文件夹下全部文件压缩打包，用于 AI 模型训练与调优。