功能说明

创建于2026年6月26日

上次更新时间2026年7月3日

孪生体模板管理

在 Designer 中，您可以为孪生体模板配置外观、属性、预设结构、出入口和行为树逻辑等内容。使用模板创建孪生体后，孪生体实例会继承模板中的相关配置。

建议在模板中配置同类孪生体共用的外观、属性和默认能力；在场景中根据实际业务需要调整单个孪生体实例的位置、属性值或连接关系。

说明：

模板的删除操作需在 FactVerse 平台中完成，Designer 中不提供删除功能。

新建模板

除了使用 FactVerse 资源包中的预设模板，您也可以从零开始创建一个全新的孪生体模板，用于满足特定设备或空间的建模与数据驱动需求。

操作步骤

通过以下任一方式打开“新建模板”窗口：

- 在主页点击【+ 新建模板】；
- 在模板编辑器中点击【文件】>【新建】。
在弹窗中填写模板信息，点击【确认】后，系统将在模板编辑器中打开新模板。

点击工具栏【保存】按钮，将模板保存到平台资源库中，完成模板创建。

新建模板窗口字段说明

缩略图（选填）：用于在快速识别模板。
名称：模板名称。
模板类型（选填）：系统预设的类型，包含预置的属性组和默认值。
- 选中模板类型后，可快速继承该类型的属性结构
- 同时用于 Inspector 中“空间类 / 设备类”的分类展示与管理；
- 创建后不可修改，且继承的属性组/属性不可从模板中删除。
存储位置：选择模板在平台资源库中的保存目录。

说明

新建模板仅完成“模板”的创建。要在业务中使用，还需继续在模板中配置内容，例如：

新增/调整属性组与属性（如设备信息、姿态、运行数据等）；
添加模型资源、配置数据绑定或行为树（按实际需求）。

编辑模板属性组

在孪生体模板中，属性组用于对属性进行分类管理（如“姿态”“设备信息”“运行数据”等）。您可以新增、重命名或调整属性组类型，并在属性组下添加属性。

添加属性组

在孪生体模板窗格中，点击【元数据】旁的︙，选择【添加结构】。

重命名属性组

在孪生体模板窗格中选中目标属性组；
在右侧属性区点击编辑图标修改结构名称。

编辑属性组类型（静态 / 动态）

在孪生体模板窗格中，选中目标属性组；
在右侧属性区的类型下拉框中选择静态或动态。

添加属性

在孪生体模板窗格中，点击目标属性组旁的︙，选择【添加属性】；
在弹出的属性类型列表中选择需要的属性类型，系统将在该属性组下创建对应属性；
选中该属性后，可在右侧属性区修改属性名称、标识符、默认值等参数。

提示：完成属性组编辑修改后，请点击保存，否则更改不会生效。

配置孪生体属性允许 AI 读取

【允许 AI 读取】用于指定哪些模板属性可以提供给 FactVerse AI。开启后，FactVerse AI 可以在回答问题、分析场景或辅助操作时参考该属性；关闭后，该属性不会提供给 FactVerse AI。

当您希望FactVerse AI 了解某些设备或对象信息时，可以为相关属性开启【允许 AI 读取】。例如：

设备温度、运行状态、运行时长等需要被 AI 用于问答或分析的属性；
产线状态、设备能力、业务参数等需要被 AI 参考的属性。

对于内部调试字段、临时计算字段，或不希望 AI 使用的属性，请保持【允许 AI 读取】关闭。

操作步骤

打开目标孪生体模板。
在元数据栏中，选中需要提供给 AI 的属性。
在右侧属性区，开启【允许 AI 读取】。

保存模板。

说明：

【允许 AI 读取】可按属性单独设置。同一模板下，不同属性可以分别开启或关闭。
修改后需要保存模板才会生效。
使用该模板创建的孪生体会继承该属性的设置。
建议只为需要 FactVerse AI 参考的业务属性开启【允许 AI 读取】。

管理模板中的行为树

行为树用于定义孪生体的行为逻辑。在模板中，您可以新建行为树、添加已有行为树，并进行查看、编辑或移除。

新建行为树

在孪生体模板窗格中，点击【行为树】右侧的图标︙，选择【新建行为树】。

在弹出的窗口中选择存储路径，填写行为树名称。

添加已有行为树

在孪生体模板窗格中，点击【行为树】栏右侧的 ︙，选择【添加行为树】并选择目标行为树。

查看与编辑行为树

在孪生体模板窗格中，双击【行为树】栏下的目标行为树，即可在行为树编辑器中打开并编辑。

移除行为树

点击行为树名称右侧的【删除】按钮，可将该行为树从模板中移除。

说明：移除仅解除模板关联，不会删除云端已保存的行为树。如需彻底删除，请登录 FactVerse 平台进行删除。

配置模板出入口

孪生体出入口用于定义货物、物料或对象在不同孪生体之间的流转关系。在生产线、物流、仓储等场景中，如果某类孪生体需要接收或输出货物，通常需要为其配置入口或出口。

例如，原料生成器通常需要配置出口，传送带通常需要配置入口和出口，暂存区通常需要配置入口。如果孪生体仅用于展示、装饰，或不参与物料流转，则无需配置出入口。

操作步骤

在【工具】资源中选择【入口】或【出口】小模型，并添加到孪生体模板中。

说明：

出入口模型主要用于标识入口或出口，方便用户识别、选中和配置连接关系。它在模型中的摆放位置不等同于货物实际进入或离开孪生体的位置。

添加入口或出口资源后，需要为其添加相关属性，使系统能够识别出入口的位置、所属孪生体和连接关系。

常见出入口属性如下：

属性	说明
链接的出入口ID	表示当前出入口连接的对端出入口。对于【出口】，表示下游孪生体的入口；对于【入口】，表示上游孪生体的出口。
连接关系	显示当前出入口已连接的对端出入口信息。对于【出口】，表示已连接的下游入口；对于【入口】，表示已连接的上游出口。该值通常在场景中完成出入口连接后自动生成，不建议手动修改。
链接的孪生体ID	表示当前出入口连接的对端孪生体。对于【出口】，表示下游孪生体；对于【入口】，表示上游孪生体。
存放的孪生体ID	表示当前出入口所属的孪生体。
出入口的位置	表示入口或出口小模型在当前孪生体中的位置。该位置用于记录出入口小模型的实际摆放位置，便于在场景中识别、选中和调整出入口。

配置完成后，用户可以在场景中将一个孪生体的出口连接到另一个孪生体的入口，使货物按照指定路径流转。具体操作请参见“调整孪生体出入口”。

配置预设结构

预设结构是系统提供的预设属性组，用于为孪生体模板快速添加某类功能所需的属性配置。用户可以在【模板编辑器】中根据业务需求添加对应的预设结构。使用该模板创建孪生体后，孪生体实例会继承模板中的相关属性配置。

创建模板时，系统通常默认包含【姿态】预设结构，用于记录孪生体在场景中的基础状态和运行相关信息。其他预设结构可根据实际业务需要添加。

常见预设结构说明

预设结构	说明	适用对象
姿态	用于记录孪生体在场景中的基础状态和运行相关信息，例如位置、旋转、速度、移动路径、包围盒、统计标识和质量等。创建模板时通常默认包含。	所有孪生体
自主寻路	用于支持孪生体在场景中根据目标位置进行路径规划和移动。详见“自主寻路”章节。	AGV 小车、移动机器人等需要自动移动的孪生体。
重心	用于定义孪生体在物理模拟中的受力中心。开启重力模拟时，系统会根据重心计算孪生体的下落、倾斜和堆叠效果。详见“重力模拟”章节。	货箱、托盘、建材、车辆等需要参与重力模拟或堆叠校验的孪生体。
碰撞检测	用于输出孪生体之间的碰撞检测结果，供后续逻辑判断或行为树使用。详见“碰撞检测”章节。	需要判断物体是否发生碰撞、重叠或空间干涉的孪生体。

操作步骤

打开需要配置的孪生体模板。
点击【元数据】旁的︙，选择添加所需的预设结构。
在右侧属性面板中配置该预设结构的相关参数。
根据业务需要编辑预设结构中的属性。
保存模板配置。

说明：
不同孪生体模板需要配置的预设结构不同。仅在该孪生体需要对应能力时添加即可。例如，仅用于展示的孪生体通常无需添加【重心】或【碰撞检测】；需要参与重力模拟、碰撞检测或行为树控制的孪生体，则应根据业务需求补充相应预设结构。

示例

创建摄像头模板

摄像头模板用于在场景中创建摄像头孪生体，并显示摄像头的监控覆盖范围。通过配置摄像头的位置、朝向、视场角、可视距离和视频流信息，用户可以在场景中查看摄像头大致覆盖区域，判断摄像头是否覆盖目标空间，辅助进行空间覆盖分析和盲区检查。

完成配置后，用户可在 Inspector 中查看摄像头模型及其监控范围，并点击摄像头查看实时监控画面。

前置条件

创建摄像头模板前，建议完成以下准备：

准备摄像头模型资源。
如需使监控范围与摄像头镜头方向准确对齐，建议在摄像头模型中设置一个空节点作为【镜头基准点】。该节点应位于镜头中心位置，并与摄像头实际朝向保持一致。
如需还原现场监控效果，建议提前获取摄像头的安装位置、朝向、画面比例、视场角和可视距离等参数。

