让角色动起来
将视频中的动作应用到 3D 角色。
主要功能
用视频中的动作制作角色动画，预览效果后录制或导出。
选择捕捉范围
仅捕捉身体动作，或同时捕捉手部动作。
选择镜头视角
通过正面、侧面或自由视角查看角色动作。
预览并保存
检查结果、保留原声、录制视频，或保存动画文件。
素材与产出
从动作捕捉到本地预览、镜头调整和导出，每一步都可以单独检查。
输入
- 动作来源主体清晰可辨的视频
- 目标角色可选：已绑定骨骼的 GLB/FBX；也可使用内置默认角色
- MMD 工作流使用 MMD 流程时，提供 PMX ZIP 模型包和 BVH 动作文件
- 创作要求说明捕捉身体还是同时捕捉手部，并按需提供镜头要求
输出
- 预览器Three.js 预览器，支持电影式镜头，以及全身、侧面和自由视角
- 动画带动画的 GLB、原始 BVH，以及修复后的目标骨骼 BVH
- 录制视频带原声的 MP4，或当前浏览器支持的 WebM 视频
- 项目本地项目配置、镜头序列与任务记录
运行环境需要已安装该技能的电脑，以及较新的 Chrome 或 Edge 浏览器。部分在线动作捕捉服务可能需要 V2Fun 账号与积分；本地预览无需使用这些服务。
使用 V2Fun Animation 制作
捕捉视频动作并生成角色动画，在本地 Three.js 预览器中查看效果。
使用流程
准备素材、选择角色、检查动作，最后导出结果。
- 01
添加视频
添加视频，说明要捕捉哪个人物或哪段动作。
- 02
选择角色
使用内置角色，或提供已经绑定骨骼、可用于动画的 3D 角色。
- 03
生成并检查动作
选择仅捕捉身体，或同时捕捉身体和手部。先查看费用并确认，再执行付费任务，完成后在预览器中检查动作。
- 04
调整并导出
校正脚部接地情况、调整镜头并检查动作，再录制视频或导出 GLB/BVH 文件。
快速开始
先下载 Skill、检查本地环境并创建项目，再按需使用付费动捕服务。
gh repo clone V2Fun-Research/v2fun-animation ~/.codex/skills/v2fun-animation
cd ~/.codex/skills/v2fun-animation
python3 scripts/v2fun.py doctor --project /tmp/v2fun-animation-project用 $v2fun-animation 处理我的视频。
如果我没有提供角色，请使用内置角色。捕捉身体和手部动作，并使用简单的镜头运动预览结果。
任何付费步骤开始前，请展示服务、预估积分、余额和需要的确认。你将获得可在本地浏览器中使用的动画预览器，支持检查动作、调整镜头、同步原声、录制视频，以及导出 GLB 或 BVH。
使用要求与限制
开始前，请确认所需素材、运行环境，以及需要手动检查的环节。
使用要求
- 已安装该技能的电脑、Python 3.9 或更新版本、Node.js，以及较新的浏览器。
- 准备人物清晰可见的视频。若使用自己的角色，请提供已正确绑定骨骼、可用于动画的 GLB 或 FBX 模型。
- 调用付费动捕或 API 服务时，需要已授权且积分充足的 V2Fun 账号。
使用限制
- 部分动作可能出现脚滑、悬空或轻微穿地。接地校正可以减轻这些问题，但仍需检查实际效果。
- PMX/MMD 角色通常需要额外转换与设置。为获得更好的兼容性，建议尽量使用已绑定骨骼的 GLB 或 FBX 角色。
- 用自然语言描述的镜头运动可能需要微调，请在预览中确认效果。
- 再次分发内置角色和示例素材前，请确认相应的使用与再分发授权。
常见问题
了解素材准备、动作捕捉、费用和导出文件。
必须提供自己的角色吗？
不必。可以先用内置角色试用。若要驱动自己的角色，请提供已绑定骨骼的 GLB 或 FBX 模型。
可以捕捉手部动作吗？
可以。你可以只捕捉身体，也可以同时捕捉身体和手部，完成后在预览中检查手部动作。
需要付费吗？
本地预览、镜头调整、录制和导出不需要新建付费动捕任务。远程动捕或其他 API 服务可能消耗 V2Fun 积分，相关费用会在任务确认前展示。
可以使用 PMX 角色吗？
PMX/MMD 角色通常需要额外转换与设置。为获得更好的兼容性，建议尽量使用已绑定骨骼的 GLB 或 FBX 角色。
可以获得哪些文件？
具体取决于所用流程，可导出带动画的 GLB、BVH 动作文件；浏览器支持录制时，还可保存带原声的视频。
继续了解
查看开发者资源、其他 Skills 和 API 接入方式。
