SuperAPI AI 工具集

visual-mode

前端与建站

查看项目

更新于 10-15 14:58

技能介绍

用途

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 路由时维护一致性清单的场景。

限制

资料未提供关于收费、价格、平台支持范围或具体使用步骤的更多信息。