showcase-video

展示视频

一个 Mod 只有在能用 30 秒展示出来时，才算完成。工具链包括 um win record（采集）、 um video contact（查看）、um video compile（剪辑），全部基于 ffmpeg + Pillow。

1. 让拍摄可重复

• 编排动作。 使用 Mod 端时间线或命令序列（生成敌人、发射武器、提示 Boss 登场）、带触发器和镜头移动的场景，或 WinDrive 命令列表。首次拍出干净的片段后，应能精确复现，这样修复问题后就能重新拍摄。
• 每次拍摄前还原世界。 爆炸会在世界中炸出坑洞，单位也会死亡。用 um backup 保留一份原始副本，并在每次拍摄前还原。
• 画面整洁。 隐藏调试文本，调整镜头缩放（Terraria 展示采用了 1.5x，这样 1080p 画面看起来就像 720p 剪辑），取消焦点时以全速运行，并隐藏光标（采集时使用 capture_cursor=0）。

2. 录制窗口和游戏自身音频

um win record --exe Game.exe --out C:\caps\take1 --seconds 40      # -> take1.mkv, take1.audio.raw, take1.json
um video first-frame C:/caps/take1.mkv                              # where gameplay starts (skips loading screens)
um video mux C:/caps/take1.mkv C:/caps/take1.audio.raw C:/caps/take1.json take1.mp4 [--offset 0.25]

• 视频： 使用 ffmpeg gfxcapture 仅采集该窗口（GPU 帧，不含桌面）。条件允许时使用 NVENC、AMF 或 QSV 编码。NVENC H.264 的最大宽度为 4096 px，因此录制器会缩小超出此宽度的画面；对于 32:9 屏幕，可用 --crop 裁剪出居中的 16:9 画面。
• 音频： 对游戏 PID 使用 WASAPI 进程回环（um/ps1/ProcLoopback.ps1）。只录制游戏声音，不录 Spotify 或通知音。音频带时间戳，因此文件位置对应墙上时钟时间。混流时会使用录制的偏移量。可用视觉／音频同步事件（如闪光与爆炸声）微调，并传入 --offset。
• 在 Mod 内录制（可选）： 从 Mod 内启动和停止录制，以精确到帧地拍摄。停止 ffmpeg 时，绝不要阻塞游戏主线程：发送 q，然后在其他线程等待。写入 .mkv，这样即使录制器被强制终止，文件仍可播放（参见 examples/terraria-tmodloader/reference/InModRecorder.cs）。

3. 剪辑前先查看

um video probe clip.mp4
um video contact clip.mp4 sheet.png --every 1.5 --cols 6     # a timestamped grid; read it, pick in/out points
um video contact clip.mp4 zoom.png --start 20 --end 30 --every 0.5

挑选精彩时刻：爆炸、Boss 登场、编队中的单位。将入点／出点时间写入 EDL。

4. 使用 EDL 剪辑

um video compile edl.json out.mp4（--preview 会以半尺寸快速渲染）。完整格式请参阅 um video --help。

{
  "size": [1920, 1080], "fps": 30,
  "theme": {"accent": "#B6FF3B"},
  "transition": {"type": "fade", "duration": 0.3},
  "clip_volume": 0.8,
  "music": {"path": "music.mp3", "volume": 0.5},
  "watermark": {"path": "logo.png", "height": 54, "corner": "br"},
  "segments": [
    {"clip": "take1.mp4", "in": 9.0, "dur": 3.0, "hook": "Terraria, but with a tactical nuke."},
    {"clip": "take1.mp4", "in": 24.2, "dur": 4.5, "title": "Tactical Nuke", "transition": {"type": "pixelize"}},
    {"clip": "take2.mp4", "in": 3.0, "dur": 5.0, "title": "Drone Mothership boss"},
    {"card": {"title": "Fal Arsenal", "sub": "a Terraria mod"}, "dur": 2.5}
  ]
}

• 转场： 可使用任意 ffmpeg xfade 类型（fade、pixelize、slideleft、smoothleft、circleopen、zoomin、 radial……）或 cut。
• 填充： 对于非 16:9 的片段，可使用 fill: blur（模糊背景）、crop 或 pad。
• 单个片段： 使用 speed 和 volume 调整速度和音量，用 zoom 放大以避开界面，用 crop [x, y, w, h] 重新构图。
• 音乐： um fal music "..." --seconds 60 可生成背景音乐。设置 bpm，并用 beats 替代 dur，即可按节拍剪辑；um video beats music.mp3 可估算节奏和第一个节拍。

经实际反馈验证的有效风格

• 标题： 用一行文字说明画面内容（“Wonder：Transamerica Pyramid”、“Robotaxis and Delivery Drones”）。不要添加说明制作方式的小字字幕；相关内容应放在发布文案中。
• 节奏： 在 2–3 秒内进入游戏画面；菜单和准备过程控制在 3 秒以内。每个片段保持 3–5 秒。结尾显示 Mod 名称或 URL，然后淡出。
• 声音： 保留游戏音频，它能增强冲击感。合集视频中可加入背景音乐，片段音量保持在 0.5–0.8 左右。
• 合集使用他人片段： 在画面中（credit: "@handle"）和发布文案中注明每位创作者；用于推广时应征得许可。不要暗示他们的片段是用你的工具制作的。只下载公开发布的内容，且仅下载会用到的片段。
• 最后一步： 分享前先查看成片的缩略图联系表。