参数说明

创建或编辑【摄像头】类型模板时，可在属性面板中配置以下参数：

参数	说明
画面比例模式	设置摄像头画面的宽高比例，支持 16:9、4:3、9:16 和【自定义】。
水平视场角（°）	设置摄像头水平方向的可视范围，影响监控覆盖宽度。
垂直视场角（°）	设置摄像头垂直方向的可视范围。仅当【画面比例模式】为【自定义】时需要设置。
最远可视距离（m）	设置摄像头可视范围的最大距离，用于表示摄像头可看到的最远范围。
视频流地址	填写摄像头实时画面的访问 URL。该地址通常由项目实施人员或系统集成方提供，需填写为完整、明确且可用的 URL。未配置或地址不可用时，运行端无法显示监控画面。
镜头基准点	用于指定摄像头监控范围从哪里开始、朝哪个方向显示。建议选择摄像头模型中位于镜头中心的空节点。未添加摄像头模型时，系统以模板原点作为参考位置。

创建摄像头模板

创建【摄像头】类型模板。

创建后，系统会根据默认参数显示摄像头的可视范围预览。

建议在模板中添加摄像头模型，并配置镜头基准点，以便使可视范围预览与实际摄像头位置准确对齐。

在属性面板中设置摄像头参数。

调整画面比例、视场角、最远可视距离等参数后，可在模板中查看摄像头可视范围预览，并根据实际需求反复调整，直到覆盖范围和朝向符合预期。

保存模板。

在场景中添加摄像头设备

在场景中使用该模板创建摄像头孪生体。
将摄像头孪生体放置到对应位置，并根据实际安装方向调整角度。
根据需要调整该摄像头孪生体的属性值，例如可视距离、视频流地址等。

如需在 Inspector 中查看实时监控画面，需要在 FactVerse 平台的数据看板模块中，为相关空间层级或设备层级看板配置视频流组件。

说明

若未添加摄像头模型，系统仍可生成可视范围预览，但不会显示摄像头外观；
若已添加摄像头模型，但未配置镜头基准点，或模型中不存在指定节点，可能导致可视范围预览与实际镜头位置存在偏差；
使用该模板创建孪生体后，模板属性在孪生体中可见，并可根据实例需求单独调整。
【垂直视场角】仅在【画面比例模式】设置为【自定义】时生效；其他比例模式下，系统会根据画面比例自动计算垂直方向的可视范围。

创建会变色的方块模板

本示例将创建一个“会变色的方块”，使其在接收到不同信号值时自动变换颜色。

示例目标

实现逻辑：当“信号”属性为 1~4 时，方块颜色分别变为蓝色、绿色、红色、青色。

创建方块模板：

a) 创建一个全新的空白模板，名称为“会变色的方块”。

b) 在场景区域中放置一个方块。

c) 放置完成后，右键退出放置模式。

添加主功能结构：

a) 在孪生体模板窗格中，点击元数据旁的︙，选择添加结构。

b) 下拉滚动条找到新添加的结构 “Part_1”，点击“Part_1”，在属性区修改结构名称为“主功能”。

c) 在“主功能”结构下添加“颜色”（Color）和“信号”（Int）两个属性。

绑定颜色属性的数据：

a) 在场景区中，选中方块模型。

b) 在右侧属性面板中，点击数据绑定旁的【添加】按钮，然后在属性列表中选择“颜色”属性。

c) 在颜色属性的绑定窗口中，点击，然后选择主功能结构中的“颜色”属性。

d) 点击【确认】后完成颜色数据的绑定。

说明：此步骤确保孪生体属性“颜色”能驱动模型的颜色变化。

创建行为树：为方块创建一个名为“监听信号改变颜色”的行为树。

编辑行为树逻辑：

a) 双击“监听信号改变颜色”行为树，打开行为树编辑器。

b) 在根节点下添加一个选择节点。

c) 在选择节点下依次添加 4 个【顺序节点】，并为每个顺序节点设置“比较两个孪生体的属性值”的条件。

条件配置（“比较两个孪生体的属性值”）

顺序节点名	目标属性1	信号值（目标属性2）	比较策略
顺序节点1	孪生体中的属性：信号	1	等于
顺序节点2	孪生体中的属性：信号	2	等于
顺序节点3	孪生体中的属性：信号	3	等于
顺序节点4	孪生体中的属性：信号	4	等于

说明：每个顺序节点表示一个判断与执行逻辑，即“如果信号值为 X，就将颜色设置为 Y”。

d) 在每个顺序节点下添加一个设置属性节点，用于更改颜色。

设置属性节点配置

设置属性节点名	目标属性	属性值（RGBA）	说明
设置属性1	孪生体中的属性：颜色	0,0,1,1	蓝色
设置属性2	孪生体中的属性：颜色	0,1,0,1	绿色
设置属性3	孪生体中的属性：颜色	1,0,0,1	红色
设置属性4	孪生体中的属性：颜色	0,1,1,1	青色

保存行为树：

a) 点击工具栏中的保存按钮保存行为树。

b) 点击＜退出行为树编辑器。

保存模板
退出模板编辑器：点击主页按钮退出模板编辑器，完成模板的编辑。

通过以上步骤可以创建一个会变色的方块的孪生体模板。您可以使用这个模板创建方块，然后设置方块的“信号”属性值，并观察方块的颜色变化。

孪生体管理

创建孪生体

FactVerse Designer 提供三种方式创建与管理孪生体，支持灵活地构建、批量搭建或导入完整场景，满足不同使用需求。

创建方式	适合场景
手动创建	快速添加少量孪生体、局部调整
模板 Excel 表格导入	批量添加/修改某个模板下的多个孪生体
场景 Excel 表格导入	一键还原整套场景结构，支持迁移或全局管理

手动创建孪生体

操作步骤

新建场景或打开一个已有场景；
在数字孪生库 > “孪生体模板”的目录中，点击目标模板，进入放置模式;
通过鼠标左键点击场景区域确认孪生体的放置位置；
放置完成后，自动创建新的孪生体，命名规则为“模板名称_序号”。

点击保存按钮保存场景和新创建的孪生体。

模板 Excel 表格导入

适合批量创建或维护同一模板下的多个孪生体。

功能说明：

可选择导出空模板结构或导出含实例数据的模板文件；
支持在 Excel 表格中新增、修改、删除孪生体；
支持属性、位置等配置项的完整编辑。
表格导入后，平台会自动生成或更新所有相关孪生体。

操作步骤

1. 打开孪生体模板：打开您用来批量创建孪生体的孪生体模板。

2. 导出表格：

a) 在模板编辑器界面的菜单栏中，依次点击【文件】>【导出为表格】。

b) 在弹出的窗口中，选择导出内容：

- 导出模板结构（默认）：仅导出模板字段定义的表格（轻量版），不包含任何实例数据。
- 导出模板和对应的孪生体数据：导出包含模板结构和所有关联孪生体实例数据的完整表格，可用于批量修改或新增孪生体数据。

c) 点击【确认】保存 Excel 文件至本地。

3. 编辑 Excel 表格：

在导出的 Excel 表格中，可以对孪生体数据进行编辑或新增。表格结构说明如下：

每行代表一个孪生体。
孪生体 ID：
- 如果填写已有孪生体的 ID，则表示更新该孪生体的数据。
- 如果留空，则在导入时会自动创建一个新的孪生体对象。

字段结构参考如下：

名称	数据类型	格式	示例
孪生体ID	字符串	孪生体的唯一标识符	12345-abcde
孪生体名称	字符串	自定义的名称	红色方块1
标识符	字符串	自定义的识别代码	abcde-67890
存储路径	字符串	存储孪生体的位置路径	/My Space
父物体ID	字符串	关联的父级孪生体的ID，若无则留空	12345
姿态位置	vector3	三维坐标位置，表示孪生体在场景中的位置	1.0, 2.5, 0.0

注意：

若表格需更新现有孪生体，必须填写其 ID 字段。
如果要创建新的孪生体，表格中的孪生体ID可为空。
在导入表格之前，请确保关闭编辑完成的表格。

详见FactVerse 平台用户手册中的属性的数据类型中的介绍。

4. 导入表格：

a) 点击主页按钮返回主页。

b) 在主页中，点击【导入表格】按钮。

c) 上传编辑后的 Excel 文件，系统自动创建或更新所有相关孪生体。

场景 Excel 表格导入

适合导出/导入整套场景结构，包括多个模板及其下所有孪生体。

功能说明：

支持集中编辑多个模板的孪生体；
可快速还原整个场景结构；
可用于孪生项目迁移、批量配置属性等场景。

表格结构说明：

工作表页	内容说明
Rules	填写说明与格式要求
Scene_场景名称	当前场景使用的模板信息列表
Template_模板名	模板下的所有孪生体配置（1页/模板）

注意：若孪生体为私有孪生体，其【存储路径】字段将为空。

操作步骤

打开目标场景。
导出场景为 Excel 表格：点击菜单栏【文件】>【导出为表格】，导出场景为 Excel 表格。
编辑表格：可新增或修改任意模板下的孪生体属性与位置，修改完成后保存并关闭表格。
导入 Excel 表格：在 Designer 主页点击【导入表格】，系统自动完成场景结构与孪生体的创建或更新。

