基础入门

用户界面

主页

登录成功后，您将进入 FactVerse Designer 的主页。主页为您提供了编辑界面的入口，方便您快速访问最近编辑的孪生体模板和孪生场景。

主页面主要功能如下：

模板编辑器

在 FactVerse Designer 中，通过点击主页上孪生体模板的【新建模板】按钮或打开任意一个孪生体模板，您将进入模板编辑器界面。在模板编辑器界面中，您可以对一类孪生体进行详细定义，包括元数据、行为树和资源等内容。

菜单栏

模板编辑器的“菜单栏”中包含了在制作孪生体模板时可能用到的常用工具和命令。以下是各个菜单的功能说明：

工具栏

模板编辑器的“工具栏”中包含了如下表所示的常用命令：

图形符号	描述
	主页按钮，点击主页按钮可跳转到主页。若模板当前修改未保存会提示是否保存当前模板。
	保存按钮，保存新建或修改的模板。
	另存为按钮，点击另存为按钮可以另存当前模板。
	复制按钮，点击后复制所选资源，并自动进入放置模式。⚠ 不支持复制属性和结构。
	撤销按钮，撤销用户上一步操作。
	重做按钮，恢复用户已撤销的操作。
	删除按钮，删除资源。⚠不支持删除属性及结构。

资源库

模板编辑器的资源库位于界面左侧窗格，提供资源管理与快速调用能力。您可选用资源库中的素材，快速构建孪生体模板。

资源库界面说明

资源库支持窗格大小调整与折叠展开：

• 拖拽下边缘或右边缘可调整窗口大小；
• 点击资源库标题栏可折叠或展开窗格内容。

资源库分为两个页签：

• 我的资源：展示所有已上传的 2D/3D 图形素材；
• 工具：提供系统预设的设备模型和功能小工具。

我的资源

在我的资源页签中，您可以浏览并使用FactVerse平台中上传的2D/3D资源。常见操作如下：

资源状态说明：

• 未缓存：图标为灰色，表示资源尚未下载；
• 下载中：点击未缓存的素材后开始下载，同时显示素材下载进度；
• 已缓存：图标高亮，表示资源已可用。

工具

在 [工具] 页签中，主要包含系统内置的辅助元素和基础组件以及用户自定义的小工具：

• 基础设备模型：；
• 功能类小工具：如字幕、组件、几何图形、特效等，支持增强模板交互性与可视化效果。
• 自定义工具：在自定义类别下包含用户自定义的工具，详见自定义小工具。

孪生体模板

孪生体模板窗格位于资源库窗格下方，用于展示当前模板中的元数据、资源和行为树。它是模板编辑器界面的一个重要组成部分，提供了对孪生体模板内容的全面查看和管理功能。

场景区

模板编辑器的“场景区”位于模板编辑器界面的中央窗格，是用户用来编辑孪生体模板的主要工作空间。您可以将模型或工具资源从资源库中拖入场景区，开始创建您的孪生体模板。

模板编辑器的场景区中包括以下内容：

• 添加到场景的资源：您可以将各种资源，如模型、工具等，添加到场景区中，以便进行布局和编辑。
• 视角立方体 ：位于场景区右上角的视角立方体显示当前视图方向。单击视角方块和箭头可以快速在六个视图之间切换。
• 视点重置按钮 ：单击重置按钮可以将视点回到初始视角，方便您重新调整视图。
• 投影切换按钮 ：默认情况下使用透视投影，您可以通过切换按钮切换到正交投影。

属性区

属性区位于模板编辑器界面右侧，用于查看与编辑模板本身及场景中资源的详细属性。

根据当前选中对象的不同，属性区分为以下三类：

一、模板属性

当点击场景空白区域时，属性区将显示当前模板的整体信息，支持以下设置：

• 模板名称：用于标识当前模板。
• 描述：填写该模板的功能说明或使用场景。
• 缩略图：支持上传或更换模板的预览图，用于在资源库中快速识别。

二、资源属性

当选中场景中的具体资源（如从“我的资源”中添加的模型等），属性区将显示对应的配置项：

• 资源名称：当前选中资源的命名。
• 姿态：位置、旋转、参与碰撞（启用后，该资源可参与物理碰撞检测，详见碰撞检测）。
• 数据绑定：支持将该资源属性与外部数据源绑定，实现资源属性的动态控制。例如：将传感器数据绑定至“旋转角度”，可使模型跟随现场数据实时转动，实现更真实的数字孪生效果。

