孪生体通用迁移实操教程

孪生体通用迁移实操教程

本方法本地离线项目、云端在线协作项目均适用，核心逻辑为：孪生体属于全局本地资源，统一存储在本地 DTO 目录中，不会随项目工程自动同步到云端；因此无论项目类型，迁移孪生体都遵循「DTO 配置文件 + 原始模型文件」配套迁移的标准流程。

一、前期准备

1. 两台电脑的客户端大版本号保持一致，避免因版本差异导致组件丢失、配置不兼容。

2. 源电脑上完成孪生体制作后，关闭客户端再执行文件复制，防止 DTO 文件被占用导致复制不完整。

3. 提前找到制作该孪生体时使用的原始模型源文件（如 FBX、OSGB、GLB 等），确保贴图、材质等关联资源完整。

二、源电脑：提取迁移文件

步骤 1：定位并复制 DTO 配置文件

1. 右键桌面客户端快捷方式，选择「打开文件所在的位置」，进入CIMProLauncher 根目录。

2. 按层级依次打开文件夹：data → PiCIMOS → Saved → DTO，完整路径为 CIMProLauncher\data\PiCIMOS\Saved\DTO。

3. 该目录存放本地所有已创建的孪生体配置，可通过「文件修改时间」「文件名与孪生体名称对应关系」找到目标孪生体的 DTO 文件，复制到传输文件夹中。

注意：请勿修改 DTO 文件的文件名，否则目标电脑无法识别匹配孪生体资源。

步骤 2：配套复制原始模型文件

将制作孪生体时导入的原始模型源文件完整复制，若模型附带贴图文件夹、材质库、动画资源等，保持模型结构、命名与源电脑完全一致，不可重命名或拆分文件。

三、目标电脑：部署并调用孪生体

步骤 1：放置 DTO 配置文件

在目标电脑上打开相同路径 CIMProLauncher\data\PiCIMOS\Saved\DTO，将源电脑复制的 DTO 文件粘贴到该目录下。

步骤 2：导入对应模型源文件

1. 启动客户端，根据需求新建本地离线项目，或打开目标在线协作项目。

2. 在资源栏切换到「摆放」分类中的本地，点击导入资源，选择传输过来的原始模型文件，完成导入。

步骤 3：调用迁移后的孪生体

在资源栏切换到摆放中的「孪生体」分类即可看到迁移完成的孪生体资源，直接拖拽到场景中即可使用，所有层级结构、交互组件、逻辑绑定、参数配置都会完整保留。