标记为公开孪生体

默认情况下，用户新建的孪生体为私有孪生体，仅存在于当前场景中，存储于平台的不可见路径，其他用户无法查看或复用。

为实现资源共享与跨场景复用，您可以将孪生体标记为公开孪生体，上传至云端目录。若该孪生体未被任何场景引用，具有访问权限的用户可在“孪生体列表”中查看并使用该公开孪生体。

操作步骤

1. 在场景中选中一个或多个孪生体。

2. 点击【标记为公开孪生体】按钮，弹出标记为公开孪生体窗口；

3. 在弹出的窗口中勾选公开的孪生体选项。

选项	说明
标记选中私有孪生体 (X)	仅将当前所选中对象中属于私有孪生体的部分上传为公开。若所选中对象中包含非私有孪生体或其他资源，系统会自动过滤，仅处理私有孪生体。X 表示选中的私有孪生体数量。
标记全部私有孪生体 (X)	将当前场景中全部私有孪生体统一标记为公开，X 表示场景中所有私有孪生体的总数。

4. 点击【确认】后：

被标记的孪生体图标由灰色变为蓝色 ；
当前仅为“预标记”状态，并未立即上传至云端目录；

5. 保存场景：

所有“预标记”的孪生体将上传至云端目录；
上传完成后，具有权限的其他用户可以在云端目录中查看并使用。

撤回操作说明

您可以在未保存场景前，撤回预标记状态；
即使已保存，也可以通过撤销操作撤回公开状态，撤销后需重新保存场景方可生效。

删除孪生体

在 FactVerse Designer 中，删除孪生体的操作结果取决于该孪生体是“仅存在于当前场景”的私有孪生体，还是“已上传到云端”的公开孪生体。

操作步骤

1. 执行删除操作：

选中目标孪生体后，按下 Delete 键，或点击右键菜单中的【删除】按钮，即可执行删除操作。

若误删，可通过工具栏的【撤销】按钮恢复。

2. 删除结果：

孪生体类型	删除结果
私有孪生体	将被彻底删除，包括其属性和行为逻辑。操作立即生效。
公开孪生体	仅移除场景中的引用关系，该孪生体实例仍保留在云端资源目录中。

3. 保存场景使删除生效。

💡 注意：

孪生体只能被一个场景引用，删除引用即取消其绑定关系；
场景中删除“公开孪生体”不等于删除其在云端的实例，如果希望从平台上彻底删除某个公开孪生体（即云端资源），需确保该孪生体未被任何场景引用。

重命名孪生体

在 FactVerse Designer 中，您可以为场景中的孪生体进行命名或重命名操作。

注意：FactVerse 资源包中的预设孪生体不支持重命名。

操作步骤

1. 在场景中选中目标孪生体；

2. 在右侧“属性”面板中，点击孪生体名称旁的【编辑】图标；

3. 输入新的名称，按 Enter 或点击场景空白区域确认修改；

4. 点击工具栏中的【保存】按钮，保存场景使修改生效。

配置孪生体外观

孪生体外观配置包括通用的显示模型设置，以及部分特定类型孪生体的专用外观编辑能力。

配置孪生体显示模型

您可以为当前孪生体对象单独添加显示模型，而无需重新定义模板。该功能可用于为设备添加铭牌、标识等附加模型，或为特定设备设置不同的外观模型。

操作步骤

在场景中选中需要配置显示模型的孪生体对象。
在右侧属性面板中点击【孪生体编辑】，进入孪生体编辑模式。

进入孪生体编辑模式后，左侧资源区仅显示资源库，孪生体列表仅显示当前孪生体。

从资源库中选择需要添加的模型，为当前孪生体配置显示模型。支持添加多个模型。

点击【退出】，退出孪生体编辑模式。

退出后，该孪生体的显示模式默认切换为【孪生体模型】。如果未添加孪生体模型，则【孪生体显示模式】下拉列表不可展开，默认显示为【模板模型】。

显示模式

在【孪生体显示模式】下拉列表中可切换以下显示方式：

模板模型：显示孪生体模板中的原始模型；
孪生体模型：显示在孪生体编辑模式中新添加的模型；
叠加：同时显示模板模型和孪生体模型。

注意事项

该操作仅对当前孪生体对象生效，不影响原始模板定义；
其他引用同一模板的孪生体对象不会因本次操作发生变化。

编辑平型传送带孪生体

平型传送带支持专用编辑功能。您可以在场景中对传送带进行延长、删减，并调整传送带段的高度、长度和宽度。

一条平型传送带可由多个传送带段首尾连接组成。传送带段支持直线形和弧线形两种类型。

选中平型传送带孪生体后，点击传送带上方的【编辑】按钮，进入传送带编辑模式。

编辑元素说明

编辑元素	说明
编辑工具栏	包含【删除节点】【结束编辑】【延长】等操作。
传送带段	传送带的基本组成部分，可为直线形或弧线形。
端点节点	位于传送带两端，用于表示传送带的起点和终点。
连接节点	位于相邻传送带段之间，用于连接不同传送带段。
高度调整柄	用于调整相关传送带段的高度。
长度调整柄	用于调整当前直线段的长度。

创建传送带段

点击【延长】，进入传送带延长模式。
在传送带末端单击放置节点，系统会自动生成新的直线传送带段。默认按固定轴向绘制，按住 Shift 键可自由绘制。
如需创建弧线段，在延长模式下按 Ctrl 键切换为弧线编辑模式，并在属性区设置【曲线角度】。

点击鼠标右键，退出延长模式。

调整传送带段

调整高度：单击节点后上下拖拽，可调整节点高度；按住 Shift 键可多选节点。
调整长度：拖动直线传送带段上的红色双向箭头，可调整该段长度。
删除传送带段：点击【删除节点】，系统会删除最后创建的一段传送带段。

说明：弧线段两端的节点不可选中，也不支持高度调整。

使用表格管理传送带段

点击传送带上方的【编辑】按钮进入编辑模式后，右侧属性区会显示传送带段表格。表格中列出当前传送带包含的所有传送带段，每一行代表一段传送带段。

初始未编辑过的平型传送带默认包含一段首段直线形传送带段。您可以通过表格新增传送带段、切换传送带段类型，并编辑各段的长度、角度、半径、标高和高度差等参数。

操作步骤如下：

选中平型传送带孪生体，点击传送带上方的【编辑】按钮。进入编辑模式后，右侧属性区显示传送带段表格。
在表格中编辑传送带段类型和参数：
- 点击表格底部的【+】，可新增传送带段，新增的传送带段默认为直线形。
- 点击类型列中的直线或弧线图标，可切换传送带段类型。
确认表格修改后，点击【应用】，将表格中的修改同步到场景中的传送带。
完成编辑或需要退出时，点击【结束编辑】，退出编辑模式。退出后，传送带段表格将自动隐藏。

传送带段表格说明

表头	适用类型	说明
类型	直线形 / 弧线形	设置当前传送带段的形状。支持切换为【直线形】或【弧线形】。
长度	直线形	设置直线传送带段的长度。当前类型为弧线形时，该字段置灰，该数值自动计算生成。
角度	弧线形	设置弧线传送带段的转角角度。当前类型为直线形时，该字段置灰，保留数值但不生效。
半径	弧线形	设置弧线传送带段的转弯半径。当前类型为直线形时，该字段置灰，保留数值但不生效。
标高	直线形 / 弧线形	设置或显示当前传送带段端点相对于传送带孪生体自身位置的高度。例如，传送带位置高度为 10，端点高度为 20，则该端点标高为 10。
高度差	直线形 / 弧线形	设置当前传送带段从起点到终点的高度变化。正值表示上升，负值表示下降，0 表示水平。

调整孪生体出入口

使用模板创建孪生体后，孪生体实例会继承模板中配置的入口和出口。您可以根据当前场景中的摆放位置和流转需求，调整孪生体实例的出入口位置，并配置与其他孪生体之间的连接关系。

操作步骤如下：

在孪生体上找到并选中需要调整的入口或出口。
根据实际流转位置，移动入口或出口到合适的位置。
如需配置连接关系，点击需要连接的出口，然后选择【连接】。
将鼠标移动到目标孪生体的入口上方，点击鼠标左键，完成连接。
点击工具栏中的【保存】按钮，保存当前配置。

说明：

孪生体实例中的出入口调整仅对当前孪生体生效，不会影响原模板及其他由该模板创建的孪生体。
通常从一个孪生体的出口连接到另一个孪生体的入口。
一个出口可以连接多个入口。
同一个孪生体自身的出口和入口无需连接。
如果孪生体未显示入口或出口，请先确认其模板中是否已配置对应的出入口资源。

配置孪生体存储区

存储区用于定义孪生体中可存放货物的位置和数量。通过设置 X、Y、Z 三个方向的数量，可以将存储区划分为规则的网格库位，系统会根据配置自动计算各货位坐标。

该功能适用于暂存区、货架、缓存区、托盘区等需要按固定位置存放货物的孪生体。

操作步骤

在场景中选中包含存储区结构的孪生体。
在属性面板中找到【存储】属性组。

分别设置 X、Y、Z 三个方向的存放数量。

设置完成后，系统会根据数量自动生成对应的库位坐标。

