发布影片:什么变了,如何展示变化
宣传片推销产品;发布影片则向已基本熟悉产品的用户展示一个发布版本的增量变化。同一引擎,不同任务:之前的状态至关重要,每一个声明都限定在某个标签(tag)内,而该影片是系列中的一集。
此技能扩展了 site-promo-film(位于同级目录 ../site-promo-film/)。请先阅读其 SKILL.md:方向、外观、禁令、构建规则、画布陷阱、渲染前的静态帧、渲染和验证均保持不变。本文件仅说明发布影片增加的规程。
| 文件 | 说明 |
|---|---|
template/release.html | 引擎加上一个16秒的发布版演示:版本卡片 → 应用旧貌 → 工具栏中出现新控件并被点击(列表重新排序,行上移)→ 键帽快捷键打开一个新表面(一个弹出成面板的药丸)→ 其余更新日志 → 玻璃菜单中点击更新路径 → 回到版本卡片。一个文件同时支持宽屏和正方形布局;每个特色更改可拥有自己的灯光。 |
../site-promo-film/template/film.js | 舞台(子帧亚像素抖动:慢速移动无卡顿或闪烁)、FILM.draw 用于图标和符号、长片时间线、特效。模板加载它;其顶部及 site-promo-film §5 中有文档说明。 |
../site-promo-film/template/parts.js | 矢量部件:窗口、浏览器、终端、设备、键帽、开关、环形。 |
../site-promo-film/template/fx.js | 外观——背景、灯光、颗粒感、玻璃、点击波纹——与宣传片模板共享,由后者文档说明(其 §4)。 |
../site-promo-film/scripts/render.mjs、contact.mjs、beats.mjs | 渲染器、联系表、音轨节拍(site-promo-film §7,节拍),按原样使用:PAGE=release.html node render.mjs …。 |
../site-promo-film/scripts/clickcheck.mjs | 每个点击是否可见(§3b):相机静止且光标在页面每个 CLICKS 位置处静止。node clickcheck.mjs release.html,如果有点击不可见则退出码为1。 |
../site-promo-film/scripts/deliver.mjs | 将成品影片及其封面放入单独文件夹,待套件安全后将工作文件夹移至废纸篓(site-promo-film §8)。 |
将模板(或产品套件,§5)、film.js、parts.js、fx.js(以及 type.js 及其设置的字体,用于 type.js 样式中的标题)和四个脚本复制到工作文件夹的 src/,即 ~/Downloads/<产品>-<版本>-whats-new-work/src/(除非设置另有说明,~/Downloads 是工作根目录:见 site-promo-film,工作室部分),并在其中执行 npm i playwright-core。演示在8个工作线程上以16个子帧渲染耗时69秒,在 night 抖动外观下耗时171秒;测量为宽屏。
使用 ? 或 help 调用,或者对话中未提及任何发布版本时无参数调用:进入引导模式,见 ../site-promo-film/guide.md。它会询问版本并遍历需求,不进行渲染。工作室(site-promo-film,工作室)也会生成发布需求:kind: release,版本在 release.tag 中;它回答了 §1 的问题。
0 — 此版本有影片可做吗?
仅在用户要求制作影片时提出:发布命令不会主动提出,此处内容也不会主动建议。渲染遵循 site-promo-film §7 的默认热力规则。
- 根据标签构建列表,绝不用记忆:
git log --oneline <上一个标签>..<引用>、已合并的 PR、草稿发布说明。基于“我认为包含什么”制作的影片会展示一个遗漏的功能或上一个版本的功能。 - 当某人看到的或操作的内容发生改变时才符合条件:新表面、新控件、重新设计、新快捷键。修复、性能提升和内部改动不符合条件;用一行说明并停止。无内容可展示的版本影片仅是带版本号的标题卡片。
- 最多展示三个更改。 其余部分放入更新日志滚动区,从说明中逐字复制,或不放。展示五个更改意味着每个只占三秒,这就像幻灯片。
1 — 询问,然后等待
先查看:产品之前的影片(其套件,§5)、项目关于发布媒体存放位置的说明、以及其演示模式或测试夹具。套件或标签处源码中都没有的资产(如图标原始档案、矢量 Logo)需在同一条消息中询问,不得自行编造(site-promo-film §1)。然后一次性询问,每个问题附默认值:
- 要拍摄的发布版本和引用(默认值:标签;若尚未打标签则为
main,之后再在标签处重新检查)。 - 特色更改(默认值:我从日志中选择,每行说明为何展示效果好)。
- 时长(默认值:每个特色更改约6-8秒,加约3秒版本卡片,总计15-30秒;若有可见点击则翻倍,§3b)。时长30秒及以上并在 YouTube 发布的影片需分章节(§6);更短的影片无法分章:YouTube 要求至少三个章节,第一个从0:00开始,每个至少10秒。
- 格式:16:9 主版本(默认值),以及正方形裁切作为第二种布局。
- 外观(默认值:套件的;对于第一部影片,提供一张真实帧的外观表,如 site-promo-film §4 所述)。
- 存放位置(默认值:
<产品>-<版本>-whats-new/,按 site-promo-film §8 所述交付,仅包含成品影片和封面,其-work文件夹保留在工作根目录(默认~/Downloads);如果项目说明指定了发布媒体存放位置,则使用项目自有位置)。 - 音乐:默认无。发布片段自动静音播放,因此所有信息由文字承载。
然后,如果产品有套件(风格已定,仅内容需选择)则提供一个节拍网格上的故事板,如果是第一部影片则提供三个。等待通过。
2 — 素材来源:该引用处的应用
- 读取引用处的代码,而非工作树:
git show <引用>:<路径>。查看代码可获取字符串、符号、间距和颜色;项目的脚本截图(演示模式、夹具)提供比例。绝不使用包含真实数据的截图。 - 之前的状态来自上一个标签的源码。 凭记忆重建会在发布版本更改的细节上出错。
- 屏幕上的每个字符串都存在于该引用处:
git grep -nF -- '<字符串>' <引用>必须命中,包括 UI 文本、菜单项和键帽上的快捷键(grep 绑定,而非文档)。使用源语言拍摄影片。 - 标题是发布说明中的收益表述,几个词:不是 PR 标题,也不是发布版本未包含的内容。它们是公开声明。
- 默认关闭的更改需要在屏幕上显示其开关。 否则影片会宣传用户找不到的功能。
3 — 故事板模式
- 以版本卡片开始和结束:图标、名称、“X.Y 中的新功能”、版本号以强调色显示。它是第0帧和最后一帧,循环点两侧各持续约1.5秒。
- 原地变化。 先展示之前状态的表面一拍,然后让变化在它之上发生:控件出现在工具栏中,列表重新排序,面板增加一个区域。无需前后标签或分屏:过渡本身就是解释。变化落地时镜头推近,使用时拉远。
- 新表面从其触发物中生长出来:点击、菜单项、快捷键。快捷键以标题槽位中的键帽形式显示,在表面响应的节拍上按下。
- 一个特色更改,一个标题,一个交互。 标题在变化落地时出现,而不是之前:观众先看到,然后阅读是什么变化。
- 章节可以拥有专属颜色。 对于有灯光的外观,外观的
keys在每个特色更改落地时重新着色,并在版本卡片处恢复第一种颜色,就像演示所做的那样。如果产品颜色具有特定含义(如账户、状态),则省略此功能。 - 其余更新日志作为标题槽位中的简短滚动条,包含标签(“同样在 X.Y 中”)和三到五行从说明中逐字复制的文本,每拍一行。仅当其余内容值得列出时使用。
- 以实际点击的更新路径结束:产品自身通往新版本的路径(检查更新…菜单项、商店按钮、网站 URL)。然后 UI 折叠回图标。在菜单中,高亮行是光标在该瞬间所在的行,根据光标自身轨迹计算,因此划过行时会像真实菜单一样点亮。
- 无进度条、章节计数器或“NEW”徽章:标题更改本身就是章节分隔符。
- 原地变化是标准模式,而非唯一模式。 如果套件的上一部影片已使用此模式,则需变化:说明进入其描述的屏幕、使用3D深度的变化表面、同一帧上的前后
擦除、新流程的教程。site-promo-film §2 有目录;发布影片选用其中一种并在此故事板中说明。 - 重大发布版可制作长片(1-3分钟,每个特色更改一个章节,非循环),使用 site-promo-film §2b 的时间线,同时保留用于社交媒体的短片。
3b — 每个点击都可见
发布影片以点击为主,每次点击都是观众必须看到的节拍。一段30秒的片段曾因移动过快且部分点击缺失而导致问题。测量发现:两次点击发生在帧以1255和1414 px/s移动时,且多数落在距目标20-45 pt的静止光标上。按照以下规则计时的60秒片段测量到每次点击均在2 px/s和1 pt以内。
- 相机在点击前就已到位。 在点击之前至少提前约1.3秒开始相机移动,并仅在 UI 响应后才继续移动。
- 光标在按下前静止:每次移动用约两秒,使用慢弹簧(横向阻尼 0.85,纵向 0.75;短距离跳跃可更快),使其静止半秒。
- 停留至按下结束,保持足够长的时间可见(按下0.05秒,0.14秒后释放),并带有更大的环形;下次移动不早于按下后0.3秒开始。
- 点击打开的内容绝不覆盖被点击的对象:面板从其项目下方下拉,窗口从其来源通知旁边增长,面板在按钮按下后0.15-0.2秒关闭。首个60秒主版本在按下时在点击项上方生成外壳并隐藏它;精确时间点的静态帧从未显示它,而从 mp4 中抽取的帧则显示。
- 检查验证:在开始前运行
node clickcheck.mjs release.html(它测量相机在点击点上的位置、按下前的移动和按下期间的运动;两个模板均通过),渲染后从 mp4 中抽取每个点击时间的帧(site-promo-film §7)。 - 在 iPhone 或 iPad 上(需求中的
frame,site-promo-film §0),点击即为轻触:不绘制箭头,手指仅在轻触时显示(一个按下的软盘,带有外观的波纹)。页面仍声明CLICKS,curX(t)/curY(t)为手指位置:它们在轻触点之间跳跃,并在每次轻触前后保持静止,因此clickcheck.mjs测量轻触与测量点击完全相同,且无CLICKS的页面仍会以退出码2结束。上述规则及相机规则均适用。
4 — 布局:一个槽位和一个自由区域
模板自动计算相机而非手动调整。fit(rect, head) 返回使世界矩形填充自由区域(宽屏时在标题槽位旁边,正方形时在其下方,或无标题时整个帧)的相机,受限于 zmax。三条规则,在构建演示时测量:
- 有标题时,特写镜头会延伸到表面自身在槽位侧的边缘(
toEdge)。仅适配细节,窗口其余部分滑到标题下方,标题则一半位于画布上,一半位于暗色窗口上。 - 正方形中,特写镜头保持表面的完整宽度,否则行标签会在帧的两侧被裁剪。
- 离开标题绘制在变形形状下方,因此窗口在其上方生长。如果绘制在其上方,其淡出的字母会在半个秒内印在窗口上。
第二种宽高比是第二种布局,绝非第一种的裁剪:页面读取 location.hash,而 PAGE='release.html#square' 通过 render.mjs 传递哈希。哈希也可通过 & 连接以接受外观:PAGE='release.html#square&look=night'。
5 — 套件:同一产品的每部影片看起来像同一系列
产品的第一部影片(或其 site-promo 影片)会产生一个套件:字体、颜色令牌、矢量图标、版本卡片、窗口边框、相机语言、外观(其预设和覆盖:一行 FX.look)。在销毁工作文件夹之前,将其提交到产品中,放在其说明指定的位置(否则建议一个位置,目前为 scripts/film/),以便下一个发布版本从套件而非模板开始:一个故事板,仅内容变化,且系列可识别。版本卡片上仅数字变化。
套件保存的是页面,而非引擎。 引擎是本技能的,为每部影片重新复制。页面是工作成果:产品的矢量表面、从标签处获取的每个字符串、经受住评审轮次的时序、以及关于这些轮次教训的 README。保存它是为了下一部影片仅更改内容,并使已发布的影片可以在几分钟内重新剪辑(改写字符串、制作9:16版本、另一张海报)而无需重建。是否保存:
- 每个发布版本都制作影片的产品保留其套件,在其自有仓库中。
- 公共仓库除非用户同意否则不保留任何内容:套件会发布引擎和字体的副本,其许可证必须随行。询问;不要提议。
- 一次性影片在交付时询问。 用户看到要删除的内容列表后,回答“否”则执行
deliver.mjs trash --discard。 - 套件中不包含图片:符号和图标由其 README 中的命令生成或复制,并被忽略(因此无需优化图片)。
在 film.js 之前制作的套件在其下一部影片前需进行四次编辑,否则会保留已修复的闪烁问题