🎬 Mocap.js - 动作捕捉系统

一个轻量级的 JavaScript 动作捕捉库，利用 AI 技术将普通摄像头变成专业的动作捕捉设备。

📂 项目结构

ai/
├── VERSION_INDEX.html          # 版本中心（版本选择和功能对比）
├── 1.0/                        # v1.0 - 单人版本
│   ├── mocap_single.html       # 单人动作捕捉主程序
│   └── mocap_export_glb.html   # 备用版本
└── 1.1/                        # v1.1 - 多人版本
    └── mocap_multi.html        # 多人动作捕捉主程序

🚀 快速开始

方法 1：打开版本中心

浏览器打开 VERSION_INDEX.html 选择版本：

• 单人版 (v1.0)：适合个人项目和单人捕捉
• 多人版 (v1.1)：支持多人同时追踪

方法 2：直接打开版本

• 单人版：1.0/mocap_single.html
• 多人版：1.1/mocap_multi.html

📋 版本对比

功能	v1.0	v1.1
单人捕捉	✓	✓
多人捕捉	-	✓
自动人物分离	-	✓
颜色区分	-	✓
3D 骨架显示	✓	✓
GLB 导出	✓	✓
实时 FPS	✓	✓
最大人数	1	8+

✨ 主要功能

v1.0 - 单人版

• 🕺 单人骨架追踪：追踪 33 个人体关键点
• 🎮 3D 实时显示：实时展示 3D 骨架模型
• 💾 GLB 导出：导出为行业标准的 3D 模型格式
• 📊 性能监控：实时显示 FPS 和捕捉统计

v1.1 - 多人版

• 👥 多人同时追踪：支持同时捕捉多个人
• 🔄 自动人物分离：自动识别和分离不同人物
• 🎨 颜色标记：使用不同颜色区分人物
• 💾 完整导出：导出多人合并模型或单人模型
• ⏱️ 生命周期管理：自动清理长时间无检测的人物

🎯 使用场景

v1.0 适用于：

• 个人动作分析
• 创意编程项目
• 运动技能评估
• 虚拟形象制作

v1.1 适用于：

• 舞蹈排练和录制
• 多人交互项目
• 群体姿态分析
• 协作动作捕捉

📖 使用说明

基本步骤

1. 打开应用

   • 在浏览器中打开对应版本的 HTML 文件
   • 允许摄像头访问权限

2. 开始捕捉

   • 点击"开始捕捉"按钮
   • 摄像头会开始追踪身体关键点

3. 查看结果

   • 左侧：实时摄像头视频
   • 右侧：3D 骨架模型
   • 底部：实时统计数据

4. 导出模型

   • 点击"导出 GLB"按钮
   • 将当前姿态保存为 3D 文件

技术规格

• 关键点：33 个人体关键点（包括头、躯干、四肢）
• 输出格式：GLB（二进制 glTF 格式）
• 3D 引擎：Three.js
• AI 引擎：MediaPipe Pose
• 支持浏览器：Chrome、Firefox、Safari、Edge

🔧 技术栈

• Three.js：3D 图形渲染
• MediaPipe：AI 动作检测
• GLTFExporter：3D 模型导出
• HTML5 Canvas：实时绘制
• WebGL：GPU 加速

🗂️ 文件说明

文件	功能
VERSION_INDEX.html	版本中心主页，展示各版本功能和对比
1.0/mocap_single.html	v1.0 单人捕捉程序
1.1/mocap_multi.html	v1.1 多人捕捉程序
1.0/mocap_export_glb.html	v1.0 备用版本

🌐 浏览器支持

✓ Google Chrome 70+ ✓ Firefox 70+ ✓ Safari 13+ ✓ Edge 79+

需要支持 WebGL、MediaDevices API、Web Workers

📝 导出文件

导出的 GLB 文件可以在以下应用中使用：

• 3D 建模：Blender、Maya、3ds Max
• 游戏引擎：Unity、Unreal Engine
• 网页3D：Three.js、Babylon.js
• 查看器：babylon.js Sandbox、glTF Viewer

🔜 计划功能

v1.2（计划中）

• FBX 导出格式
• USD/USDZ 导出
• 动画序列保存
• 帧序列导出

v2.0（计划中）

• 姿态识别
• 动作分类
• 动作库
• AI 推断系统
• 实时反馈

💡 使用建议

1. 光线：在光线充足的环境中使用，效果最佳
2. 距离：与摄像头保持 1-3 米的距离
3. 背景：单一背景效果更好（避免复杂背景）
4. 衣着：穿着贴身衣物便于关键点检测
5. 角度：正面或 45 度角效果最佳

🤝 版本管理

项目采用语义版本化：

• 主版本（1.x）：重大功能变化
• 次版本（x.1）：功能添加
• 修订版（x.x.x）：bug 修复

📄 许可证

MIT License - 欢迎用于教育、个人创作和科技竞赛

🙏 致谢

• MediaPipe：提供 AI 动作检测能力
• Three.js：提供强大的 3D 渲染引擎
• GitHub：托管和版本管理

❓ 常见问题

Q: 多人版最多支持多少人？ A: 理论上支持 8+ 人，实际取决于摄像头清晰度和计算能力。

Q: 导出的 GLB 文件可以在哪些软件中使用？ A: 任何支持 glTF 格式的 3D 软件，如 Blender、Maya、Unity 等。

Q: 能否在移动设备上使用？ A: 可以，但需要支持 WebGL 的现代浏览器。

Q: 捕捉过程中是否需要网络连接？ A: 初次加载需要下载模型文件，之后可离线使用。

---

开发版本：1.1 最后更新：2026年4月 作者：Mocap.js 团队