如需隐藏场景中的存储区辅助外框，可勾选【隐藏外观】。

勾选后，场景中不再显示存储区的半透明参考框，但不会影响货物的存放逻辑。

属性	说明
X 方向数量	设置长度方向的货位列数。数值越大，横向可存放的货位越多。
Y 方向数量	设置高度方向的货位层数。用于控制货物可纵向堆叠的层数。
Z 方向数量	设置宽度方向的货位行数。数值越大，纵深方向可存放的货位越多。
隐藏外观	控制存储区参考外框是否显示。开启后隐藏半透明外框，仅保留存储逻辑。

说明：

X、Y、Z 三个方向的数量共同决定存储区的总货位数。例如，X 方向数量为 3、Y 方向数量为 2、Z 方向数量为 4 时，存储区最多可生成 3 × 2 × 4 = 24 个货位。

场景管理

本节介绍孪生场景的创建、打开与删除方式，以及在特定场景绑定关系下的使用说明。

新建场景

您可以通过以下任一方式新建孪生场景：

在主页点击【新建场景】按钮；
在场景编辑器界面中，点击【文件】 > 【新建】。

系统将创建一个新的空白孪生场景，并进入场景编辑界面。

打开场景

您可以通过以下方式打开已有孪生场景：

在主页中，从 FactVerse 平台的数字孪生库中选择目标孪生场景并打开；
在场景编辑器界面中，点击【文件】 > 【打开】，选择云端场景。

使用说明

当打开 已绑定空间孪生体的孪生场景 时，请注意：

该场景在三维空间中的原点，并非全局坐标的 (0, 0, 0)，而是位于其所属“大空间场景”中的相对位置；
若在场景中放置已在 Brick Schema 中配置了大空间坐标的设备孪生体：
- 设备将在当前场景中以相对位置正确显示；
- 但在属性面板中，设备的【位置】和【旋转】仍显示为大空间坐标；
因此，属性面板中的坐标数值，可能与场景画布中直观观察到的位置存在差异。

删除场景

孪生场景的删除需在 FactVerse 平台的数字孪生库 中进行：

仅具备相应删除权限的用户可执行该操作；
删除后，场景将从平台中永久移除，请谨慎操作。

场景的导入和导出

场景导入和导出用于备份、迁移、共享或复用数字孪生场景。

导出场景

您可以通过以下任一方式导出场景：

在主页【孪生场景】模块中，选择需要导出的场景，点击【导出场景】；
打开场景后，在顶部菜单栏中选择【文件】>【导出场景】。

如果当前场景中包含加速附件，导出时系统会弹出确认窗口，提示是否同时导出加速附件。

您可以根据需要选择：

选项	说明
导出加速附件	导出的 .digpkg 文件会包含场景相关资源及加速附件。导入后，相关资源可继续使用该附件。
不导出加速附件	仅导出场景及基础资源，不包含加速附件。导入后，场景仍可正常使用。

导出后，系统会生成 .digpkg 格式的场景文件。该文件可用于场景备份、迁移或共享。

导入场景

在主页【孪生场景】模块中，点击【导入场景】，选择需要导入的 .digpkg 文件。

导入时，系统会尝试将场景恢复到导出前所在的目录位置。导入到当前租户或其他租户时，系统会根据原目录路径自动创建不存在的同名目录，用户无需提前手动创建目录。

如果目标租户中已存在相同目录路径，当前账号需要具备该目录的访问权限，才能将场景导入到该位置。

导入完成后，场景会显示在与原场景相同的目录位置。具有该目录访问权限的用户可打开并继续编辑或使用。

说明：

不支持导出DLC 场景。
导出的 .digpkg 文件会包含场景、相关资源和缩略图信息。导入后，系统会自动恢复原有缩略图显示效果。
仅当场景中存在加速附件时，导出时才会显示是否导出加速附件的提示。
导入场景时，场景会被保存在导出前所在的目录位置。因此，执行导入操作的用户需要具备该目录的访问权限。
导入、导出功能需企业租户已开通对应权限，可由管理员在 License 管理页面查看。

自定义小工具

您可以将已调整参数的小工具保存为自定义预设，方便在后续场景搭建和孪生体模板编辑中快速复用。所有自定义小工具将出现在 资源库 > 工具 > 自定义 区域中。

添加自定义小工具

操作步骤

1. 在 资源库 > 工具 面板中，选择一个小工具放入场景区中。

2. 根据需要调整其属性参数。

3. 参数修改完成后，点击属性面板中的【保存预设】按钮。

4. 在弹出的命名窗口中输入名称，点击【确定】。

5. 该小工具将以自定义预设形式出现在 资源库 > 工具 > 自定义 区域，图标与原小工具保持一致。

编辑与管理自定义小工具

更新已有设置：

从资源库中选择自定义的小工具放入场景区中。
根据需要调整其属性参数。
点击【保存预设】按钮。
在弹出的命名窗口中，输入与原有预设相同的名称。
在系统提示窗口中点击【确定】即可覆盖原有预设内容。

重命名或删除自定义小工具：

在 资源库 > 工具 > 自定义 区域中，右键点击目标小工具，弹出操作菜单。

选择【重命名】或【删除】进行管理操作。

路径模式

路径模式 是用于在数字孪生场景中为孪生体指定运动轨迹的一种功能。通过在场景中设置关键点及其连通关系，构建出一张有向连通图，以约束孪生体在场景中的可移动范围和方向。

路径模式应用于整个场景，构建的路径图可被多个孪生体共享，用于实现如 AGV 行驶、机器人巡逻等场景行为。

主要概念

概念	说明
关键点	场景中创建的路径顶点，表示位置节点
连通关系	关键点之间的连接关系，可设定连接方向（单向/双向）
路径	一系列连续关键点构成的路径，供孪生体按照顺序移动

构建模式

“构建模式”用于在场景中新增路径关键点并定义连通关系。

操作步骤

进入路径模式后，点击工具栏中的构建按钮。
在场景中点击任意位置添加第一个点，移动鼠标再点击，即可添加第二个点并自动生成连接线。
持续添加关键点，系统会自动以设置的默认方向连接每个点位。

构建设置

为提升路径构建效率，您可以在场景左上角设置默认构建参数：

参数	说明
点位高度	所有新增点位在场景中的默认高度（Z轴）
连线方向	设置点与点之间的连接方向：正向、反向、双向

选择模式

“选择模式”用于调整已有点位或整体视角，不会创建新路径点。

操作说明：

调整视角：拖动鼠标可旋转或移动场景视角；
修改关键点位置：点击已有关键点，移动或在右侧面板中修改其坐标；
编辑连线方向：选中两个关键点之间的连线后，在右侧属性面板点击“方向图标”，可在正向、反向、双向之间切换。

路径构建基本流程

在场景编辑界面中，点击工具栏中的【路径模式】按钮进入路径模式；
切换至“构建模式”，按需点击场景位置新增关键点；
系统根据默认设置自动连接关键点，生成连线；
切换至“选择模式”，选中关键点/连线调整位置或方向；
选择模式下，点击点位和连线可修改其位置、连线方向。

后续在行为树中可结合路径节点，将孪生体的行为与路径图绑定，实现复杂运动控制。

定位编辑

在创建数字孪生场景时，FactVerse Designer 默认会在场景的 (0, 0, 0) 位置生成一个定位码。用户可以在 DataMesh One 中播放场景时，通过扫描该定位码将数字孪生场景精准地放置在物理环境中的目标位置。

FactVerse Designer 提供了定位编辑功能，允许用户根据需要修改、添加、删除定位码，或使用参考模型辅助场景编辑。

编辑定位码

在场景编辑器中，点击工具栏中的定位模式按钮进入定位编辑模式。

编辑定位码：在定位编辑模式的角色列表（当前场景中所有定位码和参考模型的列表）中，选中定位码，属性面板将显示该定位码的详细信息，包括：

位置：可通过修改位置参数精确调整定位码的三维空间位置。
旋转角度（Y）：修改定位码的 Y 轴旋转角度。
快速方向设置：通过属性面板快速设置定位码的方向（水平或垂直）。

添加定位码：在未选中任何角色的情况下，点击属性面板中的【添加定位码】按钮，即可在场景中新增一个定位码。定位码将自动显示编号。每个场景最多可添加 20 个定位码。

删除定位码：选中不需要的定位码，在角色列表中点击删除按钮，即可移除该定位码。

添加参考模型

在数字孪生场景中，您可以使用参考模型辅助进行场景的编辑与定位。

添加参考模型步骤如下：

进入定位编辑模式：在场景编辑器中，点击工具栏中的定位模式按钮进入定位编辑模式。
添加参考模型：将参考模型放置在场景中，以辅助场景编辑与定位。

退出定位编辑模式：点击【退出】按钮退出定位模式。

辅助定位其他元素：使用参考模型，辅助定位场景中的其他数字孪生体或元素，以确保它们与实际物理环境对齐。

业务数据看板

业务数据看板可用于显示实时的 IoT 数据和模拟数据。用户可以在属性面板中选择数据，同时还可以设置文字颜色、字体大小和数据前缀。

以下为绑定模拟数据的一般操作：

1. 将业务数据看板工具放置到场景中。

2. 调整看板的位置和大小。

