@aura3d/editor-runtime

中文文档
4.7.0发布于 2026/10/31MITTypeScriptES Module

运行时编辑器命令历史,选择状态,挑选,检查器模型,播放模式快照,材料变体,以及Aura3D的转换小工具。

中文使用文档
文档目录3 节
  1. 公共API
  2. 平台范围
  3. 验证

@aura3d / editor-runtime

@aura3d/editor-runtime 拥有编辑器命令历史记录、选择状态、拾取、检查器模型、播放模式快照,以及运行时编辑器工作流的转换小工具。

公共API

  • EditorRuntime, EditorMode:模式切换、公共选择方法、命令执行、检查器编辑执行、拾取、翻译小工具拖动执行、诊断快照、材料变体工作流所有权和处置。
  • Command, CommandHistory, CommandContext:执行/undo/redo合约,命令执行失败时回滚。
  • Selection:有序选择状态和侦听器通知。
  • PickingService确定性目标命中选择和选择结果排序。
  • InspectorModel:可编辑检查器属性投影和键入set-property命令创建。
  • MaterialVariantWorkflow:编辑拥有的glTF/材质变量选择状态和渲染资源选项投影。
  • PlayModeBridge:快照捕获/恢复编辑/播放模式边界。
  • Gizmo, TranslateGizmo, RotateGizmo, ScaleGizmo:变换句柄、命中测试和拖动应用程序。
  • createStaticExportHtml, createStaticExportRuntime:包拥有的静态导出shell/运行时生成,用于选中编辑器创建的项目冒烟测试,而无需加载编辑器应用程序。
  • CreateNodeCommand, DeleteNodeCommand, SetPropertyCommand, TransformCommand:内置编辑器命令。

平台范围

浏览器只。 @aura3d/editor-runtime 没有桌面外壳,没有金牛座 集成,没有本地文件系统或窗口绑定:有界的根 表面(editor.undo/redo/gizmo/playMode/outliner、能力标签 editor)在浏览器内运行 createAuraApp 页面。桌面/金牛座编辑器 它是路线图,不是当前的能力——不要宣称它。

验证

编辑器选择、命令回滚、撤销/重做、检查器编辑、材料变体工作流选择、挑选、播放模式快照、翻译/旋转/缩放小工具、键盘快捷方式契约、浏览器编辑器像素、编辑器公共运行时边界强制执行、编辑器编写的来源和包拥有的静态导出运行时生成 tests/unit/workstream5-input-audio-scripting-editor.test.ts, packages/editor-runtime/tests/editor-runtime.test.ts, tests/unit/editor/project-serializer.test.ts, tests/unit/editor/public-runtime-boundary.test.ts, tests/integration/editor-authored-project-replay.test.ts, tests/browser/editor-browser.spec.ts, tests/visual/editor-app-pixels.spec.ts. 导出和导入一致性由 pnpm verify:exports 和 pnpm verify:imports.

版本与发布记录

@aura3d/editor-runtime 共发布 47 个版本,首次发布于 2026/06/06;过去 12 个月发布了 47 个版本。

版本发布日期距今
4.7.0latest2026/10/312 天前
4.6.22026/10/304 天前
4.6.12026/10/304 天前
4.6.02026/10/304 天前
4.5.02026/10/295 天前
4.3.72026/10/286 天前

关于 @aura3d/editor-runtime 的常见问题

@aura3d/editor-runtime 是什么?

运行时编辑器命令历史,选择状态,挑选,检查器模型,播放模式快照,材料变体,以及Aura3D的转换小工具。

如何安装 @aura3d/editor-runtime?

在项目目录运行 npm install @aura3d/editor-runtime,或使用 pnpm add / yarn add / bun add。

@aura3d/editor-runtime 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aura3d/editor-runtime 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@aura3d/editor-runtime 可以商用吗?

@aura3d/editor-runtime 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aura3d/editor-runtime 还在维护吗?

最新版本 4.7.0 发布于 2026/10/31(2 天前);至今共发布 47 个版本,其中过去 12 个月发布了 47 个;首次发布于 2026/06/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。