桌面口播 · Mac 窗口动效

参数一览

• canvas：固定 1440×1080 / 30fps；duration = 口播完整时长（秒）。
• speaker：video（口播视频，可省略→灰色剪影占位）、crop{x,y,w,h}（裁掉烧录字幕等）、title（摄像头窗口标题）、home。
• subtitles、keywords（字幕中黄色高亮的词）。
• theme：mode light/dark/black/red/warm；颜色 yellow(高亮) red green white text dark；modes.* 每种壁纸的配色和 glow；font。
• desktop：menuApp、menus[]、clock、nowPlaying、icons[{type,label}]、dock[]、calendar{wd,day}。
• layouts：right / avatar / topright / center / left / centerSmall / corner 人物框。
• rules[type]：layout、bg、graphic（推荐效果）、sfx（whoosh|boom）、punchIn、moveT。
• sfx：enabled（开/关）、level（音效相对人声音量，默认 0.35）。
• 名片 / CTA：follow 效果的 initial、name、bio、buttonLabel、doneLabel、group；结尾 grid_title 的 kicker/title/sub/stampText。

效果与字段（beats[].effect）

splitflap(title,tag,words[2],sub) · stamp(text,stampText,winTitle) · popups(title,icons[],verb,winTitle) · flowchart(nodes[3],footer,winTitle) · highlight(line1,key) · textwall(rows,key) · punchline(style flap|reject|thesis, kicker,text,struck,line,color,stampText,stampColor,stampAt,cw,stampDx) · card(title,lines[]) · approve(text,stampText) · grid_title(kicker,title,sub,stampText,cw) · thought(kicker,steps[],at[]) · equals(left{tag,text},right{tag,text},result) · points(title,video,labels[],result,resultAt) · calendar(title,kicker,result) · crosslist(title,kicker,sub,items[],at[]) · versus(left,right,rightAt) · story(title,kicker,text) · counter(title,beforeLabel,before,beforeNote,afterLabel,after,afterAt,big,ratio,ratioAt) · parallel(title,aiText,meText,tasks[],taskAt) · chat(title,me,reply,replyAt,note) · timer(title,value,unit,caption,stampText,stampAt) · follow(见上)。

渲染

环境：Node 22+、ffmpeg/ffprobe、python3+numpy、Chromium headless shell（CHROME_PATH 或 Playwright 缓存）、系统字体 Noto Sans CJK SC。

cd src && npm ci && cd ..
node src/render.js /path/to/instance/inputs.json /path/to/instance/out.mp4          # 成片
node src/render.js /path/to/instance/inputs.json /path/to/instance/out.mp4 --stills 1,4,8   # 静帧检查

输出 H.264 High、yuv420p（TV range, BT.709）、avc1、faststart、AAC 192k 48kHz；人声 + 音效响度归一到约 −14 LUFS。中间文件写在 out.work/。

MotionGit 内置 html-canvas/1 路线：window.renderFrame(整数帧, inputs) 已实现，可渲染画面（占位人物）；但真人视频帧与原声需要 src/render.js 适配器，内置路线不会带入人声和音效——此点尚未在官网个人下载包中实测。

已验证范围

Debian 13 / Chrome headless shell 145 / Node 24 / ffmpeg 7.1：默认预设（占位人物）与改参数实例（暗色、换色、真实视频输入+裁切、音效音量）各 14 秒成片。未测：Windows、macOS、竖屏、官网内置渲染器。