3. 在右侧属性区设置业务数据看板的显示样式和内容。

设置项	说明
文本框大小	设置业务数据看板的显示区域大小，可调整宽度和高度。
文字颜色	设置看板中文字的显示颜色。
背景填充	设置看板背景样式，支持纯色背景或图片背景。选择图片背景时，可使用系统默认的 Vision Pro / Quest UI 风格背景，也可从资源目录中选择自定义图片作为背景。
字号	设置看板中文字大小。
对齐方式	设置看板内容的对齐方式，支持左对齐、居中和右对齐。
朝向用户	开启后，看板会始终面向用户视角，便于查看内容。
显示孪生体名称	开启后，看板中显示已关联孪生体的名称。
显示属性组名称	开启后，看板中显示属性所属的属性组名称。
显示属性名称	开启后，看板中显示属性名称。
标题内容	设置看板标题或说明文字。

4. 点击【+选择孪生体】后，在弹出的孪生体列表中选择需要展示数据的孪生体。

选择后，【+ 选择孪生体】位置会显示已选孪生体名称。如需更换孪生体，可点击该名称重新选择。

5. 在已选孪生体下方的属性列表中，选择需要在看板中展示的属性数据。

6. 如需将当前看板样式保存为自定义工具，点击【保存预设】。

保存后，该看板会出现在【资源库】>【工具】>【自定义】中，便于后续复用。

7. 点击页面右上角的【调试播放】按钮可查看效果。

编辑场景课件

适用对象：企业中的教师用户

目标：在 FactVerse Designer 中将场景与课件绑定，为角色指定操作孪生体，并编辑自定义题的逻辑，包括触发、成功、失败条件及计分规则。

编辑课件流程概述

编辑场景课件的流程主要分为两个阶段：

第一阶段：准备课件（在 FactVerse 平台完成）

创建场景课件，设置基础信息（名称、时长、及格分数等）
添加题目（支持单选、多选、自定义题）
发布课件，供 Designer 中进行后续绑定与编辑。
创建培训组，为学员分配学习和考试任务。

也可在 Designer 编辑完成后回平台创建培训组。

准备课件操作详见《FactVerse 平台用户手册》的“学习管理”章节。

第二阶段：编辑课件（在 FactVerse Designer 中完成）

绑定课件与场景。
绑定角色与孪生体。
编辑自定义题题目逻辑。
运行并验证题目设置是否正确。

绑定课件与场景

绑定关系说明：

每个课件 只能绑定一个场景
绑定后 不可更换

操作步骤

建议使用创建该课件时所使用的 Designer 版本进行查看与编辑。若使用旧版本 Designer 打开由新版本创建的课件，可能因题型结构升级产生兼容性问题，导致部分内容无法正常显示或编辑。

1. 在主页【课件】模块中，点击并打开目标课件。

2. 若未绑定场景，需选择场景进行绑定或点击【新建场景】创建场景并根据孪生场景搭建流程进行场景设计后再进行绑定。

为角色绑定孪生体

在考试课件中，可以为角色绑定对应的孪生体。绑定后，考生选择该角色进入考试场景时，系统会将该角色与指定孪生体关联，考生需要围绕该孪生体完成对应题目操作。

示例：

角色为“叉车操作员”时，可绑定叉车孪生体，用于完成驾驶类题目；
角色为“维修工”时，可绑定设备面板孪生体，用于完成设备检查或维修类题目。

操作步骤

在场景区中选中需要与角色关联的孪生体。
在右侧属性面板中，将【设置扮演】设置为【是】。
在角色列表中选择需要绑定的角色。

保存课件。

编辑自定义题

自定义题可通过两种方式添加：

在FactVerse 平台中添加：仅创建题目基本信息（题干、角色等），不含逻辑与评分；
在 Designer 中创建或编辑：补充题目触发条件、成功/失败逻辑、得分规则等。

自定义题题目逻辑配置

1. 设置判题逻辑

自定义题支持通过设置触发条件、成功条件、失败条件来实现考试任务的自动启动、完成判定与违规识别。

条件类型	说明
触发条件	定义考题开始执行的条件，基于孪生体状态、交互行为或外部事件。
成功条件	判定考生完成任务的标准，通常依赖操作结果和孪生体状态。
失败条件	判定考生未完成任务或操作错误的条件，如碰撞、违规操作等。

示例：车辆避障训练

场景：考生驾驶车辆驶出停车场，需避免碰撞障碍物。

触发条件：

车辆接近出口：使用“比较距离”条件判断车辆与出口之间的距离是否小于 2m，从而触发考题。
车辆尚未通过出口：使用“比较两个孪生体的属性值”条件设置：车辆的通过状态标记 = 0。

成功条件：

车辆未发生碰撞：使用“比较两个孪生体的属性值”条件设置：车辆的“是否发生碰撞”属性= 0。
车辆成功驶出出口：使用“比较两个孪生体的属性值”条件设置：车辆的通过状态标记 = 1。

失败条件：

车辆发生碰撞：使用“比较两个孪生体的属性值”条件设置：车辆的“是否发生碰撞”属性= 1。

2. 配置得分方式

考生完成自定义题后，系统可通过以下方式计算得分：

得分类型

说明

直接得分

完成此题后直接获得固定分值（例如：100分）

时间得分

根据完成任务的用时，在预设的时间段内按比例计算得分。

例：
• 操作成功得分 = 100 分；
• 该操作时间段的权重为 80%；
→ 实际得分 = 100 × 80% = 80 分；
• 若未启用【时间得分】，则默认采用“直接得分”。

如需启用时间得分，请在自定义题配置界面中勾选【时间得分】，并设置各时间段的百分比。

编辑步骤

1. 设置交互逻辑：在编辑题目之前，先确保场景中已配置与考题相关的交互逻辑（如孪生体属性变化、移动等），使考题具备可执行的场景基础。

2. 展示角色相关的题目：在左侧题目列表中选择角色，展开角色对应的考题列表。

3. 新增自定义题：

如未在平台中添加自定义题，可在 Designer 中点击【+】>【自定义题】按钮进行创建。

若题目已由平台创建，此步骤可跳过。

4. 编辑题目逻辑：在题目列表中，点击目标题目右侧的【编辑】图标，打开题目编辑窗口。

5. 配置条件与得分规则：在编辑界面中设置题目的触发条件、成功/失败条件以及得分方式（直接得分、时间得分等）。

6. 保存题目：配置完成后，点击【完成】按钮保存编辑内容。

运行验证

您可以通过模拟考生操作，验证题目的设置逻辑与评分机制是否符合预期。

操作步骤

1. 播放场景：点击工具栏【调试播放】按钮，进入课件模拟运行模式，在角色列表中选择答题的角色。

2. 执行考题测试：在播放界面中模拟答题，验证题目是否设置正确：

选择题：测试单选、多选是否能正常作答与得分。
自定义题：执行设定的交互操作（如点击、拖动孪生体），检查是否触发题目。
判定逻辑测试：
- 正确操作应判定为成功；
- 错误或违规操作应判定为失败。
得分验证：检查得分是否符合设定规则（如直接得分、时间得分等）。

3. 返回编辑器进行调整（如有问题）：若测试过程中发现触发异常、判定不准确、得分错误等情况，可直接返回编辑界面，修改题目设置并重新验证。

碰撞检测

功能概述

碰撞检测 功能用于在模拟过程中判断孪生体之间是否发生物理接触，帮助验证场景设计的合理性与操作路径的安全性。通过碰撞检测，用户可以快速发现潜在的设计缺陷，优化设备布局和运行路径，从而降低事故风险。

关键步骤

要实现碰撞检测，需要完成以下配置：

指定负责输出碰撞结果的孪生体
- 在其模板中启用 参与碰撞
- 在其模板中添加 “碰撞检测”预设结构，该结构会实时记录该孪生体的碰撞信息（包括碰撞对象、角色等）
配置其他参与碰撞的对象(孪生体 或模型)
- 在场景中勾选这些对象的参与碰撞属性，使其能与负责输出的孪生体产生碰撞交互。
运行模拟并分析结果

注意事项：

碰撞检测需要 所有参与物体（孪生体 / 模型） 启用 参与碰撞；
只有添加了 “碰撞检测”预设结构 的孪生体，才会输出并记录碰撞结果；
场景中可同时包含多个检测对象，但至少需要一个孪生体负责输出结果。

示例

本示例模拟一个会移动的小球孪生体与静止的方块和圆柱体发生碰撞，用于验证碰撞检测是否生效，并观察碰撞信息在孪生体属性中的变化。

1. 创建会移动的小球模板：按照会移动的小球章节，创建一个包含移动行为的小球孪生体模板。

2. 设置小球参与物理碰撞：选中小球，在属性面板中勾选“参与碰撞”选项。勾选后，小球将参与物理引擎计算的碰撞检测逻辑。

3. 添加“碰撞检测”预设结构到小球模板：在小球模板中添加系统预设的“碰撞检测”结构，用于捕捉碰撞状态。

该预设结构包含以下属性：

属性名称	类型	说明
碰撞到的孪生体	string	记录与当前孪生体发生碰撞的对方孪生体名称
碰撞到的角色	string	记录与当前孪生体发生碰撞的对方孪生体绑定角色名称
是否发生碰撞	bool	true 表示发生碰撞，false 表示未发生碰撞

