用途
Game Video Ad Pipeline 是一个用完全本地、免费工具生成游戏推广视频(短视频 / 广告素材)的技能,主要用于快速产出游戏广告创意视频。
主要能力
- 输入
--game-id(Steam app id)后自动收集游戏截图。 - 对图像 / GIF 做画面比例归一化。
- 应用模板样式并叠加文字,输出 15~30 秒 MP4。
- 输出分辨率支持竖屏 1080x1920 或横屏 1920x1080。
- 完全本地运行,无外部付费 API,可在 MiniPC 上执行。
- 文本叠加通过 Pillow(PIL)渲染,因此在缺少 ffmpeg drawtext 的环境中也能工作。
模板系统
技能内置三种模板:
| 模板 | 基调 | 默认文案 |
|---|---|---|
| action | 高饱和 / 高对比,强调冲击感 | Play Now |
| puzzle | 明亮干净的调性 | Challenge Your Brain |
| idle | 柔和稳定的调性 | Start Your Idle Journey |
所有模板均以 ffmpeg filter 链实现,在 MiniPC / CLI 环境下行为一致。
核心管线
- 从 Steam 商店 HTML 中提取截图 URL(无需密钥、无需付费)。
- 将图像 / GIF 归一化到目标分辨率(竖屏 / 横屏)。
- 生成每个镜头的片段后再拼接(concat)。
- 叠加标题 / 标语 / CTA 文字。
- 输出 MP4(H.264、yuv420p、faststart)并验证可播放性。
使用方式
基本用法(竖屏):
cd misskim-skills
python3 skills/game-video-ad-pipeline/scripts/generate-video.py \
--game-id steam:570 \
--template action \
--orientation vertical \
--duration 18 \
--output skills/game-video-ad-pipeline/output/dota2-action-vertical.mp4
横屏广告(1920x1080):
python3 skills/game-video-ad-pipeline/scripts/generate-video.py \
--game-id 730 \
--template puzzle \
--orientation horizontal \
--duration 20 \
--output skills/game-video-ad-pipeline/output/cs2-puzzle-horizontal.mp4
使用本地图片 / GIF 文件夹作为输入:
python3 skills/game-video-ad-pipeline/scripts/generate-video.py \
--game-id 999999 \
--input-dir ./my-assets \
--template idle \
--duration 15
参数说明
--game-id(必填):如570或steam:570。--template:action|puzzle|idle。--orientation:vertical|horizontal。--duration:15~30 秒。--max-shots:使用的截图数量(默认 6)。--title、--tagline、--cta:直接指定叠加文案。--input-dir:用本地媒体替代 Steam 自动收集。--keep-temp:保留中间文件以便调试。
目录结构
game-video-ad-pipeline/
├─ SKILL.md
├─ scripts/
│ └─ generate-video.py
└─ references/
├─ RESEARCH.md
├─ AUDIT.md
└─ TEST_REPORT.md
适用场景
- 需要低成本、批量生成游戏推广短视频 / 广告素材。
- 在本地或 MiniPC 等资源有限环境中进行视频渲染。
- 已有本地图片 / GIF 素材,想直接生成广告视频。
限制与安全 / 运维说明
- 依赖 ffmpeg:执行前需确认 ffmpeg、ffprobe 存在。
- 不调用外部 LLM / 付费 API。
- 批量处理时建议将
--max-shots保持在 4~8 之间。 - 详细依据见 references/RESEARCH.md、references/AUDIT.md。
- 关于价格、具体收费方案、平台支持范围等更多信息暂未提供。