1
本项目旨在解决 3D 游戏角色舞蹈视频制作流程割裂的问题。
传统做法需要在游戏、建模软件、视频剪辑软件之间反复切换，
一个完整的舞蹈视频往往需要数小时手工操作。
本项目整合了 MMD 动作导入、骨骼映射适配、逐帧渲染、
视频合成、音频对齐五个环节，把原本分散的人工流程
自动化为一条可复用的管线。
应用场景为 3D 内容创作者的日常素材生产，典型用户是
游戏 Mod 社区的内容作者和虚拟主播运营者。目前该工具链
已产出多支成品舞蹈视频，单支时长 1-4 分钟。
本项目由五个可独立运行的功能模块组成。
一、动作导入模块：解析 MMD 的 VMD 二进制文件，
提取骨骼关键帧与表情数据，完成与目标模型的骨骼映射适配。
二、渲染管线：基于 Blender Python API 批处理渲染，
支持卡通着色、多光源布光、材质后处理等参数化配置。
三、视频合成模块：调用 FFmpeg 将渲染帧序列编码为视频，
自动对齐帧率与分辨率。
四、音频处理模块：完成音视频时长对齐、
裁剪多余尾帧、合并音轨。
五、录制监控模块：实时扫描帧文件目录，
反馈录制状态，异常时自动报错。
各模块之间通过约定的文件目录结构解耦，
可以单独替换或扩展。
本人独立承担了该工具链的架构设计、编码实现与调试优化全流程。
技术栈：Python 3.11、Blender 4.2 Python API、FFmpeg、PowerShell。
实现亮点与难点：
一、VMD 二进制解析
MMD 的 VMD 文件头部结构不规范，不同作者导出的偏移不一致。
通过扫描二进制特征字节自动定位骨骼数据起点，
解决了标准解析器读不出数据的问题。
二、渲染帧率稳定
逐帧渲染时，动作播放速度与渲染进度容易脱节。
通过分离渲染时钟与动画时钟，保证每一帧都精确对应关键帧。
三、编码进程假死排查
视频合成调用外部编码器时，出现过进程存活但 CPU 与输出文件
均停止增长的情况。通过采样 CPU 时间与目标文件大小双重判定，
区分"真卡死"与"低速编码"，避免误杀正常进程。
四、音视频时长对齐
舞蹈动作与配乐时长常常不一致，尾部出现静止画面。
通过读取动作帧数与音频采样数的精确值，
计算裁剪点并自动裁掉多余尾帧。
评论