4. 保存小球模板：完成设置后点击【保存】按钮，保存当前模板。

5. 创建方块模板并设置参与碰撞：

a) 在模板编辑器中新建方块模板，放置立方体模型。

b) 在属性面板中勾选“参与碰撞”选项。

c) 点击【保存】按钮保存模板。

6.搭建测试场景：

a) 新建一个测试场景。

b) 将“移动的小球”、“方块”孪生体放入场景中。

c) 可额外添加一个静止圆柱体模型，用于测试多目标碰撞。

d) 调整位置关系，如将方块与圆柱体分别放置在小球的运动路径上。

7. 播放预览：

a) 点击工具栏【调试播放】按钮，运行场景；

b) 选中小球孪生体，打开属性面板。

c) 观察 “碰撞的孪生体”、“碰撞的角色”字段是否正确显示与其发生碰撞的对象名称。

8. 模拟分析：请参考查看碰撞分章节的介绍。

场景编辑辅助工具

测量工具

测量工具用于测量场景中两个位置之间的距离，也可作为文字标注使用。您可以用它测量模型间距、高度、水平跨度，或添加“预留间距”“安全距离”“设备检修通道”等备注信息。

操作步骤

从【资源库】-【工具】中拖出【测量工具】，在场景中点击确定端点 A 的位置。端点支持吸附到模型表面，便于从模型边缘或指定位置开始测量。
移动鼠标拉出测量线段。

在拉伸测量线段时，可按 Shift 键切换测量方向。

每按一次 Shift，测量方向会在以下模式间循环切换：

模式	说明
锁定 X 轴	仅沿 X 方向拉伸测量线段，用于测量 X 方向距离。
锁定 Y 轴	仅沿 Y 方向拉伸测量线段，用于测量高度。
锁定 Z 轴	仅沿 Z 方向拉伸测量线段，用于测量 Z 方向距离。
自由吸附	不锁定方向，可自由选择终点位置。

再次点击场景，确定端点 B 的位置，完成测量。

如需调整测量文字样式，可在右侧属性面板中设置文字颜色、字号等属性。
根据需要设置测量内容显示方式。

- 自动测量：勾选【自动测量】后，测量工具会实时显示端点 A 和端点 B 之间的距离。
- 手动备注：取消勾选【自动测量】后，可在【内容】输入框中填写备注文字。此时场景中显示用户输入的文本，不再显示测量数值。

如需微调测量位置，可选中端点子层级，单独调整端点 A 或端点 B 的位置。

拖动端点时，端点会根据【方向】设置锁定轴向或自由移动。

说明

如果测量点未吸附到模型或地面，测量工具会默认在 Z=0 平面上生成。
如果测量时参考的模型被删除，测量工具的位置会保持不变，不会自动消失。
测量工具既可用于距离测量，也可用于场景标注。若仅需显示说明文字，可取消勾选【自动测量】并填写备注内容。

碰撞及范围监测

碰撞及范围监测用于辅助用户在场景编辑过程中检查货物摆放是否发生碰撞，或是否超出指定堆放范围。该功能适用于货物堆放、车辆装载、仓储摆放等需要控制物体位置和边界的场景。

操作步骤

配置货物模板

在【模板编辑器】中，为需要参与检测的货物模板添加【碰撞检测】预设结构，并根据需要开启【参与碰撞】。

配置完成后，使用该模板创建的货物孪生体可参与后续碰撞及范围监测。

创建货物孪生体

在【场景编辑器】中，使用货物模板创建货物孪生体并放置在场景中。

添加【范围检测】组件

从【工具】窗格中添加【范围检测】。

【范围检测】组件用于定义货物可堆放的边界范围。用户可以根据实际场景需要添加一片或多片【范围检测】组件，围出货物允许摆放的区域。

例如，在需要限定一个堆放区域时，可以使用多片【范围检测】组件分别作为前、后、左、右及上方边界。实际使用数量可根据场景需求调整。

调整【范围检测】范围

选中一个【范围检测】组件后，通过操作柄调整其长、宽、高，使其覆盖或围合目标货物堆放区域。

摆放货物并检查范围

在堆放范围内摆放或拖拽货物。如果货物与【范围检测】组件发生碰撞，系统会在场景中提示：超出范围，请调整位置。

根据提示调整货物位置

您可根据提示移动或旋转货物，使其回到允许的堆放范围内。

提示规则

碰撞或超出范围时，系统会在发生碰撞的瞬间显示提示。
如果物体持续处于碰撞状态，系统不会重复弹出相同提示，避免提示堆叠。
当用户调整位置解除碰撞后，如果再次发生碰撞，系统会重新提示。

重力模拟

重力模拟用于帮助用户快速摆放物体。用户可以先通过重力模拟得到自然下落、堆叠或装载效果，再选择是否将模拟结果保留为场景中的初始摆放状态。

该功能适用于货物堆放、车辆装载、施工材料摆放等需要模拟自然堆叠效果的场景。

前提条件

使用重力模拟前，需要先在【模板编辑器】中为相关孪生体完成以下配置：

勾选【参与碰撞】；
配置【姿态】中的【质量】属性；
添加并配置【重心】预设结构；
添加并配置【碰撞检测】预设。

配置重力模拟相关属性

打开需要参与重力模拟的孪生体模板。
在属性面板中勾选【参与碰撞】。
配置【姿态】中的重力模拟相关属性。

属性	类型	说明
质量	Double	设置孪生体的质量，影响重力模拟和碰撞后的堆叠效果。单位： kg
统计标识	String	可选配置。用于给孪生体设置分类标记，便于行为树批量筛选或统计同类对象。例如，多个货箱都设置为 box，行为树即可按 box 查找或统计这些货箱。该属性不是重力模拟的必要条件。

从元数据栏添加【重心】预设结构。

属性	类型	说明
重心	Vector3	设置孪生体在重力模拟中的受力中心。重心位置会影响物体下落、倾斜和堆叠效果。

设置重心位置。

您可以通过以下方式设置重心：

- 手动输入：在【默认值坐标】中填写 X、Y、Z 数值，或在场景中拖拽红色重心球调整位置。
- 选择模型：如果模型资源中已包含重心信息，可在【获取方式】中选择对应模型，系统会根据模型信息自动设置重心位置。

如果不确定重心位置，建议先设置在物体主体中心附近，再通过重力模拟效果进行调整。

开启重力模拟

进入【场景编辑器】，使用已配置的模板创建孪生体，并将其摆放到需要模拟的位置。
点击工具栏中的【重力】按钮，开启重力模拟。

开启后，已配置【质量】并勾选【参与碰撞】的孪生体会在重力作用下自然下落，直到与地面网格或其他参与碰撞的物体接触。

关闭重力模拟

点击【退出】或再次点击【重力】按钮，关闭重力模拟。
在弹出的确认窗口中，选择是否保留当前模拟结果。

选项	说明
是	保留模拟结果，孪生体将保持下落或堆叠后的状态。系统会生成可撤销记录，后续可通过【撤销】恢复到开启重力前的位置。
否	不保留模拟结果，所有参与模拟的孪生体恢复到开启重力前的位置。
取消	返回重力模拟状态，继续进行模拟。

异常提醒

如果场景中存在重心位置异常的孪生体，开启重力模拟时，系统会提示：

检测到场景中部分孪生体重心异常，可能导致重叠弹飞，是否继续？

出现该提示时，建议先检查相关孪生体的【重心】配置是否合理，再重新开启重力模拟。
如果选择【确认】，系统仍会继续模拟，但结果可能不稳定；选择【取消】可返回场景继续调整。

说明

重力模拟开启期间，为避免物理状态冲突，【调试播放】【撤销】【重做】按钮不可用。
重力模拟开启期间，不支持修改模型姿态参数。
如果选择保留模拟结果后对位置不满意，可通过工具栏中的【撤销】回滚到保留前的状态。
若孪生体未配置【参与碰撞】、【质量】或【重心】，重力模拟效果可能不符合预期。
重心位置不合理时，可能导致物体倾斜异常、堆叠不稳定或弹飞，建议根据模拟效果适当调整。

自主寻路

自主寻路功能基于三维路径模拟、碰撞检测与安全范围建模，为孪生体提供自动化、避障的路径计算能力。适用于 AMR（Autonomous Mobile Robot，自主移动机器人）自主导航、人员安全路径模拟等复杂场景。

应用场景

场景类型	说明
物流与作业优化	快速规划设备或人员最短路径，减少能耗与路径浪费。
风险预判与规避	通过路径模拟发现潜在碰撞、卡死等风险，优化工艺布置与作业流程。

名词解释

名词	说明
自主寻路	仅添加了“自主寻路”预设属性的孪生体，才可执行【自主寻路移动】行为树节点。
安全范围盒	表示孪生体寻路时的物理空间范围，显示为线框圆柱体，用于避让与路径计算。
安全范围直径/高度	安全范围盒的尺寸定义，在“自主寻路”结构中设置。单位为米。
自主寻路移动	行为树节点，用于驱动孪生体按照寻路面规划的最优路径移动。
寻路面	定义孪生体可移动的区域，路径仅会在该区域内规划。
寻路面扩散距离	指参与生成寻路面计算的孪生体与最终寻路面边缘之间的缓冲距离，避免碰撞贴边。

