用途
Visual Mode 是 Remotion Studio 中的一项功能,允许用户以可视化方式编辑 Sequence(序列)。本技能文档为在 Remotion Studio Visual Mode 上工作的开发者提供指导,涵盖序列身份、节点路径、符号化堆栈、override ID 以及热重载行为等主题。
主要能力与核心概念
文档记录了以下观察与约定:
- overrideId:即使文件、行、列发生变化,也能保持序列身份不变。
- Sequence 堆栈:在热重载时会变化,且可能被多个具有不同 overrideId 的序列共享。
- Sequence 文件、行、列(符号化堆栈):不会变化,但需要异步计算。
- nodePath:即使行、堆栈和 overrideId 发生变化,也保持相同身份,且为异步获取。
- nodePath + index:是跟踪展开状态的理想方式,也是最终目标。
使用方式与实现约定
- 一旦 nodePath 映射到 overrideId,它就不再变化,否则组件会重新挂载,overrideId 也会改变。
- 如果发现同一个堆栈已被另一个序列使用,则复用该 overrideId。
- nodePath 到符号化堆栈理论上可能在每次文件变更时改变,但多个序列可以共享同一个堆栈,此时它们拥有相同的 nodePath。
- 每个堆栈的 nodePath 只应获取一次。
- 由于快速刷新(fast refresh),不同的未符号化堆栈可能指向同一个符号化堆栈。
- 未符号化堆栈到符号化堆栈的映射永远不会改变,因为如果改变,说明由于快速刷新而变成了不同的堆栈。
浏览器 Studio 路由跟踪
每当新增一个 Studio API 路由时,需在同一次变更中将其添加到 issue #9807 中的 Browser Studio 一致性清单。即使该路由是有意仅限服务端的,也应将其放入必需的 Browser Studio 操作或明确不支持的路由中。
适用场景
适用于在 Remotion Studio Visual Mode 上进行开发、调试序列身份与热重载行为、处理 nodePath 与 overrideId 映射,以及新增 Studio API 路由时维护一致性清单的场景。
限制
资料未提供关于收费、价格、平台支持范围或具体使用步骤的更多信息。