三、工具资源属性

对于添加至场景的工具类资源（如几何体、网页工具、特效等），属性区将显示其专属属性配置项：

• 工具资源名称：当前工具组件的命名
• 姿态：位置、旋转、是否参与碰撞（同上）。
• 工具属性：
  • 工具独有的参数设置，如颜色、尺寸、特效参数等。
  • 保存预设：在完成配置后，可点击【保存预设】将当前设置保存为“自定义工具”。自定义工具将出现在【资源库 > 工具 > 自定义】区域，支持在其他模板或场景中快速复用。

场景编辑器

通过点击主页上场景的【新建场景】按钮或打开一个场景，会进入场景编辑器界面。在场景编辑器界面中，您可以组织由孪生体模板创建出的孪生体为一个孪生场景，其包含孪生体布局、出入口连接等功能。

菜单栏

场景编辑器的“菜单栏”中包含了您在制作孪生场景时可能用到的常用工具和命令。以下是各个菜单的功能说明：

工具栏

场景编辑器的“工具栏”中包含了如下表所示的常用命令：

图标	名称	描述
	主页	返回主页。若当前场景有未保存内容，系统会提示是否保存。
	保存	保存当前新建或已修改的场景内容。
	另存为	将当前场景另存为新的场景副本。
	撤销	撤销上一步操作。
	恢复	恢复被撤销的操作。
	路径模式	开启路径模式，用于查看与管理路径。
	定位模式	切换至定位模式，允许用户根据需要修改、添加、删除定位码，或使用参考模型辅助场景编辑。
	复制	复制当前选中的角色或孪生体，并进入放置模式。 ⚠ 不支持复制子角色。
	删除	删除当前选中的角色或孪生体。 ⚠ 不支持删除子角色。
	生成模拟记录	以设定时间（支持加速/一倍速）运行场景模拟并记录运行过程数据和录像，上传用于后续分析与回顾。
	调试播放	进入调试播放模式，用于预览并调试场景运行效果，辅助排查运行问题与优化场景逻辑。

数字孪生库

您可以在数字孪生库中浏览和使用孪生体模板及孪生体资源，便于快速构建数字孪生场景。

孪生体模板页签

在 [孪生体模板] 页签下，您可以查看所有已上传至平台的孪生体模板。

• 加载模板：点击尚未加载的孪生体模板，系统会进入加载状态，将该模板资源加载至本地。
• 放置模式：点击已加载完成的孪生体模板，即自动进入“孪生体放置模式”。在放置模式下，左键点击场景任意位置，即可在该处创建一个新的孪生体实例。每次点击创建一个实例，支持连续放置多个。点击右键可退出放置模式。如需详细了解如何使用模板创建孪生体，请参阅章节：在场景中手动创建孪生体。

孪生体页签

在 [孪生体] 页签下，您可以查看所有云端公开的孪生体（不包括私有孪生体）。您可以将未引用的孪生体添加到场景中。

资源库

资源库位于场景编辑器左侧窗格，与数字孪生库并列显示，功能与模板编辑器中的资源库保持一致。您可在此浏览并调用平台中的 2D / 3D 素材资源和工具组件，用于快速搭建和丰富场景内容。更多使用说明详见：模板编辑器 > 资源库

孪生体

孪生体窗格位于场景编辑器左侧窗格下方，用于展示当前场景中的所有元素，包括孪生体、模型、工具、文档、灯光等资源。您可在此查看、管理场景中的资源。

功能说明

场景区

“场景区”位于场景编辑器界面的中央窗格，是用户用来编辑孪生场景的主要工作空间。在这个区域内，您可以对孪生体、模型和工具进行布局、组织和编辑，从而创建您所需的孪生场景。

场景编辑器的场景区的主要功能：

• 资源布局：您可以将孪生体、模型或工具放置到场景区中，调整到合适的位置，开始构建您的孪生场景。
• 编辑和组织：在场景区中，您可以对已添加的孪生体和模型进行编辑和组织，调整它们的位置、大小、旋转角度等，以达到预期的场景效果。
• 多视角展示：场景区支持多视角展示，您可以通过单击场景区右上角的视角方块，快速在六个视图之间切换（正视图、后视图、左视图、右视图、上视图、下视图），以便更好地观察和编辑场景。
• 视点重置：单击场景区中的视点重置按钮 ，可以回到初始视角，方便您在编辑过程中进行调整和操作。
• 投影切换：您可以切换场景区的投影方式，从透视投影切换到正交投影，以满足不同场景需求。