关键步骤

实现自主寻路通常分为四个阶段：

1. 配置孪生体

在目标孪生体模板中添加 “自主寻路”结构；
系统会自动生成安全范围盒，并在属性面板中设置直径与高度。

注意：自主寻路与“参与碰撞”不可同时启用。如需孪生体参与路径规划，请仅保留“自主寻路”设置，否则孪生体将无法移动。

2. 配置场景寻路环境

添加用于寻路面的地面模型，并启用 参与碰撞；
将可寻路孪生体放入场景；
放置障碍物（需启用 参与碰撞）。

3. 生成寻路面

在 场景属性 → 自主寻路设置 中配置扩散距离（默认2 m）；
点击【生成】，系统自动构建可移动路径区域；
若修改了场景内容，需点击【重新生成】。

4. 验证寻路效果

使用 模拟回顾 功能生成并回放模拟记录；
在数据看板中查看 路径分析表 与 碰撞分析表，并将路径叠加到场景中；
检查是否存在碰撞、避障失败、绕行异常等问题；
如需优化，可调整寻路面设置、安全范围、障碍物位置，重新生成寻路面后再次验证。

详细说明：请参阅 模拟回顾 → 查看模拟运行路径

示例

以下示例展示了如何为孪生体配置自主寻路功能：

1. 打开模板编辑器：在模板编辑器中打开目标孪生体模板。

2. 添加“自主寻路”结构：为目标孪生体模板添加“自主寻路”结构，系统将自动在模板中心生成安全范围盒（不可移动）。

3. 设置安全范围参数：在属性面板中设置安全范围直径与高度。

属性配置说明

属性名称	类型	默认值	是否可编辑	显示状态
安全范围直径	double	0.5 米	是	是
安全范围高度	double	0.5 米	是	是

4. 配置行为树节点：

a) 新建行为树，并在行为树编辑器中添加【自主寻路移动】节点。

b) 配置如下属性：

配置项	说明
要移动的目标	选择需要执行寻路的孪生体
目标速度	最大移动速度（非加速/减速状态下）
终点	设置路径终点位置（支持选孪生体、出入口、手动输入等）
到达后退出节点	是否在到达终点后自动退出该节点以继续执行其他节点。开启：在距离终点设置的终止距离内时结束自主寻路；关闭：到达终点时不结束此节点的运行，终点位置发生变化时继续寻路
终止范围	孪生体距离终点小于该值时判定为“已到达终点”（单位：米）

5. 保存模板：完成设置后保存模板，退出模板编辑界面。

6. 配置场景寻路环境

a) 添加寻路地面模型并启用“参与碰撞”；

b) 将已配置了“自主寻路”结构的孪生体放置在场景区中；

c) 放置任意障碍物，并勾选“参与碰撞”；

7. 生成寻路面

a) 在场景属性中配置扩散距离；

b) 点击【生成】，自动构建可移动路径区域；

8. 验证寻路效果

a) 生成并上传模拟记录；

b) 查看模拟运行路径；

c) 根据验证结果，调整场景参数进行优化。

模拟回顾与数据分析

在 Designer 中，您可以借助模拟回顾与 DFS 数据看板功能，采集并分析设备在不同运行条件下的仿真数据。通过 3D 场景回放与多维度数据可视化，帮助您深入理解仿真过程、评估运行效果，并指导后续优化。

注意：该功能目前 仅支持 Windows 系统。

该功能支持以下目标实现：

收集设备运行参数（如速度、温度、压力）、生产进度数据（如完成数量、生产时间）及设备故障数据；
生成可视化图表，直观呈现仿真结果；
基于分析结果优化参数配置，不断改进流程设置
提升设备运行效率与资源利用率，降低生产成本，助力产品质量与交付能力提升。

基本流程

模拟回顾与分析的完整流程包括以下三个阶段：

搭建场景：构建包含关键仿真逻辑的场景（如碰撞检测、自主寻路、生产流程等）；
生成并上传模拟记录：在场景运行过程中生成模拟数据，并将记录上传至 DFS 数据平台。
开展模拟分析：进入模拟回顾界面，结合 DFS 数据看板进行以下分析操作：

- 查看多维度 数据图表分析；
- 回放 3D 模拟过程，辅助理解设备运行行为；
- 检查 碰撞分析表，定位风险事件；
- 可视化 运行路径轨迹，优化设备调度与布局。
- 通过AI分析助手生成模拟分析报告。

生成并上传模拟记录

生成模拟记录可保存仿真运行结果，为后续分析提供依据。

操作步骤

1. 打开目标场景：打开要生成模拟记录的目标场景。

2. 生成模拟记录：

a) 点击工具栏中的【生成模拟记录】按钮。

b) 在弹出的【生成模拟记录】窗口中完成以下配置：

- 模拟名称：默认格式为 YYYY-MM-DD_V1；
- 模拟时长：格式为 DD:HH:MM:SS，每个字段最大值为99，仅可输入整数；
- 快速模拟运行：
  - 若勾选，则【模拟时长】为必填项，系统将快速生成运行结果；
  - 若未勾选，则【模拟时长】为非必填项，系统将按 1 倍速真实运行；

特殊情况（包含碰撞/寻路模拟）：不支持“快速模拟运行”，当时长设置默认为空时，按照 1 倍速运行。

c) 点击【确认】，开始模拟运行。

建议在场景模拟时关闭其他大型应用

3. 上传模拟记录

自动上传：若设置了模拟时长，运行结束后系统将自动上传模拟记录；
手动上传：若未设置模拟时长，需点击模拟运行界面的退出按钮，并在提示框中选择【是】上传记录；如果选择【否】返回主页后界面右下角有提示“存在未上传的模拟记录”，点击提示进行上传。

保存路径：上传后的模拟记录保存至 DFS，并归类到 Designer_Scenes 目录下对应场景中。

注意事项（Insight 版订阅）

模拟记录云端存储上限（50 条）

Insight 版最多可存储 50 条模拟记录，企业内所有用户共享此配额。若达到上限，将无法继续上传新记录。请前往 FactVerse 平台删除不需要的旧记录后再试。

提示：请避免误删他人的重要记录。

单次数据分析上限（100万条）

若生成过程中的数据量超过Insight订阅版本的单次处理上限，系统会自动暂停并提示您选择：上传已生成部分结果，或放弃本次模拟。

如需更高容量和单次分析数据量，可联系 DataMesh 了解私有化部署方案。

进入模拟回顾

您可通过以下两种方式进入模拟回顾：

方式一：上传记录完成后直接进入

在上传模拟记录完成提示框中，点击【确定】，系统会自动打开 DFS 页面。

DFS 页面以窗口形式浮于 Designer 场景上方，并默认最大化显示。

未配置数据看板的场景：默认定位至刚上传的数据集页面；

已配置数据看板的场景：默认进入该数据集对应的数据看板页面。

方式二：从主页进入

在主页点击 【模拟回顾】 按钮打开DFS通用数据集页面；

选择目标数据集后，即可进入模拟回顾与数据分析，执行如查看数据分析图表、查看数据看板、回放3D模拟记录等操作。

查看数据分析图表

通过图表直观分析仿真运行情况，识别生产瓶颈和优化机会。

操作步骤

1. 进入模拟回顾界面。

2. 在 DFS 窗口中：

a) 点击目标数据集，进入该数据集的数据查看页面；

b) 配置、查看生成的图表和分析结果。

更多详细操作请参阅《DataMesh FactVerse DFS 用户手册》中的“数据查看”章节。

回放 3D 模拟记录

回放 3D 模拟记录可复现仿真全过程，帮助复盘与问题排查。

操作步骤

进入模拟回顾界面。
点击【3D结果查看】按钮，加载并回放该数据集的模拟记录。

最小化 DFS 窗口，显示下方 Designer 场景，场景中会加载对应模拟记录的 3D 数据。

使用以下播放控制按钮：

- 播放 /暂停
- 重播
- 播放速度：播放时支持调整倍速（最高20倍速），但不支持拖拽进度条或时间点跳转。

点击【Data Fusion Services】可重新打开 DFS 窗口，继续进行数据分析或切换数据集。

查看数据看板

查看碰撞分析表

碰撞分析表可快速定位模拟过程中的所有碰撞事件，帮助用户复现问题、优化设备布局与运动路径。

操作步骤

进入模拟回顾界面。
配置碰撞检测看板：在 DFS 中选择目标数据集，配置数据看板并添加 碰撞检测组件。（详见《DFS 用户手册》“配置看板组件 → 碰撞检测”）；
查看碰撞分析表。

碰撞分析表

碰撞分析表会记录模拟运行中的所有碰撞事件，方便用户快速定位碰撞时间、对象及角色。

时间点	碰撞物体 A名称	碰撞物体 B名称	碰撞物体 B 角色
碰撞发生的具体时间（DD:HH:MM:SS）	第一个发生碰撞的孪生体或模型名称	第二个发生碰撞的物体名称	碰撞对象中产生碰撞的角色名称

查看模拟运行路径

模拟运行路径功能可在 3D 场景中直观呈现移动设备的完整运行轨迹，辅助用户：

评估路径的合理性与效率；
发现潜在的优化空间；
提前预判碰撞或拥堵风险；
制定更优调度方案。

