SuperAPI AI 工具集

game-video-ad-pipeline

设计与创作

查看项目

更新于 10-16 16:28

技能介绍

用途

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 环境下行为一致。

核心管线

  1. 从 Steam 商店 HTML 中提取截图 URL(无需密钥、无需付费)。
  2. 将图像 / GIF 归一化到目标分辨率(竖屏 / 横屏)。
  3. 生成每个镜头的片段后再拼接(concat)。
  4. 叠加标题 / 标语 / CTA 文字。
  5. 输出 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。
  • 关于价格、具体收费方案、平台支持范围等更多信息暂未提供。