The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.
动作脚本:决策记录与按需展开
阅读导航
- 普通创作:读“最小记录”和“时间约定”。
- 动作复杂或需要交接:选读对应的“展开模块”。
- 需要可直接改写的格式:用“可复制工作表”,删除无关部分。
- 需要理解粒度:看末尾两个填写例;更多表达方式见 正反例。
模板的边界
脚本应减少执行歧义,不替代导演判断。必需的是能回答相关决策问题,不是填写固定字段。一个简单镜头可以写成几句话;复杂段落可用时间表、对象状态表或 YAML。不要输出全部空表,不要求每帧记录。
先决定内容与表达方法,再挑字段。不要因为有“触发”“承接对象”字段,就凭空增加点击、光标、物体飞行或无缝转场。多镜头、单镜头、固定机位和非线性叙事都兼容。
最小记录:每个有独立职责的段落回答这些问题
| 决策 | 要明确什么 | 可接受的简写 |
|---|---|---|
| 意图与依据 | 观众应理解、感受或注意什么;涉及事实时依据是什么 | “感到安静与精密;不声称性能提升” |
| 可见/可听的表达 | 什么真的发生了;变化如何使理解、期待或感受发生发展,而不只是元素入场 | “一道光掠过壳体,显露接缝,机位不动” |
| 时间组织 | 大致时长或事件锚点,哪些先后、重叠、停顿;什么必须被读清 | “接缝显露后才出现型号,停留到读清” |
| 上下文关系 | 如何承接或切断前后段落;单段可省略 | “形状呼应后直接硬切,不模拟同一空间” |
| 验证 | 看哪段、观察什么才知道设计成立 | “正常速度能看出材质变化,文字不被扫光遮挡” |
关键表达可用“起先观众看到/预期什么 → 实际发生什么 → 因而理解/感到什么”检查逻辑;这不是必须采用的三段时间结构。若是产品功能,注明动作展示的是实际行为还是概念说明。不要把这个问题变成固定的混乱—整理、点击—结果或前后对比套路。
对象身份、精确坐标与缓动仅在存在相关歧义时补充。全片共享的规则只记录一次,镜头只写例外。
强 Motion 的关键事件写到足以区分两种不同观看结果:起初能看见什么、主体改变了哪种关系、变化在哪一刻最清楚、最后如何落定或退出。“翻开”“依次展开”“镜头后退”仍有歧义时,补充转轴与退出方向、真实遮挡与独立裁切的分工,或主体动作与镜头变化的先后。只展开影响实现与观感的决定,不把所有动作强制写成同一种相位或参数表。
全片层记录
用短文或表格记录以下与本次任务相关的内容:
- 简报:受众、信息优先级、时长/比例、品牌、声音、事实与素材约束。
- 创意主线:为何使用这种动态表达,它与素材有什么关系。
- 时间结构:段落目的、预计区间或事件、信息密度与能量变化。可以恒定、突变、循环或递进,不强制高潮曲线。
- 运动语言:动作的性格与选择理由,主要注意力如何分配,哪些保持稳定。参数范围可在原型后确定。
- 素材与风险:真实界面、概念示意、占位内容、待验证技术能力。
全片概览中的段落不必等长;“开场—痛点—功能—结果—CTA”只是可能结构,不是默认表头。
时间约定
- 同一记录中明确使用全片时间还是段落局部时间。混用时写出 offset。用事件锚点也可以,例如
旁白说到“找到”时。 - 计划阶段用区间、相对关系或锚点;实现阶段再绑定实际素材、时间线与帧率。不要提前用虚假精确的毫秒掩盖未做的决定。
- 区分动作时间、可读时间和有意静止;文字完成入场不代表读完。按语言、字数、字号、屏幕尺寸与观看环境验证,不套固定阅读公式。
- 用
with / after / before / overlap / at或自然语言说明关键关系。顺序与重叠都可以成立;若观众必须看清因果,不能为“更丝滑”过度重叠。 - 多个动作同时发生时,说明注意力如何分配。并行比较也可能需要两个等重要对象,不能机械强制只有一个主体。
- 使用音乐节拍时,按原始节拍索引映射到帧,避免逐次累加舍入误差。不是所有动作都要踩拍,内容与理解可以优先。
展开模块:只选需要的部分
A. 对象、状态与空间
用于聚合、拆解、形变、产品操作、图解或跨镜头追踪。
| 对象 ID | 信息职责/来源 | 关键状态 | 空间或层级 | 必须保持什么 |
|---|---|---|---|---|
| 自定义 | 主体、对照、背景等 | 按需要列初始/中间/结束 | 局部或画面坐标、遮挡关系 | 身份、内容、比例等 |
布局未定时,用归一化坐标或相对关系;布局定后再补精确数值。需要形变时写明对应点、容器/内容的分工、遮罩与不可变形部分。明确哪些允许夸张、哪些必须保持准确;品牌标识形变遵循本次创作授权,不能把真实产品文字和数据改成错误含义。
B. 动作事件
用于多动作协作、重复节奏或精确产品演示。事件行数由动作决定。
| 区间/触发 | 对象与变化 | 路径或变化方式 | 与其他动作关系 | 视线/声音 | 观察点 |
|---|---|---|---|---|---|
| 自定义 | 从什么到什么 | 有必要才指定 | 先后、重叠、同步等 | 吸引、保持或转移注意 | 可见的成功条件 |
按需要补充启动、加速、接触、回弹、稳定等阶段;不是每个动作都要有完整物理表演。声音配合因果或情绪,不要求每动一次就加音效。
C. 镜头与构图
用于推拉、摇移、景别变化、视差、3D 或重新构图。
- 摄影机与对象分别在动什么,运动要揭示什么。
- 开始与结束景别、焦点、视线落点;需要时补路径与透视。
- 哪些内容保持稳定供阅读,哪些有意出画或被遮挡。
- 固定机位无需虚构运镜;强调前后对比时,保持构图可能更有效。
D. 镜头交接
复用“上下文关系”记录,重要接点只补尚未明确的一两句:上一段最后的注意重点是什么,下一段首先要建立什么,二者是延续、对照还是明确切断,以及观众如何跟上。重要接点包括观看重点显著改变、对象身份易混淆或已出现问题的位置;重复关系全片写一次,例外再展开,不另造必填表。真实与概念素材的身份保持清楚,不能以无缝效果制造虚假连续操作。
先写内容关系,再选择机制。以下是选项,不是穷尽的类别:
| 所选机制 | 需要记录 | 不需要强加 |
|---|---|---|
| 同对象延续/容器展开 | 对象身份、接点边界、内容与遮罩、层级、是否同一实例 | 整片无缝、一律运动中切镜 |
| 动作匹配 | 切点、可见方向、速度/相位关系、注意力落点 | 所有镜头同轴同向 |
| 构图或形状匹配 | 哪些视觉关系呼应,哪些内容发生替换 | 虚构物理连续性 |
| 硬切/跳切 | 转折理由、切点、前后重点、理解是否中断 | 承接物、位移或补间动画 |
| 淡化/叠化 | 表达的时间或情绪关系、重叠区、文字和主体的可辨认性 | 机械禁止淡化 |
| 声音连接 | 音频来源、跨界区间、画面切点、信息冲突检查 | 必须同时有视觉转场 |
| 单镜头持续发展 | 内部状态如何推进、哪里需要重新聚焦 | 为模板拆出镜头边界 |
如果选择同对象连续,记录接点前后的几何与外观;如果选择运动匹配,再记录速度。不把连续性的数值要求应用到有意的跳切。
若选择“覆盖前场”的遮罩、擦除或物体扩张,检查未覆盖区域实际显示的内容:旧场是否过早结束,新场底层是否先挡住旧场。旧内容何时退出由所选交接意图决定,不由组件默认结束决定。硬切、淡出淡入及有意空拍不适用这一约束;硬切也可直接落在清楚的下一构图。
E. 文字、数据与声音
- 文字:精确文案、语义重音、拆分单位、最终阅读状态;允许文字本身成为主要动作。
- 数据:数值与来源、比较基准、轴/单位、形变是否产生误导;动态揭示不能改变比例含义。
- 声音:使用真实可用音轨、临时节奏或无声;字幕与旁白关系、关键同步点。最终更换音轨后重验相关时序。
- 用户未要求时,不为了填表强加旁白、字幕、音乐或音效。
声音需要参与叙事或重新设计时,先按 声音叙事 确定段落关系、动作反馈、主次与留白,再填写下面的时间锚点。不能用对齐表替代声音方案。
声画锚点:有声音职责时使用
规划时可先用预期动作相位和音乐结构安排。粗稿出现后,先从实际动态中辨认需要声音支持的主要变化,再与真实音轨的起点、重音/瞬态、乐句转折与留白配对;不能只沿原声画表寻找对得上的切点,而漏掉主导本段观看的场内动作。波形可辅助定位,不只凭文件名、BPM 或均匀网格认定重音;音频起始偏移、淡入与导出偏移都影响结果。
| 声音事件及来源 | 音频/全片时间 | 实际可见事件、相位及证据位置 | 意图与复核 |
|---|---|---|---|
| 真实重音、乐句变化、音效或有意留白 | 标明 offset,落到项目帧 | 写明所选感知相位;已实现时给出输出帧/区间或动态片段位置 | 说明为何强调;复听看该区间,记录是否对应 |
- 选与内容有关的少数锚点,不把每个元素或每次转场吸附到节拍;允许有意提前、延后和跨拍,并解释其作用。
- 明确反馈对应启动、变化最清楚、接触还是完成;同一动作这些时刻可能相距很远。代码的起点或结束点不能代替这个选择。
- 绑定实际使用的音频版本、裁切/偏移与画面版本。同一共享时间常数只证明安排相同,不证明感知重点对应;向工程修改流程交接选定关系、证据位置与版本。
- 可以按声音编画面,也可锁定重要画面后调整有权限编辑的音轨;先保证内容、阅读与自然节奏,不用强行拉伸素材换取对齐。
- 原有音乐缺少适合的重音时,可在授权范围内选曲/编曲或添加克制音效。配乐与音效是不同职责;音效不是必需,也不能每次运动都加 whoosh。
- 交付分别记录“时间对应已核对”和“正常速度声画体验已听看”。后者未完成时明确未验证,不以音轨存在或波形对齐代替。
F. 实现交接
记录引擎、项目版本、画幅/帧率、素材位置、可定位的对象名、局部与全局时间换算。只描述实际使用的 API。
多处动作与音频需要共同改时长时,复用宿主事件标签或共享时间数据,减少重复写时间常数;简单事件无需额外文件。
复杂接点可使用局部对象映射或共享容器,不先规定代码架构。技术不支持原方案时,比较影响最小的替代表达;重要差异必须说明。
可复制工作表
以下是编辑起点,不是严格 schema。删除不相关项,允许用短文替代。
segment: 自定义名称
intent: 观众理解或感受什么
evidence: 涉及事实时填写依据;概念化表达需注明
time: 全片区间/局部时长/事件锚点,并明确时间基准
expression: 实际变化及其带来的理解/感受;不是只写入场方式
timing: 关键顺序、重叠、停顿与阅读安排
context: 与前后内容的关系;无相邻段落时省略
observe: 实际播放时要检查的现象
# 仅在有关联时加入下面模块,不保留空字段
objects: 对象身份、关键状态、空间与不可变项
events: 关键动作事件,不逐帧列举
camera: 机位/景别变化及其目的
handoff: 所选连接机制需要的状态与时间
text_audio: 精确文案、声音事件与时间、对应视觉事件及相位;有意错拍的理由
implementation: 素材与工具约束、待确定参数
填写例一:产品行为,使用动作与交接模块
意图:让观众理解分类关系;这是概念动画,真实功能在后续产品界面证明。
时间:局部 0–6 秒,只是待验证初稿。
对象:files 保持身份;groups 是分类容器;selected_group 后续持续存在。
| 局部时间 | 可见变化 | 关系与观察点 |
|---|---|---|
| 0–0.7s | 分类依据显现,散乱文件开始归组 | 先建立依据,不能像随机吸附 |
| 0.5–2.6s | 多组文件分批移动到对应容器 | 路径和启动时间允许区分,不必全部同时或全部顺序 |
| 2.3–3.2s | 完成的组收拢,最后一组继续归位 | 主次随完成状态变化,不额外加一次统一弹跳 |
| 3.2–4.6s | 结果稳定,短文案解释分类依据 | 实际播放确认读清;时长可调整 |
| 4.6–6s | 选中目录展开,承接下一段真实界面 | 边界连续,不出现旧新容器重影 |
交接:延续 selected_group 的视觉身份。到接点记录它的实际边界、颜色、圆角与遮罩;内层界面显现不能覆盖尚需阅读的文字。这里无需规定全片运动方向。
审核:分类能否被理解?结果有没有可读时间?接点有没有跳变?这些动作只适合此任务,不作为通用事件表。
填写例二:静观式品牌片,不使用对象交接模块
意图:表现耳机外壳的精密与安静,不介绍未经证实的音质指标。 表达:固定近景,一道掠射光缓慢经过真实外壳素材,显露接缝;机位和型号保持稳定。若只有平面照片,先验证能否可信地实现光照变化,不伪造 3D 结构。 时间:根据接缝被清楚看见的时刻确定型号出现;其后保持足够阅读时间。声音可无,按简报决定。 连接:材质细节结束后直接硬切整体轮廓,以尺度变化形成释放;不添加飞行对象或容器展开。 观察:静止是否让材质细节成为注意中心?光照变化是否自然?硬切之后能否辨认同一产品?
这是完整的动作脚本,不因没有时间表、因果点击或匹配速度而不合格。