属性区

属性区位于场景编辑器界面右侧窗格，用于查看和编辑当前选中对象的属性、行为逻辑、布局配置等内容。根据所选对象的不同，属性区显示内容会动态变化。

场景属性编辑

当点击场景空白区域（未选中任何对象）时，属性区将显示当前场景的基础信息，支持以下内容编辑：

孪生体属性编辑

选中场景中的孪生体后，属性区会显示该孪生体的详细属性，例如位置、主要功能、出入口等。

模型资源属性编辑

当选中场景中的模型资源时，属性区将显示以下内容：

• 姿态（位置、旋转、缩放）
• 背面不可见：当选中的模型或其子构件设置为“背面不可见”时，从背面观察该模型或子构件其消失不可见。此功能主要应用于场景模型，例如，当一个虚拟厂房模型的外墙被设置为“背面不可见”后，外部视角下仅显示内部结构，提升用户对内部设施的可见性。

工具资源属性编辑

当选中工具类资源（如几何体、字幕、图表等）时，属性区将展示以下设置项：

• 姿态（位置、旋转）
• 工具专属属性（如颜色、尺寸、图表绑定数据等）
• 自定义预设管理（如适用）

行为树编辑

点击属性区顶部的【行为树】标签页，即可查看当前对象（如场景或孪生体）所绑定的行为树。您可以点击任意行为树，可以进入行为树编辑器进行调整。详见：行为树编辑器

行为树编辑器

FactVerse Designer 提供了一个直观的可视化行为树编辑器，无需编写代码即可为孪生体创建复杂的行为逻辑。

行为树编辑器界面包含的主要部分：工具栏、节点菜单、行为树编辑区和属性区。通过节点菜单、行为树编辑区和属性区的组合，行为树编辑器提供了一个可视化和交互式的界面，使用户可以方便地创建、编辑和调整行为树的结构和行为逻辑。

工具栏

行为树编辑器的工具栏包含一系列常用的功能按钮，以提供对行为树编辑器的操作和管理。以下是工具栏按钮和其功能的说明：

1. 返回：返回按钮用于关闭当前的行为树编辑器并返回模板或场景编辑器界面。点击该按钮后，行为树编辑器将被关闭，并且会进行保存或另存的提示。
2. 树属性：该按钮用于打开或访问行为树的属性设置。
3. 保存：保存按钮用于将当前编辑的行为树保存到 FactVerse 平台中。
4. 另存：另存为按钮允许用户将当前编辑的行为树以不同的名称或路径进行保存。
5. 缩放视图：缩放视图按钮允许用户调整编辑器界面中的行为树显示比例。通过点击缩放视图按钮，用户可以放大或缩小行为树编辑器的视图，以便更好地查看和编辑行为树的细节。
6. 撤销：撤销上一步操作。
7. 恢复：恢复被撤销的上一步操作。
8. 删除节点：删除节点按钮用于删除选定的节点。当用户选择一个节点并点击删除节点按钮时，该节点将从行为树中被移除。

节点菜单

“节点菜单”位于行为树编辑器界面的左侧，您可以从节点菜单中选择适当的节点，然后将其拖拽到行为树编辑区以创建和编辑行为树的结构。

行为树编辑区

“行为树编辑区”是主要的工作区域，用于创建和编辑行为树的结构和逻辑。用户可以在编辑区中拖拽节点，将它们组织成树状结构，并定义节点之间的关系和顺序。用户可以调整节点的位置、连接节点之间的连线。通过在行为树编辑区进行操作，用户可以直观地构建和修改行为树的结构。

属性区

行为树编辑器的“属性区”位于行为树编辑器界面的右侧，用于设置行为树节点的属性和运行条件。当用户选择一个节点时，属性区将显示该节点的相关属性和条件参数，用户可以对这些属性进行设置和调整。属性区还允许用户定义节点的运行条件，通过设置节点的运行条件，用户可以根据特定的条件控制节点的行为和执行逻辑。

除此之外，用户还可以在属性区编辑行为树的名称，以便更好地管理和识别不同的行为树。