功能说明

创建孪生体模板

在 FactVerse Designer 中，用户可以使用两种方式来创建孪生体模板，以满足不同的需求：

定制化预设模板

虚拟工厂 DLC 内置了一些常见的模板，如工厂内的生成器、传送带、无人车等。用户可以选择这些预设模板并根据具体需求进行修改和编辑。这种方式使得创建孪生体模板变得简单而高效。

示例：定制化预设的暂存区模板

本例中将使用虚拟工厂 DLC 中的暂存区模板，创建一个定制化的暂存区模板，并修改其默认属性值。具体步骤如下：

1. 点击主页中的【打开模板】按钮。

2. 在模板选择窗口中选择“暂存区”模板，点击【打开】按钮。

3. 点击工具栏中的另存按钮 ，打开保存窗口。

4. 在保存窗口中，选择存储目录，指定模板名称，然后点击【确认】完成模板的另存。

5. 在孪生体模板窗格中，选中“存储”结构下的“货物宽度”。在右侧属性区，修改默认值为2。

6. 类似地，修改“货物长度”和“货物高度”的默认值为2。

7. 点击保存按钮 完成模板的保存。

创建全新的模板

用户可以从头开始创建全新的模板，完全自定义以适应特定场景的需求。

示例：创建一个会变色的方块模板

此示例展示如何根据方块的信号值改变方块颜色。

1. 创建方块模板：

a) 点击主页中的【新建模板】，打开模板编辑器。

b) 将工具窗格中的“立方体”拖拽到场景区中，并调整其合适位置。

c) 点击工具栏中的保存按钮 ，保存模板名称为“会变色的方块”。

2. 添加主功能结构：

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

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

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

3. 绑定颜色属性的数据：

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

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

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

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

e) 点击工具栏中的保存按钮 保存模板。

4. 创建监听信号改变颜色的行为树：

a) 在孪生体模板窗格中，点击行为树栏旁的︙，选择新建行为树选项。

b) 保存行为树并命名为“监听信号改变颜色”。

5. 编辑行为树逻辑：

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

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

c) 在选择节点下添加一个顺序节点，并为这个顺序节点设置“比较两个孪生体的属性”的条件。

“比较两个孪生体的属性”的条件设置如下：

• • • • 源属性
        • • 获取属性方式：直接选择属性
          • 获取位置：孪生体的属性
          • 孪生体的属性：选择“会变色的方块”模板->“信号”属性
          • 查找孪生体的方式：自身
      • 对比属性
        • • 获取属性方式：直接选择属性
          • 获取位置：手动输入
          • 手动输入：1
      • 比较方式：等于

d) 在顺序节点下添加一个设置属性节点，并设置这个节点的属性。

“设置属性”节点的属性如下：

• • • • 目标属性
        • • 获取属性方式：直接选择属性
          • 属性来源：孪生体的属性
          • 数值的设置策略：替换原始值
          • 孪生体的属性：选择“会变色的方块”模板->“颜色”属性
          • 指定孪生体
            • 查找孪生体的方式：自身

• • • • 目标属性值
        • • 获取属性方式：直接选择属性
          • 获取位置：手动输入
          • 手动输入：0,0,1,1

设置说明:“顺序节点1”和“设置属性1”节点的运行逻辑决定了，当方块的“信号”属性值为 1 时，方块的颜色变为RGBA(0,0,1,1) 。

e) 添加“顺序节点2”：

i. 复制粘贴“顺序节点1”，节点将自动添加到选择节点下方。

ii. 将其重命名为“顺序节点2”。

iii. 设置对比属性中的手动输入值为“2”。

f) 在“顺序节点2”下方添加“设置属性2”节点：

i. 复制 粘贴“设置属性1”节点，节点将自动添加到“顺序节点1”下方。

ii. 将其重命名为“设置属性2”。

iii. 删除“顺序节点1”和“设置属性2”节点间的连线，重新连接“顺序节点2”和“设置属性2”节点。

