将动作变为游戏
用视频或现有动画中的舞蹈动作搭建游戏。
主要功能
把舞蹈动作、音乐节拍、操作反馈和可定制的 3D 舞台组合起来，制作一款浏览器节奏游戏。
匹配音乐节拍
设置节拍、方向提示和判定时机，引导玩家跟随节奏操作。
选择游玩模式
提供简单、挑战和演示模式，适合不同玩法。
支持不同设备
电脑使用键盘操作，手机与平板使用触屏操作。
素材与产出
准备视频、角色和音乐，再按需要设置玩法。
输入
- 舞蹈来源视频、可复用的 BVH，或带骨骼与动画的模型
- 角色已绑定骨骼的 GLB，或内置默认角色
- 音乐原视频音频，或独立音乐文件
- 游戏设置游戏模式、舞者数量、视觉风格和交付要求
输出
- 游戏源码可编辑的 Three.js 源码，包含玩法、舞台、角色适配和界面
- 静态网页文件仅打包项目清单中声明文件的静态版本
- 游玩模式简单、挑战和演示模式，包含得分、连击、暂停、结算与重新开始
- 可选线上版本选择发布游戏后，可获得分享链接
运行环境支持较新的桌面或移动浏览器。准备本地项目需要 Python 3.9 或更新版本、Node.js 18 或更新版本；在线动作服务可能需要 V2Fun 账号与积分。
使用 V2Fun Dance Game 制作
内置离线示例包含舞蹈动作、音乐和计分功能，可在电脑或触屏设备上体验完整游戏。
使用流程
选择素材、设置游戏、调整节拍，并在目标设备上测试。
- 01
准备素材
使用自己的视频和角色，也可以选择内置素材或将两者搭配使用。
- 02
设置游戏
检查角色动作、音乐、操作方式，以及希望支持的设备类型。
- 03
调整节奏
调整节拍、方向提示、判定时间范围、游戏模式和舞台效果。
- 04
试玩与检查
测试键盘和触屏操作、声音、计分、暂停、结算与重新开始，并检查手机上的显示效果。
快速开始
下载 Skill 并创建本地游戏项目，再定制音乐、角色和操作方式。
gh repo clone V2Fun-Research/v2fun-dance-game ~/.codex/skills/v2fun-dance-game
cd ~/.codex/skills/v2fun-dance-game
python3 scripts/scaffold.py /path/to/default-game --use-defaults --three-dir /path/to/three-package用 $v2fun-dance-game 处理我的舞蹈视频和角色。
制作包含简单、挑战和演示模式的浏览器节奏游戏。
任何付费动作服务开始前，请展示服务与预估积分。你将获得可编辑的浏览器节奏游戏，包含同步的动作与音乐、节奏操作、计分和结算，并适配电脑和移动设备。
使用要求与限制
了解运行环境，以及角色、设备、浏览器和音乐文件对游戏效果的影响。
使用要求
- 安装 Python 3.9 或更新版本、Node.js 18 或更新版本及较新浏览器的电脑。
- 舞蹈视频与可播放动画的角色，或选择使用内置默认素材。
- 音乐或视频音频。若计划支持手机，请在目标手机与浏览器上测试游戏。
使用限制
- 自定义角色需要使用兼容的骨骼，并非所有模型都能自动修复或转换。
- 节拍时机会先通过估算确定；如果方向提示与音乐对不齐，需要手动微调。
- 不同浏览器与设备的声音播放、录制、性能和触屏响应可能存在差异。
- 仅使用已获授权、可纳入游戏的音乐、角色模型与视频素材。
常见问题
了解素材选择、手机游玩、动作捕捉费用与浏览器声音播放。
必须同时上传视频和角色吗？
不必。可以同时提供视频和角色，也可以只提供其中一种，另一种使用内置素材。还可以直接用内置素材体验完整演示。
可以使用已经带动画的角色吗？
可以。如果角色已有可正常播放的动画，就能直接使用，再添加音乐或使用视频原声。
可以在手机上玩吗？
可以。游戏包含触屏方向按钮和节拍确认按钮。建议使用较新的手机与浏览器；声音和节拍表现仍可能因设备而异。
动作捕捉一定需要付费吗？
不一定。使用内置动作或已有的兼容动画，不需要新建动捕任务。新建 V2Fun 动捕任务可能消耗积分，相关费用会在任务确认前展示。
为什么有时音乐不会立即播放？
部分浏览器会在用户操作页面前阻止声音播放。遇到这种情况，请先点击一次声音按钮，再重新开始游戏。
继续了解
查看开发者资源、其他 Skills 和 API 接入方式。