操作步骤

进入模拟回顾界面。
配置路径分析看板：在 DFS 窗口中选择目标数据集，配置数据看板并添加 路径分析组件（详见《DFS 用户手册》 → 配置看板组件 → 路径分析）。
在路径分析表中，勾选需要显示运行路径的 孪生体名称；
点击【3D场景查看】，最小化 DFS 窗口，查看叠加到场景中的路径。

说明：

路径显示为静态轨迹：模拟中所有路径点连线形成的完整轨迹；
支持多条路径同时叠加显示，便于对比分析。

模拟分析报告

在模拟回顾的数据看板中，可唤起 AI 分析助手，对场景的模拟运行结果进行智能分析，并生成可编辑、可下载的模拟分析报告，用于结果评估与汇报。

生成报告

Designer支持通过 AI 分析助手 自动分析模拟结果，并生成结构化的模拟分析报告。

操作步骤

进入模拟回顾：打开目标场景对应的模拟回顾页面。
启动 AI 分析助手：在数据看板中点击【分析助手】，打开 AI 分析助手窗口。

配置分析参数

在分析助手中可进行以下设置：

- 历史记录：查看最近 10 条分析对话，可选择历史记录继续对话；
- 分析类型：
  - 单次模拟分析
  - 多次模拟分析（当前不可选，后续版本支持）
- 深度思考：开启后将进行更深入的分析；
- 附件上传：支持上传 PDF、DOC、XLSX、PPT、TXT 等文件，最多 5 个，总大小不超过 50MB。

说明：分析模型由管理员在 FactVerse 平台统一配置，当前支持 OpenAI 和 DeepSeek。

生成分析报告

在输入框中描述分析需求并点击发送；

或直接选择系统预设问题（如“分析产线效率与产出”“分析产线经济性”）。

查看与编辑报告

AI 分析助手将自动生成一份结构化的模拟分析报告，支持：

- 手动编辑内容；
- 继续与 AI 分析助手对话，对报告进行补充和优化；
- 下载报告用于结果汇报与分析总结。

预览报告

生成报告后，可对报告内容进行在线预览。点击对话窗口中的 文档链接，打开报告预览。支持滚动查看报告内容，可选择【下载报告】或【关闭预览】。

下载报告

点击对话窗口中的 下载报告 按钮；
在弹出的格式选择窗口中选择所需格式；
AI 分析助手将生成并下载对应格式的报告文件。

场景调试与测试

FactVerse Designer 提供调试播放模式，用于验证场景逻辑、检查孪生体行为树的执行情况，并支持模拟数据与日志输出，辅助完成开发调试和流程优化。

调试播放界面

点击“场景编辑器”工具栏中的【调试播放】按钮，可进入 调试播放模式。该模式支持运行场景逻辑、调试行为树、发送模拟数据，并查看实时日志，适用于验证孪生体响应、行为逻辑正确性以及联动效果。

工具栏功能说明

按钮名称	功能描述
属性面板	展示选中孪生体的属性信息，支持修改属性值以验证数据联动。
行为树预览	展示当前选中孪生体的行为树运行状态，支持添加断点。
模拟数据调试	打开模拟数据输入面板，可手动推送数据驱动孪生体行为。
日志台	查看行为树中【产生记录】节点输出的调试信息。
播放速度	设置场景运行速度（如 1x、2x 等）。
播放 / 暂停	启动或暂停场景运行。
单步播放	执行当前行为树的一个节点，便于逐步调试。
继续播放	在断点处暂停后继续执行，直到下一个断点或行为树结束。
重新播放	重置场景状态，从头开始执行。
退出播放	退出调试模式，返回场景编辑状态。

行为树断点调试

您可以在行为树上设置断点，以暂停行为树的运行并查看当前执行状态，有助于定位逻辑错误或条件判断问题。

操作步骤

1. 进入调试模式：在“场景编辑器”中，点击工具栏中的【调试播放】按钮。

2. 打开行为树面板：选中一个孪生体，点击工具栏中的【行为树预览】按钮，查看当前选中孪生体的行为树结构。

节点左下角显示节点执行状态：

节点颜色	说明
蓝色	当前正在执行的节点
灰色	尚未执行的节点
绿色	节点执行成功
红色	节点执行失败

3. 设置断点：点击目标节点右下角，设置断点。

4. 调试行为树

行为树运行时，遇到断点将暂停执行。
您可以点击节点右上角的条件按钮，可打开条件面板查看判断逻辑是否通过（绿色为通过，红色为未通过）。

5. 控制执行流程：使用工具栏中的【单步播放】或【继续播放】控制行为树执行。

6. 退出调试模式：点击工具栏中的退出按钮退出调试运行模式，返回场景编辑界面。

7. 修改问题节点：在场景中选中孪生体，打开其行为树，修改问题节点后再次调试验证。

模拟数据调试

在调试播放模式中，支持直接修改孪生体属性值，以模拟实际运行过程中数据变化对行为树和场景的影响。

观察场景表现、行为树响应是否符合预期。

此功能适用于验证单个属性变化对孪生体行为的影响。

日志输出与问题定位

在行为树中使用【产生记录】节点时，调试模式下“日志台”将实时展示输出内容，帮助开发者了解变量状态、记录事件过程。

典型用途：

打印属性变化；
记录执行路径；
辅助判断条件成立与否。

设置建筑空间场景的 2D 平面图和跳转点

对于建筑空间场景，您可以配置场景底图，并在底图中设置跳转点。配置完成后，用户在 Inspector Command Center 中进入对应空间层级时，可点击【2D 地图】打开该场景的平面图。

如果该场景已设置跳转点，平面图上会显示对应的跳转点图标。用户点击跳转点后，可快速切换到场景中的指定位置，并以预设视角查看周围空间和设备。

设置场景底图

场景底图用于在 Inspector 的【2D 地图】中展示当前空间的平面布局。设置底图后，用户可以通过平面图快速了解楼层、房间或区域的位置关系。

操作步骤

在底图配置区域，点击【选择图片】。

在打开的窗口中选择要上传的底图，并点击【确认】。
点击【编辑底图】，进入底图编辑模式。

进入底图编辑模式后，场景中的孪生体、角色等对象会以半透明方式显示，便于您对照 3D 场景调整底图位置。

根据需要调整底图显示效果：

设置项	说明
底图偏移量	调整底图在场景中的位置。
底图旋转量	调整底图方向，使其与 3D 场景方向一致。
比例尺	调整底图大小，使平面图与 3D 场景比例匹配。
不透明度	调整底图透明度，便于查看底图与场景之间的对齐情况。
播放时隐藏	开启后，底图在场景播放时不会显示。若底图主要用于 Inspector 的【2D 平面】，建议开启该选项。

如需调整底图位置或方向，可在画布中直接拖拽底图。
调整完成后，点击【退出】，退出底图编辑模式。
如需更换底图，可将鼠标移动到底图配置区域，点击【删除图片】，删除当前底图后重新选择图片。

注意：删除后，当前底图及相关设置会被清除。如需继续使用底图，需要重新上传并调整。

保存场景设置。

说明

如果未手动添加底图，Inspector 中的【2D 地图】会使用场景顶视图快照作为基础底图。
在底图编辑模式下，不能放置或编辑其他资源。如需编辑场景对象，请先退出底图编辑模式。
建议使用与建筑空间布局一致的平面图作为底图，并通过位置、方向和比例调整，使底图尽量与 3D 场景对齐。

设置跳转点

跳转点用于在 Inspector 的【2D 地图】中标记可快速查看的位置。用户点击跳转点后，可快速进入该位置对应的 3D 视角，查看周围空间和设备。

操作步骤

在场景编辑器中，点击工具栏中的【定位模式】按钮进入定位编辑模式。
点击【添加跳转点】。

添加后，场景中会显示一个头显视角模型，用于表示用户进入该跳转点后的查看位置和朝向。

设置跳转点的位置和朝向。

选中头显视角模型后，可通过拖拽调整位置，也可以在右侧属性面板中修改【位置】和【旋转(Y)】。

- 【位置】：决定用户点击该跳转点后进入场景的位置。
- 【旋转】：决定用户进入该位置后的初始朝向。

设置视角高度。

在【视角】下拉选项中选择【站姿】或【坐姿】，用于设置用户进入该位置后的视角高度。

预览或快速设置跳转视角。

在【运镜】区域，可以查看当前跳转点对应的视野效果。

- 【使用跳转视角】：将当前编辑视角切换到该跳转点的预览视角，便于检查用户点击跳转点后看到的效果。
- 【使用当前视角】：将当前画面所在的位置和朝向设置为跳转点视角。设置后，头显视角模型会移动到当前视角对应的位置，便于快速设置跳转点。

根据需要继续添加其他跳转点。
点击【退出】，退出定位编辑模式并返回编辑界面。

退出定位编辑模式后，头显视角模型将以半透明状态显示，且不可选中。

保存场景设置。

说明

跳转点会显示在 Inspector的【2D 地图】中。
用户点击跳转点后，会进入该跳转点对应的 3D 预设视角。
建议将跳转点设置在房间入口、主要通道、关键设备附近等需要快速查看的位置。
如果未设置跳转点，用户仍可查看 2D 平面图，但无法通过点位快速跳转到指定视角。