iv. 修改“设置属性2”节点的目标属性值中的手动输入值为“0,1,0,1”。

g) 添加“顺序节点3”：

i. 复制粘贴“顺序节点1”，节点将自动添加到选择节点下方。

ii. 将其重命名为“顺序节点3”。

iii. 设置对比属性中的手动输入值为“3”。

h) 在“顺序节点3”下方添加“设置属性3”节点：

i. 复制 粘贴“设置属性1”节点，节点将自动添加到“顺序节点1”下方。

ii. 将其重命名为“设置属性3”。

iii. 删除“顺序节点1”和“设置属性3”节点间的连线，重新连接“顺序节点3”和“设置属性3”节点。

iv. 修改“设置属性3”节点的目标属性值中的手动输入值为“1,0,0,1”。

i) 添加“顺序节点4”：

i. 复制粘贴“顺序节点1”，节点将自动添加到选择节点下方。

ii. 将其重命名为“顺序节点4”。

iii. 设置对比属性中的手动输入值为“4”。

j) 在“顺序节点4”下方添加“设置属性4”节点：

i. 复制 粘贴“设置属性1”节点，节点将自动添加到“顺序节点1”下方。

ii. 将其重命名为“设置属性4”。

iii. 删除“顺序节点1”和“设置属性4”节点间的连线，重新连接“顺序节点4”和“设置属性4”节点。

iv. 修改“设置属性4”节点的目标属性值中的手动输入值为“0,1,1,1”。

下图为完整的行为树结构：

6. 保存行为树：

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

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

7. 保存模板：点击工具栏中的保存按钮保存模板。

8. 点击主页按钮退出模板编辑器，完成模板的编辑。

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

创建孪生体

用户可以使用模板通过单个创建或批量创建方式来管理孪生体。

创建单个孪生体

用户可以使用孪生体模板一次创建单个孪生体。

1. 新建或打开一个已有场景。

2. 在场景编辑器中，点击资源库的孪生体窗格中的添加按钮 ，填写孪生体信息并完成创建。

示例：创建一个原料生成器

此示例展示如何使用 DLC 中的原料生成器模板来创建一个名为“生产2号”的生成器孪生体，并将其添加到场景中。以下是具体的步骤：

1. 点击主页中的【打开场景】按钮，打开场景选择窗口。

2. 浏览场景目录，选择要打开的场景，点击场景并打开场景编辑器。

3. 在场景编辑器中，点击资源库的孪生体窗格中的 按钮，打开新建孪生体窗口。

4. 在新建孪生体窗口中，填写孪生体名称为“生产2号”，选择 DLC 中的“原料生成器”模板，并且设置孪生体的存储位置。

5. 点击【确认】按钮，完成“生产2号”的创建。

6. 在存储目录中，找到新创建的“生产2号”，将其拖拽到场景区中。

通过上述步骤，您已经成功创建了一个名为 “生产2号” 的原料生成器孪生体，并将其添加到了场景中。现在，您可以继续进行其他编辑操作，例如设置孪生体的属性和运行逻辑等，以构建一个完整的数字孪生场景。

批量创建孪生体

用户可以通过导出、填写并导入表格的方式批量创建孪生体。

1. 打开孪生体模板：在主页中，点击【打开模板】按钮以选择并打开您用来批量创建孪生体的孪生体模板。

2. 导出表格：

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

b) 在弹出的窗口中，您可以按需填写表格名称和存储路径，然后点击【保存】。

3. 填写孪生体信息：打开保存的 Excel 表格，填写孪生体信息。每个孪生体的属性内容可根据实际需要决定填写与否，按照表格中的示例格式填写，编辑完成后保存表格。

注意：若要修改已有的孪生体，在表格中必须填写该孪生体的 ID。如果要创建新的孪生体，表格中的孪生体 ID 可为空。

4. 导入表格：

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

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

c) 上传步骤 3 中保存的表格，完成孪生体的批量创建。

路径规划

路径规划在数字孪生场景中约束孪生体的移动轨迹。它通过定义一系列关键点和它们之间的连通关系，形成了可移动范围的有向连通图。用户可以在这个图上指定移动路径，确保孪生体在场景中按照规定的路线移动。路径规划是针对整个场景而言，不同孪生体可以共享一致的导航规则。

主要内容包括：

• • 关键点：在场景中标点形成的连通图的顶点。
  • 连通关系：关键点之间的连通关系，包括是否可以连接以及连接的方向，形成有向连通图。
  • 路径：在连通图上指定一系列的连续顶点，构成一条固定的移动路径。

构建模式

在构建模式下，您可以通过鼠标左键单击场景中任意区域创建关键点，然后移动鼠标，再次点击创建下一个关键点。两个关键点之间会以默认方向自动连接起来。

为提升路径构建效率，您可以在场景左上角设置默认构建参数，包括点位高度和连线方向。创建的关键点将采用这些默认设置。

• • 点位高度：指在构建模式下设置点位时的高度。
  • 连线方向：指在构建模式中，点位与下一个连接点之间的连接方向，可选择正向、反向或双向连接。

随着在场景中构建点位，左侧窗格点位列表中会同步出现对应的点位条目，默认命名规则为「Point+Num」。

创建路径关键点后，可以进行以下操作：

• • 重命名点位或删除点位。
  • 选中点位时，通过右侧属性窗格的坐标输入框可精确调整点位位置数据。
  • 选中两个关键点的连线时，通过点击右侧属性窗格的方向方块可切换两点间的连接方向。

选择模式

在选择模式下，您可以对场景进行拖拽操作以移动整个场景，同时还可以选中关键点并修改其位置。

创建路径的基本流程

1. 1. 在场景编辑界面中，点击工具栏中的路径规划按钮 进入路径规划界面。
   2. 在路径规划界面中，使用构建模式创建点位，点位的创建将基于默认构建高度（0）所在的平面上。
   3. 分别新建的两个点位之间使用默认的方向连接， 即正向从当前的点连向下一个点。
   4. 选择模式下，点击点位和连线可修改其位置、连线方向。

场景的导入和导出

数字孪生场景文件（.digpkg文件）包含了场景中的数字孪生体与其他数字孪生内容，如：元数据、行为树、资源，场景的路径等。用户可在主页选择导入和导出数字孪生场景。

业务数据看板

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

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

1. 将业务数据看板工具拖入场景中。

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

3. 选中业务数据看板，在属性区中，进行字号大小、文字颜色和对齐方式的设置。

4. 选择要显示的内容，如孪生体的属性名称。

5. 设置看板的标题。

6. 点击【+选择孪生体】。

7. 点击【+选择孪生体】后，弹出选择孪生体列表，该列表展示场景内的所有孪生体，您可以按照孪生体名称进行检索。在选择孪生体的列表中，找到要绑定的孪生体，点击选中该孪生体。

选择孪生体后，原【+选择孪生体】按钮的位置变为您选择的孪生体名称。点击该孪生体名称弹出选择孪生体列表，可以重新选择孪生体。

8. 选择孪生体后，孪生体名称下方显示孪生体的属性列表，点击选中要展示的孪生体的属性数据。

9. 点击页面右上角的播放按钮 可查看效果。

调整场景视角

在 FactVerse Designer 中，您可以通过不同的方式来调整场景的视角，以便更好地观察和编辑场景。以下是一些常用的场景视角调整方法：

• • 旋转视角：按住右键可旋转整个视图，鼠标变为放大镜样式，可供用户全方位观察模型。
  • 调整基准面高度：使用 Shift+鼠标左键可快捷调整基准面高度。
  • 空间缩放：滚动滚轮。
  • 拖拽场景：按住滚轮进行拖拽或左键点中场景区进行拖拽。

修改场景渲染环境

场景的渲染环境是指在虚拟场景中为场景设置的光照效果，用于模拟光线在场景中的传播、反射和折射现象。它可以影响物体的外观、光照和阴影效果，增强场景的真实感和逼真度。

在 FactVerse Designer 中，您可以选择系统提供的内置的渲染环境或者自定义制作场景的渲染环境，使虚拟场景更加逼真和具有沉浸感。

要修改场景的渲染环境，您可以按照以下步骤进行操作：

1. 点击设置菜单，在下拉菜单中选择更改渲染环境。这将打开更改渲染环境窗口。

2. 在更改渲染环境窗口中，您可以选择系统内置的渲染环境，当选择无时，则剧本没有特定的环境反射效果。

您也可以通过自定义渲染环境，创建适合场景的环境背景和天空效果，以适应不同场景需求和创作目的。

自定义反射环境步骤如下：

1. 准备六张图片：这些图片应该分别对应于天空盒的前、后、左、右、上和下方向。图片应该是 PNG 格式的，并且遵循英文命名规范（Front、Back、Left、Right、Top、Bottom）。

2. 将这些图片压缩成一个 zip 文件，并将其后缀名改为 .dmcm。

3. 在 DataMesh FactVerse 平台上将这个 .dmcm 文件上传到资源库中。

4. 在 FactVerse Designer中，点击设置菜单，在下拉菜单中选择更改渲染环境，打开更改渲染环境窗口。

5. 在更改渲染环境窗口中，选择自定义标签，点击选择渲染环境。

6. 在选择渲染环境的窗口中，找到已上传的 .dmcm 文件。

7. 选择文件后，点击【确认】按钮完成自定义场景的渲染环境。

播放场景录像

播放场景录像功能允许用户通过对比不同参数配置、布局或元素，或者比较多个场景之间的差异来进行场景间的横向对比。

播放场景录像的流程

1. 录制场景

a) 在FactVerse Designer 中，打开要录制的场景。

b) 点击工具栏中的录制按钮 。

c) 在录制窗口中，填写录制名称、时长并选择存储位置，点击【确认】。

d) 等待录制进度为100%时，点击【确认】完成录制。录制文件包含了场景内容数据与运行数据，仅供播放使用，不可编辑。

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

2. 播放：

a) 在主页上点击【播放录像】按钮。

b) 在打开的窗口中，选择录制文件，然后点击【打开】。

c) 通过播放界面中的工具栏，进行播放或暂停、控制播放进度、调整播放速度以及退出操作。

行为树断点调试

您可以通过设置行为树断点暂停行为树遍历与场景运行，并查看此刻各行为树节点的执行状态与条件判断详情，以检查和调试行为树的逻辑。

1. 进入调试模式

a) 点击工具栏中的断点调试按钮 。

b) 进入行为树调试运行模式，工具栏中会显示四个播放控制按钮：

• • • • 单步播放：逐步执行每一个行为树节点。
      • 继续播放：继续执行行为树，直到下一个断点或结束。
      • 重新播放：重新播放场景。
      • 退出播放：退出调试运行模式，返回正常模式。

2. 添加行为树断点

a) 选中一个孪生体：点击孪生体对象，使其处于选中状态。

b) 打开行为树面板：点击工具栏中的行为树面板按钮 。

c) 添加断点：在行为树面板中，选择需要调试的节点，在节点的右上角点击即可添加断点（标记为红点）。

3. 调试行为树

a) 行为树运行时，遇到断点将暂停执行，您可以点击节点右上角的条件按钮 打开该节点的条件面板，查看当前节点的执行状态和条件判断详情。条件判断通过为绿色、红色代表条件未通过。

b) 使用工具栏中的控制按钮进行单步执行或继续播放，以逐步检查行为树的逻辑和执行情况。

4. 退出调试模式

a) 点击工具栏中的退出播放按钮 退出调试运行模式，返回场景编辑界面。

5. 修改问题节点

a) 在场景编辑器中，选择孪生体，打开其行为树，找到问题节点进行修改。

b) 进行相应修改后，重新运行调试以确保问题得到解决。