首页 / 博客 / 博客详情

【产品攻略】WDP 4.1 数字孪生 PaaS 平台云端版用户手册???

社区小助手 关注 20

本手册主要基于【WDP数字孪生PaaS平台云端版】功能编写。客户端版的功能和操作流程与云端版基本相同，部分不同之处将在具体章节中注明，请留意手册中带有  标志的部分。

目  录

第一部分 版本更新发布说明

第二部分 如何使用本手册

  • 快速入门

（通过几个简单完整的范例，帮助用户快速了解WDP数字孪生PaaS平台的基本功能和使用流程）

  • 编辑和开发

（对案例编辑器各个模块的界面和功能进行详细的介绍，帮助用户全面掌握数字孪生案例的编辑和开发技巧）

  • 管理和设置

（对数字孪生应用控制管理平台的各项功能进行介绍，并帮助用户理解如何对系统进行设置）

第三部分 SuperAPI参考手册

（帮助用户理解和使用SuperAPI创建高级场景交互）

第四部分 常见问题

第一部分 版本更新发布说明

?4.1.0（2021.12.01）?

新增功能

  1. 重磅推出纯云渲染、无客户端的云端版

  2. 全新的非线性案例编辑流程

  3. 支持三维设计模型浏览审查

  4. 新增完整的预制案例模板，开箱即用

 

改进修复

  1. 新增成都L3城市场景底板

  2. 新增山谷电站基础场景底板

  3. 新增150个数字资产模型

  4. 新版本升级包增量更新，减小更新包的大小，优化更新过程

 

4.0.0（2021.10.14）

改进修复

  1. 平台易用性改进：基础场景编辑器交互体验升级

  2. FBX、RVT格式转换优化：解决一批文件转换失败、转换效率和材质丢失的问题

  3. L3场景底板优化和功能化：减少场景底板大小，修正API的问题

  4. WDP本机安装和升级优化：安装包大小减少，升级机制更新

  5. 用户token权限过期：重新登录过于频繁机制优化

  6. 修复用户下载场景进度50%或99%暂停问题

  7. 其他一些稳定性的修复

 

4.0 Beta（2021.9.17）

新增功能

1.数字孪生应用控制管理平台

全新的数字孪生应用控制管理平台是创建、管理、发布数字孪生应用和资产的一站式入口， 它为用户提供了场景底板选择、案例项目管理、用户权限控制、多用户流程协作等一系列功能与服务。在应用控制管理平台上，用户还可以进行系统硬件检测和参数配置，以达到平台使用效率的最优化。

  • 底板选择

可支持在数字孪生底板库中，灵活选取底板范围，并在二维地图引擎中根据需求随意裁剪。

  • 项目管理

提供以案例为管理单元的一站式流程控制管理器，降低用户管理成本，提升开发效率。

  • 多用户流程

支持用户开设子账号，并对子账号进行集中管理，并对用户操作流程进行监控和优化。

  • 权限控制

基于统一的身份认证系统，对登陆用户进行不同级别的功能模块权限管理与控制。

 

2.数字孪生基础场景编辑器

全新的数字孪生基础场景编辑器是数字孪生场景创作的主要工具之一，为用户提供所见即所得的三维场景搭建功能。编辑器采用B/S架构，能够对基于云渲染生成后的场景进行数字底板和数字模型的编辑操作。用户既可以对多个模型在底板上的位置进行任意地摆放操作，也可以将操作的结果根据用户账号进行修改后的持久化保存。

 

3.数字孪生资产库

全新的数字孪生资产库是一个虚拟仓库，用于存放数字孪生应用开发所需要的模型资产。用户可以上传三维模型到资产库中，并对其进行管理。上传时，用户的模型会自动转换成数字孪生运行引擎可以使用的资产。

  • 行业底板

平台开放城市、园区、交通、地产、水务、港口、能源、轨道和工厂的免费社区版数字孪生三维底板。

  • 官方城市底板

提供L2级别的全国重点城市数字孪生底板，作为数字孪生应用开发的基底。

  • 官方模型资产

平台提供L3级别的建模中常用的模型，作为数字模型资产库的重要组成部分。

 

第二部分、如何使用本手册

一

--快速入门--

1、开始使用：

用户有两种方式使用WDP数字孪生PaaS平台：

1）云端版

使用浏览器访问https://www.51aes.com/site/open-platform，注册账号后登录即可使用。

2）客户端版

访问WDP官网下载客户端安装包后，根据安装指引安装并使用。

 

下载与安装：

请前往?：WDP官网-产品下载页

 

安装前的注意事项：

  1. （重要）关闭所有防火墙、杀毒软件。关闭Windows系统防火墙、Defender、360安全卫士、360杀毒、金山毒霸.....各种防火墙和杀毒软件，否则安装和运行可能会被阻止，影响使用。

  2. 关闭51Cloud。在安装51WDP时，需要关闭51Cloud，否则会导致安装完成后，不能正常使用51WDP。

  3. 保证系统盘有足够的空间（大于20G）。由于在安装的过程中需要释放一些临时文件在系统盘，所以需要系统盘留出足够的空间。

  4. 保证端口号不被占用。51WDP会使用到以下端口号，在安装和使用之前要保证这些端口不被占用：3008，6480，7009，8888，8891，8892，8889，8893，9101，92xx，93xx，94xx，10751，10851，19200，19300，27050。

 

2、创作与发布快速入门：

 

1）登录WDP数字孪生PaaS平台

  1. 您可以直接通过浏览器访问【云端版】登录页面paas.51aes.com。

用户也可以在安装客户端版后启动51WDP，通过51Browser或浏览器访问“http://127.0.0.1:8888/”地址进入到51WDP首页。

  1. 输入您的账户名和密码后登录系统。首次登陆时，系统将自动创建一个全新的案例并打开案例编辑器。

 

2）为案例添加城市底板场景

一个数字孪生案例由 场景 和 面板 两大部分所构成。

场景，是案例的基础载体，基于AES（All Element Scene，全要素场景）技术，可以展现建筑、道路、车辆、河流、植物等众多元素。

面板，是围绕着全要素场景，通过可视化数据层的搭建和输出，满足各类细分行业解决方案的需求。

 

首先，我们要添加一个底板场景。如果想创作一个智慧城市相关的数字孪生应用，那么平台提供的城市场景就是一个很好的选择。✅

  1. 在左侧模块导航栏中点击场景，进入场景模块页面。在场景资源列表中点击城市场景，您可以看到系统默认提供广州L2和广州L3两个底板场景供选择。（根据您的订阅版本，您可以解锁更多城市场景，请参见编辑和开发>场景>浏览场景资产列表>解锁可使用的城市场景。）

  2. 鼠标左键点击广州L3卡片并拖拽到右侧场景预览区，系统弹出选择底板区域窗口。在“选择底板区域”窗口的中间部分，您可以看到广州的平面地图。地图上的主要区域被浅蓝色区块所覆盖，这些浅蓝色区块代表了可供用户选择的底板区域。

  3. 查看地图时，您可以使用鼠标左键拖动来移动地图，也可以使用鼠标右键或滚轮来缩放地图。选择区域时，使用鼠标左键单击地图放置第一个点，移动鼠标，再次左键单击放置第二个点。此时地图上将出现一个矩形的虚线框，虚线框所经过的区块都会被选中高亮。

 

小技巧：如果选择区域时发现选中了不需要的区块，可以在放置完第二点后，点击虚线框右下角的X图标将选区删除，然后重新进行选择。

 

  1. 点击确认按钮执行底板裁切操作，等待场景启动后即可预览场景的三维效果。

  1. 点击保存按钮保存当前案例的编辑结果。

 

3）底板模型编辑

您可以对底板场景上的模型进行编辑，比如将不需要的底板物体隐藏。

  1. 在左侧模块导航栏中点击模型，进入模型模块页面。您可以通过以下方式在三维视图中进行浏览：

  1. 浏览场景到下图所示区域，在“选择”工具处于激活的状态下，使用鼠标左键点击底板物体，该底板物体会被高亮，表示它处于被选中的状态。

 

 

 

  1. 底板物体被选中时，工具栏上的  和  工具亮起，表示可以对底板物体进行“拍平”和“隐藏”操作。保持底板物体被选中，点击  按钮观察三维视图，您可以看到选中的底板物体被隐藏了。

  2. 查看界面右下方的“底板编辑”面板，您可以看到列表中增加了一条底板物体被隐藏的记录。如果有需要，您可以点击该条目右方的  按钮撤销此次编辑，将被隐藏的底板物体恢复到初始状态。

 

4）将数字资产放置到场景中

现在，我们将添加一个新的模型数字资产到场景中，以替换刚才被隐藏的底板物体。

  1. 在左侧的模型资产库中，您可以浏览官方提供的五个大类的数字模型资产。

  2. 在“资产分类”中点击展开“建筑”分类，并选择“其他”。找到“其他建筑012“的卡片，这是一个体育场的模型，将它拖拽到刚才我们隐藏了底板物体的位置。释放鼠标按键后，您可以看到模型资产被放置到了场景中。

对于使用客户端版的用户，模型资产库的资产需要经过加载才可以拖入场景中。在资产卡片列表区域，将鼠标悬停在模型资产卡片上，点击“加载”按钮开始加载。当加载完成后，资产卡片的右上角会出现打勾标记，表示该资产此时已经可以被使用了。

 

  1. 当数字模型资产被放置到场景中后，您可以使用变换工具对模型的位置、朝向和大小进行调整。点击工具栏上的  按钮激活移动工具，在新添加的模型上单击鼠标左键，您可以看到模型的底部中心出现了移动控件。点击移动控件的轴向箭头并拖动，可以交互地移动模型的位置。

  2. 点击工具栏上的  按钮激活旋转工具，您可以看到移动控件被切换成了旋转控件。点击旋转控件的旋转轴并拖动，可以交互地调整模型的朝向角度。

  3. 点击工具栏上的  按钮激活缩放工具，旋转控件被切换成了缩放控件。在右侧的“属性设置”面板中，您可以看到缩放参数设置旁的  按钮，表示默认为等比缩放模式。点击缩放控件的任何一个轴向并拖动，就可以同时在三个轴向上进行缩放。

小技巧：如果需要单独在某个轴向上缩放，可以点击一下  按钮将其变为  非等比模式。这时候再点击缩放控件的某一个轴向，就可以单独在这个轴上对物体进行缩放了。

  1. 在属性设置面板中，您还可以点击物体名称右侧的输入框，修改该物体的名称。

  2. 如果您需要更精细地对模型物体进行位置、朝向和大小的调整，可以通过属性设置来完成。点击“缩放”右方的“设置步长”按钮，您可以看到缩放参数的默认步长为0.01。在步长输入框中输入想要的步长值，比如0.1，点击坐标X输入框右侧的上下箭头，就可以按照每次0.1幅度调整物体的大小。同样，如果是在等比例缩放模式下，调整一个轴向的缩放值时其他轴向也会一起联动。

 

5）添加数据面板

接下来，我们就要开始制作数据面板了。

  1. 在左侧模块导航栏中点击面板，进入面板模块页面。点击选择模板，展开预制面板列表，可以看到平台提供了针对不同垂直行业的面板预设，都是从实际项目中总结提炼而来。

 

 

  1. 选择智慧城市下的“智慧城建”预制面板卡片，将它拖拽进中间的编辑窗口。您可以看到预制面板已经包含了与城市建设相关的组件元素，并经过了排版和视觉效果的设计。在POC案例中使用预制面板，可以极大地节省面板制作的时间。

  2. 根据实际项目需求，编辑面板数据。点击右上页面管理，切换页面，对各个页面的面板进行编辑（请参见编辑和开发>面板）

  3. 添加一个icon，作为开启场景特效效果的开关。

 

6）制作场景特效

现在我们的面板还只是静态的，下一步我们将添加一个场景交互特效，增加数字孪生应用的吸引力。

  1. 选择面板右下角的菱形图标，我们将把它作为交互特效的触发者。在右侧的配置面板中修改它的名称为“跳转”，可以方便后续在蓝图编辑器中快速找到它。

 

 

  1. 点击界面左上角的蓝图按钮，切换到蓝图编辑器界面。

  2. 在左侧的元素节点列表中找到我们刚刚重命名的图片，将它拖入蓝图编辑窗口中。我们需要制作的场景特效是，当鼠标点击菱形按钮时，三维场景中体育场的位置会出现一个箭头特效，同时镜头会聚焦到体育场，这需要由两个API事件来完成。

  3. 从逻辑节点列表中，拖拽两次“SuperAPI标准事件”节点到蓝图窗口中。选中第一个“SuperAPI标准事件”节点，在右侧“SuperAPI设置”面板的“场景事件”下拉列表中选择“添加场景特效”。选中另一个“SuperAPI标准事件”节点，在“场景事件”中选择“聚焦至覆盖物”。

 

 

  1. 接下来我们要将三个节点连接起来。点击“跳转”图标的“元素点击时”输出端连接到“添加场景特效”节点的输入端，再将“添加场景特效”节点的输出端连接到“聚焦至覆盖物”节点的输入端。

  2. 节点连接关系已完成，下一步就是具体设置两个API事件了。设置API事件，我们需要借助API联调功能一起使用。点击界面右上部的“开启联调”按钮，打开API联调窗口。

 

  1. 在左侧的API列表中，展开“取点工具”，点击“开启取点工具”，您可以看到取点工具的代码已经被自动添加到右上方的窗口中。点击顶部的  按钮，激活取点工具，鼠标移动到三维视图中我们刚才替换的体育场建筑的位置。点击体育场的中心，此时可以看到右下方的Logs窗口中会显示返回信息，我们需要复制“coord”右侧的XY坐标值，作为特效覆盖物坐标位置。

  2. 在左侧API列表中展开“场景特效”，点击“添加特效”，代码窗口显示场景特效的代码。将刚才复制的XY坐标值替换“coord”右侧的初始代码值，点击  按钮，您将可以看到在体育场的位置出现了动态的箭头特效。在代码中，我们可以进一步替换“特效标题”文字为“体育场馆”，替换“特效副标题”文字为“建设中”。重新运行可以看到场景中的特效文字也被更新了。

  3. API联调完成后，复制代码中{ }中间的部分，将它粘贴到蓝图中的“添加场景特效”节点。点击  按钮关闭联调。

  4. 在“添加场景特效”节点的代码中，复制“id”右侧的“effect_id_1”，然后选择“聚焦至覆盖物”节点，将复制的内容粘贴到“id”右侧，替换默认的“poi_id”。第二行“covering_type”指的是覆盖物类型，默认是“poi”，而在本例中，我们需要覆盖的是场景特效，所以我们要将它改成“scene_effect”。

    关于更多SuperAPI事件节点的参数描述，可以参考SuperAPI for PaaS文档（https://bbs.51aes.com/blog/1461593996822499330.html）。

  5. 点击顶部导航栏的保存按钮保存我们的修改。点击“预览>场景+面板”可以预览我们刚才完成的场景交互特效。

 

7）配置数据图表

对于面板上的数据图表，我们可以很方便地进行修改配置。

  1. 回到画布编辑界面，点击“设备在线统计”下方的折线图表。在右侧设置面板中，切换到“数据”。点击“静态数据”旁的“配置”按钮，在弹出的下拉菜单中选择Table，这样就可以用表格的方式轻松地编辑数据。修改第7行Y轴的数据值为10，可以看到图表折线中的对应点立即作出了更新。

  2. 除了静态数据，数据源类型还支持API动态接入，详细使用方法可以查看SuperGUI参考手册的相关章节。 

 

8）案例发布和交付

现在，我们来到了整个数字孪生应用创作的最后一步——发布，将您的创作成果交付给您的客户。

  1. 在本教程中，因为是要将场景和面板一起打包，所以您需要点击顶部导航栏中的“发布”按钮，并选择“场景+面板”。

  2. 在弹出的“发布设置”对话框中，填写交付对象的WDP账号。在本教程中，我们会把案例发布到当前账户中，所以您可以直接填写当前的账号。案例名称一栏可以填写您想要的名称，然后点击“确认”。

 

 

  1. 点击顶部导航栏中“返回”按钮返回控制平台的“案例发布”按钮进入案例发布模块页面，您可以看到刚才发布完成的应用案例。您可以点击案例卡片直接在发布页面运行数字孪生应用，也可以点击卡片右下角的   按钮复制案例链接，通过浏览器或其他方式运行。

 

 

二

--编辑和开发--

1、基础功能：

1）案例的基本概念

案例是一个容器，每个案例可以包含一个用户创建的场景，同时也可以包含多个为该场景创作的面板。删除案例时，该案例中的场景不会被删除，用户依然可以在”我的案例“中找到；

 

2）案例编辑界面概览

案例编辑的主界面由以下部分组成：

  1. 基础导航栏

  2. 基础菜单

  3. 模块导航栏

  4. 编辑区域

 

 

3）基础导航栏

 

查看和修改当前案例名称

用户可以在基础导航栏中查看并修改当前案例的名称。

  1. 打开案例编辑器。

  2. 在编辑器界面顶部的基础导航栏左侧，查看当前打开的案例名称。

  3. 在案例名称上点击鼠标左键，出现输入框和光标，输入新的案例名称。

  4. 按回车键或鼠标左键点击基础导航栏其他区域确认修改。

 

查看当前面板

用户可以在基础导航栏中查看当前面板。在编辑案例时，用户只能够选择一个面板作为当前面板进行预览和编辑。

  1. 打开案例编辑器。

  2. 在编辑器界面顶部的基础导航栏左侧，案例名称旁查看当前面板的名称。

 

新建面板

用户可以在基础导航栏提供的面板管理弹窗内为当前案例创建新的面板。

  1. 打开案例编辑器。

  2. 点击基础导航栏上的面板管理按钮，弹出面板管理弹窗。

  3. 在面板管理弹窗中，点击新建面板按钮。

  4. 在弹出的新建面板对话框中，输入想要的面板名称。面板分辨率默认为1920x1080，用户可以手动修改。

  5. 点击确认按钮创建新的面板。用户可以在面板管理弹窗中看到新创建的面板。

 

切换当前面板

用户可以在基础导航栏提供的面板管理弹窗内切换当前面板。

  1. 打开案例编辑器。

  2. 点击基础导航栏上的面板管理按钮，弹出面板管理弹窗。

  3. 在面板管理弹窗内，点击想要预览和编辑的面板卡片。

  4. 在确认弹窗中点击确认按钮执行面板切换，点击取消按钮则取消切换操作。

  5. 如用户点击确认，系统将切换当前面板为选择的面板并自动进入面板编辑模块。

 

4）面板管理功能

用户可以在基础导航栏提供的面板管理弹窗内对当前案例所挂载的面板进行公开、共享和删除操作。

 

保存案例

用户可以使用保存按钮将对案例的编辑操作进行持久化保存，保存的内容包括对场景和面板的修改内容。

  1. 打开案例编辑器。

  2. 点击基础导航栏上的保存按钮，系统将显示正在保存，保存过程中请不要关闭案例编辑窗口。

  3. 保存完毕后，系统将显示保存成功的提示。

 

使用自动保存

用户可以打开自动保存功能以防止编辑结果意外丢失。

  1. 打开案例编辑器。

  2. 点击基础导航栏上的自动保存开关，开关置于左侧且高亮为自动保存功能打开，系统会每隔5分钟自动保存当前案例。将开关置于左侧则可以关闭自动保存功能。

  3. 当自动保存功能打开时，每次自动保存成功后，系统将显示保存成功的提示。

 

预览案例

用户可以预览当前案例的场景效果，或者预览当前案例场景和面板共同交互的完整效果。

  1. 打开案例编辑器。

  2. 点击基础导航栏上的预览按钮，弹出下拉菜单。

  3. 用户在下拉菜单中选择仅场景，可以预览场景的三维效果；选择场景+面板，则可以预览场景和面板共同交互的完整效果。

 

发布案例

当案例编辑完成后，用户可以发布案例进行交付。发布案例支持仅发布场景，也支持将场景和面板一起打包发布。

  1. 打开案例编辑器。

  2. 点击基础导航栏上的发布按钮，弹出下拉菜单。

  3. 用户在下拉菜单选择仅场景，可以只将场景进行发布；选择场景+面板，则可以将场景和面板一起打包发布。当场景和面板一起发布时，请确认当前面板已切换到想要发布的面板名称。

  4. 在弹出的发布设置对话框中，输入交付对象的WDP账号和发布案例的名称。

  5. 点击确认按钮进行发布，点击取消按钮则取消此次发布。发布的案例可以在管理平台的案例发布页面中查看运行。

 

退出案例编辑

案例编辑完成后，用户可以退出案例编辑，回到管理平台。

  1. 点击基础导航栏上的退出按钮。

  2. 在弹出的确认退出对话框中，用户可以点击保存退出按钮将当前的案例编辑结果保存后退出；也可以点击退出按钮放弃未保存的案例编辑结果直接退出。

5）基础菜单

6）模块导航栏

包括模板、场景、模型、面板、导入、帮助

 

2、模板

1）模板模块界面概览

模板模块的编辑界面由以下部分组成：

  1. 模板模块导航栏

  2. 模板资产列表

  3. 案例预览窗口

 

2）浏览模板

官方模板

官方模板是由51WORLD官方提供的全套案例模板，是案例制作的参照模板，包括场景底板、模型资产、数据面板和应用交互。官方模板提炼于51WORLD在多个行业垂直领域的真实业务需求，是开发者进行业务应用开发的参照。

共享模板

对于企业版客户，在同一企业下有多个用户账号。多个用户可以通过共享模板进行协作。

 

3）使用模板

用户可以将模板应用到当前案例，作为数字孪生应用的创作起点。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击模板。

  3. 在左侧的模板资产列表中，鼠标左键点击想要的模板卡片拖拽到右侧案例预览窗口。

  4. 释放鼠标，即可在右侧预览窗口中查看该模板所包含的场景和面板的整体交互效果。

  5. 点击保存按钮保存当前案例的编辑结果。

 

4）使用模板进行替换

对于已经包含场景和面板的案例，用户也可以使用模板对整体案例进行替换。请注意，使用模板替换整个案例将会覆盖已有的场景和面板，当前案例的所有面板和未保存的场景会丢失，建议谨慎操作。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击模板。

  3. 在左侧的模板资产列表中，鼠标左键点击想要的模板卡片拖拽到右侧案例预览窗口。

  4. 释放鼠标，系统弹出确认替换的对话框。

  5. 点击确认按钮确认替换当前案例，点击取消按钮则取消此次替换操作。

  1. 点击保存按钮保存当前案例的编辑结果。

 

3、场景

1）场景模块界面概览

场景模块的编辑界面由以下部分组成：

  1. 场景模块导航栏

  2. 场景资产列表

  3. 场景预览窗口

  4. 场景编辑工具架

  5. 场景大纲列表

  6. 属性设置面板

  7. 底板编辑列表

 

 

2）浏览场景资产列表

场景模块提供的底板场景选择功能，使用户可以在底板场景库中灵活地选择想要的场景，极大地降低了场景创作的门槛。

场景模块提供的底板场景主要分为基础场景、城市场景和行业场景三大类：

基础场景

基础场景库为用户提供小体量的场景底板，适用于BIM应用和园区等小规模场景的搭建。

城市场景

城市场景库覆盖全国主要城市的三维数字孪生底板，并支持在二维地图引擎中根据用户需求随意裁切想要的区域。城市场景可以在场景编辑器中进一步修改，支持底板编辑、添加模型资产、模型资产摆放和BIM模型查看。

L2级别场景

L3级别场景

行业场景

行业场景库能够基本覆盖全行业应用（城市、园区、交通、地产、水务等），真正做到开箱即用。行业场景暂不支持再编辑，但可作为用户学习数字孪生应用制作，进行数字孪生应用demo演示的理想素材。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击场景。

  3. 点击场景资产列表中的分类查看对应的可选场景。

  4. 在搜索框中输入关键词，搜索想要的场景。

 

解锁可使用的城市场景

根据用户的权益，用户可以解锁城市。

对于没有在初始状态没有选择套餐城市的用户，可以在“解锁城市场景”重新选择

  1. 点击“解锁城市场景”。

  2. 选择您需要的城市。

  3. 确定后是您可以获取的尝试场景。提示：一旦确定后开通场景后，将消耗用户权益无法修改，请谨慎操作。

  4. 在创建场景时，可以在列表中选择的场景，将会展示对应您选择的城市。

3）为案例添加场景

用户可以将想要的底板场景添加到当前案例中。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击场景。

  3. 点击场景资产列表中的分类找到想要的底板场景。

  4. 鼠标左键点击想要的场景卡片拖拽到右侧场景预览窗口。

  5. 释放鼠标，等待场景启动后即可预览场景的三维效果。

 

对于使用云+边本地版的用户，基础场景和行业场景需要加载到本地后才能直接使用。将鼠标悬停在场景卡片上，点击“加载”按钮开始加载，卡片显示加载进度。加载完成后，模型卡片的右下角会出现打勾标记，模型就可以直接使用了。

 

选择城市底板区域

当添加城市场景时，用户可以使用底板区域选择工具进行底板裁切。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击场景。

  3. 鼠标左键点击想要的城市场景卡片拖拽到右侧场景预览区。系统弹出的选择底板区域窗口中，其中浅蓝色瓦片覆盖的区域为可选择的底板范围。

  4. 单击底板放置第一个定位点，移动鼠标后再次单击地图放置第二个定位点。两个定位点形成的方框所经过的瓦片都会被选中，变为深蓝色高亮状态。如需修改框选范围，可点击删除图标按钮删除选取，重新放置定位点。

  5. 点击确认按钮执行底板裁切操作，等待场景启动后即可预览场景的三维效果。

  6. 点击保存按钮保存当前案例的编辑结果。

 

4）替换当前场景

对于已经包含场景的案例，用户也可以选择新的场景进行替换。请注意，替换操作将会覆盖案例当前的场景，未保存的场景编辑可能会丢失，建议谨慎操作。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击场景。

  3. 在左侧的场景资产列表中，鼠标左键点击想要的场景卡片拖拽到右侧场景预览窗口。

  4. 释放鼠标，系统弹出确认替换的对话框。

  5. 点击确认按钮确认替换当前场景，点击取消按钮则取消此次替换操作。

  6. 点击保存按钮保存当前案例的编辑结果。

 

5）管理我的场景

用户创建过的场景，只要进行了保存，就会显示在场景模块的我的场景列表中。用户可以使用此功能实现以下两个流程：

  1. 场景的备份和复用。如果用户已经替换了新的场景，但在案例编辑中又想恢复为之前的场景时，可以在我的场景列表中找到之前的场景再次替换。

  2. 跨案例场景复用。用户可以新建一个案例，然后从我的场景列表中选择保存过的场景添加到新案例中。

 

4、模型

1）模型模块界面概览

模型模块的编辑界面由以下部分组成：

  1. 模型模块导航栏

  2. 模型资产列表

  3. 场景三维视图

  4. 场景编辑工具架

  5. 场景大纲列表

  6. 属性设置面板

  7. 底板编辑列表

 


 

2）模型模块导航栏

3）浏览模型资产

用户可以在模型资产列表中浏览数字孪生资产库。

模型资产分为5个大类：

建筑

分为高层建筑、多层建筑、平房/别墅和其他。

交通工具

分为小客车(小汽车)、大客车(公交车)、货车(卡车)和其他。

人物

室外

分为交通标识、景观和其他。

植物

分为乔木、灌木和草本。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击模型。

  3. 点击模型资产列表中的分类查看对应的可选模型。

  4. 在搜索框中输入关键词，可以在每个分类中快速筛选出名称中包含该关键词的模型。

 

4）为场景添加模型

用户可以将数字孪生资产库中的模型添加到当前场景中进行摆放。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击模型。

  3. 点击模型资产列表中的分类找到想要添加的模型。

  4. （客户端版本）数字资产库中的模型需要加载到本地后才能直接使用。将鼠标悬停在模型卡片上，点击“加载”按钮开始加载，卡片显示加载进度。加载完成后，模型卡片的右下角会出现打勾标记，模型就可以直接使用了。点击模型卡片上方的筛选菜单可以快速筛选出已加载完成的模型。

  5. 鼠标左键点击想要的模型卡片，拖拽到三维场景视图中想要摆放的位置。

  6. 释放鼠标，可以看到所选的模型就被放置到场景中了。

5）在三维视图中进行摄像机交互

用户可以使用以下方式在三维视图中进行摄像机交互：

6）使用场景大纲列表

用户可以使用场景大纲列表管理添加到场景中的数字资产模型。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击模型。

  3. 在模型模块界面右侧展开场景大纲列表。

  4. 如果场景中还没有数字资产模型，请添加一个数字资产模型，参见为场景添加模型。

  5. 鼠标左键单击场景大纲列表中的条目可以选中对应的模型。

  6. 鼠标左键双击条目可以在三维视图中聚焦对应的模型。

  7. 点击条目右侧的眼睛图标可以切换数字资产模型在场景中的可见性。

场景大纲列表的主要功能点说明：

7）使用场景编辑工具架

场景中的物体分两种，一种是用户添加的数字资产模型，另一种是场景底板自带的底板物体。用户可以使用场景编辑工具架中的工具对数字资产模型和底板物体进行编辑。工具架提供的工具分为两类：

交互操作工具

包括选择、移动、旋转和缩放。使用此类工具需要先激活工具，然后选中数字资产模型或底板物体进行交互式地操作。 交互操作工具被激活后，会显示变换控件。变换控件由红绿蓝三个部分组成：红色为X轴，绿色为Y轴，蓝色为Z轴。

操作执行工具

包括落地、复制、拍平、隐藏和删除。使用此类工具需要先选中数字资产模型或底板物体，然后点击工具按钮执行一次操作。

并不是所有编辑工具对于数字资产模型和底板物体都适用，各工具的适用范围如下表：

 

选择工具

单个选择场景中的数字资产模型或底板物体。

  1. 鼠标左键点击工具架上的选择工具按钮，使用摄像机交互快捷键在三维视图中调整视角。在想要选择的模型或底板物体上单击鼠标左键，该物体会被选中并高亮，同时摄像机会推近聚焦选中的物体。

  2. 物体被选中后，可以鼠标左键点击工具栏中其他工具切换使用。

  3. 再次点击选择工具按钮可以取消选中物体。

 

移动工具

在三维场景视图中交互式地移动数字资产模型，对底板物体不适用。

  1. 鼠标左键点击工具架上的移动工具按钮，选择想要移动的模型，物体轴心处会出现移动控件。移动控件由红绿蓝三个箭头组成，这些箭头分别指向场景中每个轴的正方向。

  2. 单轴移动：当鼠标光标移动到其中一个箭头上时，箭头变为黄色，点击鼠标左键拖动箭头可以沿着相应的轴移动模型。

  3. 双轴移动（平面移动）：每两条轴可以构成一个平面，匹配轴心处的三个方形(XY, XZ, YZ)。将鼠标移动到其中一个方形上，该方形变为黄色，点击鼠标左键拖动方形可以沿着相应的平面移动模型。

  4. 三轴移动（自由移动）：在三个轴的相交处有一个白色的小球体。将鼠标移动到该球体上时，它的颜色变为黄色。通过拖拽中心球体，可以在空间中自由移动模型，从而可能改变模型三个轴的位置值。

  5. 如果需要更加精确地移动模型，可以在选中模型后，查看并编辑右侧属性面板中位置属性，直接在属性框中输入精确数值来调整选中的模型。

 

旋转工具

在三维场景视图中交互式地旋转数字资产模型，对底板物体不适用。

  1. 鼠标左键点击工具架上的旋转工具按钮，选择想要旋转的模型上，物体轴心处会出现旋转控件。旋转控件由红绿蓝三个弧线组成，每个弧线与一个轴相关联。

  2. 当鼠标光标移动到其中一个弧线上时，该弧线变为黄色。点击鼠标左键拖动弧线可以绕着相应的轴旋转模型。使用旋转控件时，弧线所在平面与旋转轴垂直。例如，拖动XY平面上的弧线实际上将绕Z轴旋转模型。

  3. 如果需要更加精确地旋转模型，可以在选中模型后，查看并编辑右侧属性面板中旋转属性，直接在属性框中输入精确数值来调整选中的模型。

 

缩放工具

在三维场景视图中交互式地缩放数字资产模型，对底板物体不适用。

  1. 鼠标左键点击工具架上的缩放工具按钮，选择想要想要缩放的模型，物体轴心处会出现缩放控件。缩放控件由红绿蓝三个尾部是立方体的手柄组成，每个手柄与一个轴相关联。

  2. 单轴缩放：通过其中一个手柄拖拽控件时，仅可以沿相关轴缩放选中的模型。

  3. 双轴缩放（平面缩放）：每两条轴可以构成一个平面。拖动方形控件可以沿着所在平面缩放模型。

  4. 三轴缩放（等比例缩放）：三个轴相交处有一个白色立方体，拖动中心白色立方体可以按比例缩放模型。

  5. 如果需要更加精确地缩放模型，可以在选中模型后，查看并编辑右侧属性面板中缩放属性，直接在属性框中输入精确数值来调整选中的模型。

  6. 在属性设置面板中，点击缩放属性旁的锁定缩放按钮可以激活或关闭等比例缩放功能。等比例缩放功能被激活后，单独修改任意轴向的缩放值时，其他轴向的缩放值也会按照相同比例变动。

 

落地工具

将选中的数字资产物体垂直降落，物体底面中心点到地形表面，对底板物体不适用。

  1. 鼠标左键点击工具架上的选择工具按钮，选中想要落地的数字资产模型。

  2. 点击工具架上的落地工具按钮，此时被选中模型底面中心点将被垂直移动至地形表面。

 

复制工具

对选中的数字资产模型在场景中增加一个模型实例，对底板物体不适用。

  1. 鼠标左键点击工具架上的选择工具按钮，选中想要复制的数字资产模型。

  2. 点击工具架上的复制工具按钮，此时被复制出的新模型实例将出现在原模型旁边。

 

拍平工具

将选中的底板物体原顶面贴图压缩至拍平面，对数字资产模型不适用。

  1. 鼠标左键点击工具架上的选择工具按钮，选中想要拍平的底板物体。

  2. 点击工具架上的拍平工具按钮，此时选中的底板物体将被拍平。拍平后，底板上显示物体顶部正投影影像。

 

隐藏工具

使选中的数字资产模型或底板物体不可见。

  1. 鼠标左键点击工具架上的选择工具按钮，选中想要隐藏的数字资产模型或底板物体。

  2. 点击工具架上的隐藏工具按钮，此时被选中的数字资产模型或底板物体将不可见。

  3. 可以在场景大纲中点击取消隐藏按钮重新显示该数字资产模型.

 

删除工具

在场景中删除选中的数字资产模型或底板物体。

  1. 鼠标左键点击工具架上的选择工具按钮，选中想要删除的数字资产模型或底板物体。

  2. 点击工具架上的删除工具按钮，此时被选中的数字资产模型或底板物体将被删除。

 

8）设置模型属性

用户可以通过属性设置面板对数字资产模型进行参数设置，包括模型名称、位置、旋转和缩放参数。底板物体暂不支持属性设置。

修改模型名称

用户可以对添加到场景中的数字资产模型实例进行重命名。

  1. 鼠标左键点击模型名称旁边的重命名按钮，左侧属性框变为可编辑状态。

  2. 输入新的模型名称后，点击属性框外任意位置可确认更改。

设置位置、旋转和缩放

位置、旋转和缩放属性分别包含X、Y和Z轴的数值属性框，支持直接输入精确数值来调整选中的模型。

  1. 鼠标左键点击属性框可以对物体的位置、旋转和缩放属性进行更改。

  2. 属性框被激活后，右侧会显示数值调节按钮，可以按照固定步长调节属性数值。

  3. 点击设置步长按钮可以对步长进行设置。位置步长单位为厘米，旋转步长单位为度，缩放步长为缩放系数。

  4. 属性数值更改完成后，点击属性框外任意位置可确认更改。

  5. 点击缩放属性旁的锁定缩放按钮可以激活或关闭等比例缩放功能。等比例缩放功能被激活后，单独修改任意轴向的缩放值时，其他轴向的缩放值也会按照相同比例变动。

9）编辑底板物体

不同于数字资产模型是由用户后添加的，底板物体是指场景底板自带的物体。用户可以使用拍平工具和隐藏工具对底板物体进行编辑，拍平工具和隐藏工具的使用方法请见使用场景编辑工具架。

  1. 鼠标左键点击工具架上的选择工具按钮，选中想要的底板物体。然后点击拍平工具或隐藏工具按钮，就可以对所选底板物体执行相应的操作，并在三维视图中看到效果。

  2. 每完成一次底板物体编辑时，右下角的底板编辑面板会显示一条记录。系统会默认命名被编辑的底板物体，默认名称由物体类型、默认序号和被执行的操作组成，例如：building_1（拍平）。

  3. 如果用户想要撤销对某个底板物体的编辑，可以点击对应底板编辑记录右侧的撤销按钮。撤销后，该底板物体的编辑记录在列表中消失。同时，用户可以在三维视图中看到该物体被恢复到初始状态。

 

5、面板

1）面板模块界面概览

面板模块的编辑界面由以下部分组成：

  1. 面板模块导航栏

  2. 面板资产列表

  3. 画布编辑视图

  4. 面板编辑工具架

  5. 图层大纲列表

  6. 属性设置面板

 

 

面板模块的蓝图界面由以下部分组成：

  1. 面板模块导航栏

  2. 元素节点列表

  3. 逻辑节点列表

  4. 蓝图编辑视图

  5. SuperAPI设置面板

 

 

1）面板模块导航栏

画布/蓝图切换

导航栏的画布/蓝图切换，可以切换画布编辑和蓝图编辑。

页面名称

中部的名称展示对应页面的名称

页面管理

页面管理用于进行多页面管理，如新增空页面、新增自定义poi点window页或者复制，删除，重命名已有页面，多页面间可以进行跳转操作。

新增页面：可选择新增普通页面或superapi中的自定义poi点的window页。

公开

公开面板是用户将制作的面板公开到51官方商城，经过审核后会添加到其他用户可选择的模板中。

共享

对于企业版用户，可以共享面板至企业群组，群组内成员可以进行编辑。如若意图改变，可以在共享面板中撤回。

3）画布编辑模块

浏览面板素材

  • 模板

模板中结合了51WORLD通过在多行业深耕沉淀之后为您搭建的智慧园区、智慧城市、智慧水务和智慧X等应用场景，用户可自行通过拖拽的方式进行快速搭建。

  • 图标

选择【图标】拖拽进入画布，进行页面装饰，以搭配场景、数据图表或其他图形。图标范围囊括了常见图标、导航图标、标签、按钮、窗口、场景模板等内容。此外还可以自定义上传元素组件（建议上传png格式图片），可将从其他专业作图软件输出的切图直接应用在页面布局中。

  • 图表

从图表组件中选择所需图表模板，拖入面板之中（拖入面板的图表已有初始数值）。并且在配置完成后可以点击“存为常用”按钮来保存在收藏中，后续可以在左侧菜单的图表—收藏中选择进行继续沿用。目前可选图表的类型有条形图，折线图，饼图，和其他特殊类型图。用户可以根据自己想要通过图表展示内容的目的来选择图表的类型。同时也可以通过打开配置处的高级模式对图表的样式进行代码化的自定义编辑。

  • 文本

文本内容支持右侧配置中进行写入也支持双击组件直接写入，富文本组件可对文本格式，字号等内容进行高级设置

  • 高级组件

从组件库中选择需要的组件拖入画布中以使用功能性组件补全页面功能，包括表格组件、导航组件、按钮组件、下拉框组件、开关组件、单选框组件、复选框组件、轮播图、视频组件、iframe组件、列表组件、数字翻牌器组件等。通过不同组件的搭配可以达到丰富面板内容和功能的目的。

  • 我的上传

用户可将本地的一些自定义素材上传至我的素材中，在该面板的不同页面均可使用已上传的自定义素材。注：此处只支持上传图片，且一个面板内上传的素材不支持其他面板使用，其他面板需单独上传素材。

 

场景配置

场景用来对该项目当前页面的底板场景进行搭建，作为面板搭建的第一步操作：

  1. 点击画布中的底板，右侧即可显示场景编辑部分

  2. 可在场景处更改面板的分辨率设置

  3. 实时渲染场景处的服务地址以及口令，默认为场景创作时制作的渲染场景，无特殊需求无需修改

  4. 静态场景可从系统图库中选择也支持自定义图片上传；

  5. 视频场景需要输入视频流播放地址；暂不支持本地视频上传

  6. 场景可选实时云渲染场景、实时非云渲染场景以及非实时渲染场景；

  7. 云渲染画面加载受网络环境影响，可能需要15-60s，避免编辑面板过程等待时间过长，可在实时云渲染场景中配置静态（图片或视频）底图场景图片作为场景示意，快速搭配面板。加载成功后显示云渲染场景。

 

图表配置

通常与左侧菜单栏中基础组件和高级组件配合使用，对组件基础（组件大小及所在画布位置）和进阶（样式、名称、字体大小/颜色/类型、选项等）进行配置，根据所选的组件不同，其组件配置项也会略有不同。

数据配置

  • 数据映射

当用户所配置的数据源中的字段与组件的默认字段名称不一致时，可以在映射输入框中，输入用户数据源中的字段，将这些字段映射到组件对应的字段上。无需修改数据源中的字段，就可以实现数据的实时匹配；

其中字段为图表或组件的默认字段。

状态：可实时展示组件的数据响应状态，响应成功时显示为匹配成功。

自动更新请求：选中自动更新请求，可以设置动态轮询，还可以手动输入轮询的时间频次。清除后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和场景监听来触发请求更新数据。

 

  • 配置数据源

SuperGUI的组件默认使用静态数据源并且带有初始数据，单击配置数据源，可在设置数据源页面修改数据源的类型和脚本：

配置静态数据源：点击配置数据源，从数据响应结果中复制代码到编辑框中，修改字段值为需要展示的内容；

配置动态数据源：在数据源中选择数据源类型为“API”。填入请求URL和请求方式，之后可点击预览数据源返回结果来进行测试；

注：API接口可从数据维护—数据发布中将数据库和静态数据转为API的形式获取，也可以直接填写公网可访问的api地址

  • 数据过滤器

在配置数据源页面中，选中数据过滤器，启用数据过滤器功能。单击右侧的+，添加一个数据过滤器。在过滤器代码编辑框中，输入当前组件数据的过滤代码。最后单击测试，查看数据过滤效果。另外，在添加数据过滤器旁边有“数据过滤器管理”按钮。在其中可查看目前已经配置好的数据过滤器，并且可进行新增、编辑、搜索和删除过滤器等操作。

过滤器由于是js代码，所以可以对数据进行各种编辑后输出。通过复杂的代码逻辑可以过滤出各种所需要的数据，比如：接口返回了数据是0.9，面板需要展示百分比。那就可以在js过滤中加一段逻辑：

return [{

     value: data.score * 100

}]

 

  • 数据响应结果

实时展示了组件所使用的数据。当组件数据源发生变化时，数据响应结果会对应展示最新的数据。如果系统反应延迟，用户可以单击右侧的刷新数据图标，获取组件的最新数据。

4）蓝图编辑模块

元素节点

元素节点即画布中的各个元素组件，当开发者将组件拖入画布的同时，该元素也被添加至蓝图左侧列表中

 

 

当元素被拖入蓝图右侧界面中，元素节点将被分为两个部分：是事件和动作。

事件就是该组件的触发事件，即完成该事件时，继续进行下游的节点，可选择“初始化完成时”或“元素点击时”，个别组件有”当值改变时“；

动作就是它将要执行的动作，处于上一个组件的下游部分，可选显示、隐藏或者切换显隐状态, 个别组件（如下拉选项，图表等）的动作新增了更新组件数据，可用于动态连接api或动态传参时使用。

动态传参：在上游组件与“动态更新数据“的连线处，可在右侧打开”上游数据作为参数请求组件自身接口”的开关，并在组件自身API地址处，用{ }的方式设置传参字段，如：

逻辑节点

逻辑节点提供多种流程控制模块

  • 自定义支路判断：该模块可与其他元素节点、逻辑节点以及场景节点进行联动，比如拖拽API数据接口至蓝图后，连接自定义支路判断，完成多路判断值设置，并设置每个值对应的数据条件后，即可实现当API数据接口中的数据满足设置的不同值后显示不同的后续节点内容。

  • 多支路判断，在画布中已完成多选项配置的元素组件可直接与多支路判断连接，将会自动生成支路判断值进行下游逻辑与交互操作。导航组件多与多支路判断节点相连接，连接后，各页面名称会直接显示于节点中用于后面连接页面切换节点，以实现导航配置。

  • 定时器，即可设置一个时间值，完成设定时间等待后执行触发下游动作；

  • 页面切换，即完成新页面打开或面板页面切换，可选打开网址或切换视口，元素节点或其他逻辑节点均可作为其上游节点；

  • API数据接口，开发者若想接入除SuperAPI外的API接口数据，并实现更灵活的动态更新组件，可通过该流程控制节点进行接口接入和设置。

 

场景节点

场景节点集成SuperAPI产品提供的标准事件以及场景监听功能：

  • SuperAPI标准事件

即通过上游节点完成触发执行SuperAPI事件。任何SuperAPI事件具体代码或属性可通过联调跳转至SuperAPI平台进行。

目前我们提供近30种场景分类百余种标准API数据接口，接口详情可查阅https://superapi.51aes.com/zh/index；

  • 场景监听节点

即对场景回调事件进行监听。即事件的触发来自于场景，执行设定好的场景动作后，则可以对数据进行监听

具体蓝图逻辑与交互操作详情可查看?：https://bbs.51aes.com/study

 

6、导入

1）导入模块界面概览

导入模块的编辑界面由以下部分组成：

  1. 导入模块导航栏

  2. 导入模型列表

  3. 场景三维视图

  4. 场景编辑工具架

  5. 场景大纲列表

  6. 属性设置面板

  7. 底板编辑列表

 

 

2）导入模块导航栏

3）导入模型资产

用户可以上传FBX/RVT/DGN格式的三维模型，系统会自动转换为数字资产以支持添加到场景中。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击导入。

  3. 在左侧的导入模型列表中，点击资产导入卡片。

  4. 在弹出的资产导入对话框中，用户可以根据需要进行以下配置：

  1. 点击上传按钮，弹出系统文件浏览器，用户可以选取模型和贴图源文件所在的文件夹。请事先将要上传的模型和所有贴图文件放入同一个文件夹，并且保证该文件夹下没有其他不需要的文件。

  2. 选取文件夹路径，系统会弹出上传确认提示，点击上传后将会列出等待导入的模型和贴图文件。用户可以通过文件列表再次确认，同时也支持删除不需要的文件。

  3. 点击确认后，在导入资产列表中会生成新资产的卡片，卡片上将显示上传及转化的进度。

  4. 导入完成后，新资产卡片将显示为可用状态。

4）浏览导入的模型

用户可以在导入资产列表中浏览导入的数字资产模型。

  1. 打开案例编辑器。

  2. 在模块导航栏中点击导入。

  3. 点击导入资产列表中的格式分类，可以只查看该格式的模型。

  4. 在搜索框中输入关键词，可以在每种格式分类中快速筛选出名称中包含该关键词的模型。

 

5）为场景添加导入的模型

6）BIM模型查看

用户的.rvt，.dgn等BIM模型，上传转换导入场景后，在导入模块导航栏右侧，出现开启BIM模式。用户点击BIM模式编辑器会进入BIM查看界面。

激活BIM模式后，场景编辑器的左右两侧UI自动收起，同时在三维视图中显示BIM模型浏览器和底部功能按钮。用户可以在BIM模式中进行BIM模型相关操作，操作完成后再次点击BIM模式按钮退出。

 

导入模块的BIM查看界面由以下部分组成：

  1. 导入模块导航栏

  2. BIM模型列表

  3. 构件层级列表

  4. 场景三维视图

  5. BIM编辑工具

  6. 构件属性面板

BIM模型列表

左上面板是BIM模型列表，点击显示在三维场景中显示对应模型，再次点击显示按钮隐藏对应模型。点击构建层级，左下方展开模型的构件层级。

 

构件层级列表

展开构件层级后，列表中树状结构可以点击“+”展开父节点下的子节点，或点击“-”收起子节点。点击眼睛icon可以在三维视图中隐藏显示对应构件。

 

BIM编辑工具

位于三维视图下方的BIM编辑工具架，是对BIM模型进行操作的工具栏。

  • 漫游

步行模式固定摄像机对于地面的高度，方便人行视角漫游观察模型。鸟瞰模式，镜头可以自由转动，方便控制镜头查看。同时弹出的面板可以控制镜头运动快慢。

  • 剖切

选中模型，展开构件层级后，工具栏中剖切按钮可选，对选中的模型进行剖切。

  • 构件详情

选中模型，展开构件层级后，工具栏中构件详情按钮可选，展开右侧构件详情面板。当选中构件层级列表中构件，面板中展示对应构件详细信息。

三

--管理和设置--

1、基础功能

1）管理控制台概览

WDP应用控制管理平台是创建、管理、发布数字孪生应用和资产的一站式入口，它为用户提供了案例项目管理、用户权限控制、多用户流程协作等功能。在数字孪生应用控制平台上，用户还可以进行系统硬件检测和参数配置，以达到平台使用效率的最优化。

 

2）导航栏

WDP应用控制平台的导航栏展示了整个平台的功能模块，分为我的案例、案例发布、资产管理、场景生成和我的权益。用户点击导航栏中的选项卡，可切换至对应的页面。

 

2、我的案例

1）新建案例

新建案例后，直接进入案例编辑器。

系统默认创建案例名称和缩略图，可在编辑器中导航栏双击名称重命名，或返回控制台修改详情。

 

 

 

 

2）案例管理

点击案例卡片的图片，进入案例编辑器

也可以点击卡片下的icon，对案例进行“查看详情”，SuperAPI联调，编辑面板，预览，发布和删除。

 

 

 

3）面板管理界面

在我的案例中，点击编辑面板，进入改案例下包含的面板。

 

 

 

4）面板管理

点击面板卡片的图片，进入案例编辑器

也可以点击卡片下的icon，对案例进行发布，公开，共享和删除。

 

 

 

3、案例发布

1）发布方式

  • 仅场景发布
  • 面板和场景案例发布

发布规则:

1.完成场景编辑或面板编辑后，作为案例发布给客户

2.交付客户手机号：需已注册WDP账号，并下载WDP-案例发布页面可查看

3.确定发布后，不可删除，请慎重操作

发布次数计算：

1.案例发布后，可发布数量减少1个；

2.案例中无场景不能发布；

3.发布后的案例若替换场景。再次发布消耗发布次数。

 

4、资产管理

1）资产管理概览

数字孪生资产对于打造用户个性化的数字孪生应用具有十分重要的作用。数字孪生资产的管理功能可以帮助用户将三维数字模型转化为数字孪生资产，并且实现数字孪生资产的分类、复用和共享，从而提升数字孪生应用的业务针对性和专业性。

数字孪生应用控制平台中的资产管理板块，是用户管理数字孪生资产的中央枢纽：它对接了模型转换与处理服务、51数字孪生资产基础服务平台、数字孪生资产库和数字孪生资产共享和协作平台。这四大服务平台在资产管理板块融会贯通，为用户提供强大的数字孪生资产技术支撑。

 

2）用户资产库概览

用户资产库提供用户添加和管理个人数字资产的功能，是用户专有、非公开的数字孪生资产库。

在用户资产库中，用户可以完成以下操作：

  • 使用文件夹建立用户资产库目录结构，实现目录间跳转浏览，且支持用户资产在不同文件目录中移动

  • 使用资产卡片预览资产缩略图，查看资产详细参数信息

  • 浏览本地三维模型文件，导入单个数字资产，支持配置资产名称、缩略图、资产标签、资产备注等信息

  • 使用关键词和标签搜索用户资产，快速定位想要使用的资产

  • 使用筛选快速过滤非关注资产类型，使浏览更聚焦

  • 编辑修改已导入资产的资产信息

  • 删除不再使用的用户资产

 

 

资产目录管理

通过文件夹功能实现用户资产的分类管理。

操作步骤

  1. 登录数字孪生应用控制平台。

  2. 在资产管理页面，

用户资产卡片

通过资产卡片提供用户通过缩略图预览资产内容的功能，同时支持查看资产的详细参数信息。

用户可查看的资产信息如下表：

导入用户数字资产

通过导入用户数字资产的功能，用户可以进行模型转化，从而在数字孪生场景中使用专有的资产模型。导入单个数字资产时，用户可以根据需要进行资产参数配置。

可配置的参数如下表：

 

操作步骤

  1. 登录数字孪生管理控制平台。

  2. 在资产管理页面，点击用户资产标签页。

  3. 在右侧的资产列表中，点击列表中的添加卡片，在弹出的菜单中选择导入资产。

 

搜索用户资产

通过搜索用户资产的功能，用户可以按照资产名称和资产标签快速检索到想要使用的数字资产，从而提高数字孪生应用的开发效率。

 

筛选资产类型

通过筛选资产类型的功能，可以帮助用户对资产信息进行快速过滤，从而达到节省用户时间的目的。

用户资产库中提供的筛选范围如下表：

 

排序用户资产

通过资产排序的功能，可以使用户控制资产展示的先后次序，优化资产浏览体验。

可供用户选择的排序规则如下表：

更新用户资产信息

通过更新用户资产信息的功能，用户可以编辑修改数字资产的详细信息，以满足数字孪生应用制作的最新需要。

用户可以编辑修改的资产信息如下表：

 

加载用户资产

通过资产加载功能对数字资产进行预加载，已完成加载的数字资产可以直接拖拽到数字孪生基础场景编辑器中进行摆放。

删除用户数字资产

通过用户数字资产删除功能，用户可以删除在数字孪生应用中不再使用的资产。删除资产需要用户二次确认，以防止误删。

 

3）商城资产库概览

商城资产库依托数字孪生资产共享与协作平台，是用户浏览和获取开放数字孪生资产的超级终端，也是实现数字资产交易的重要渠道。

在商城资产库中，用户可以完成以下操作：

  • 使用资产卡片预览资产缩略图，查看资产详细参数信息

  • 使用商城资产筛选器在不同资产分类中进行选择，支持同时选择多个资产分类

  • 使用关键词和标签搜索商城资产，快速找到想要使用的资产

商城资产卡片

通过资产卡片提供用户通过缩略图预览资产内容的功能，同时支持查看资产的详细参数信息。

用户可查看的资产信息如下表：

商城资产筛选器

通过商城资产筛选器的功能，用户可以总览商城资产库的整体分类，并且根据需要选择相应的资产分类进行浏览。

1.0.0版本的资产分类如下表（注：资产分类会随着版本升级不断更新，请关注社区每周“数字资产更新”通知）：

部分参考：（第一期请点击链接查看?：https://bbs.51aes.com/blog/1463786218829570049.html）

搜索商城资产

通过搜索商城资产的功能，用户可以按照资产名称和资产标签快速检索到想要使用的数字资产，从而提高数字孪生应用的开发效率。

 

排序商城资产

通过资产排序的功能，可以使用户控制资产展示的先后次序，优化资产浏览体验。

可供用户选择的排序规则如下表：

查看资产详情

通过查看商城资产详情的功能，用户可以在整版页面的状态下浏览商城资产的展示资料，包括效果图、动态视频等。资产详情页面也支持资产的加载操作。

 

商城分类导航

通过商城分类导航功能，用户又多了一种在不同商城资产分类中快速跳转浏览的能力，适应更多的使用需求。

 

五、场景生成

公有云访问的用户可以获取51WORLD部署在公有云上的数据资产，三维场景生成服务，瓦片服务，和模型转化服务等。

如果用户拥有自己的空间数据，例如：SHP数据，OSGB数据等，需要生成场景进行开发。PaaS平台开发私有化部署的版本满足场景生成需求，因为用户对空间数据都有很高的保密要求。私有化部署的版本中，用户可以将当前公有云的服务部署在本地内网环境中，保证数据安全。

如果有该类需求，请联系我们的商务人员?（https://wdp.51aes.com/invite-join-service?origin=business）

 

六、系统设置

系统设置：针对服务部署的稳定性相关设置及用户界面基础设置功能的集合管理

主要包含二级菜单：系统管理，服务管理，硬件检测，网速测试，预热驻留，用户设置

 

 

1）系统管理

系统维护支持查看和修改云渲染的常用配置, 监控云渲染的运行状态。

 

 

工作机资源使用情况：

显示对应GPU的型号以及查看GPU资源使用情况，资源使用机制：默认查看一个场景对应使用占用显卡1路资源

 

 

 

2）服务管理

管理云渲染服务设置页面，提供点集合服务开关、系统自检、启动默认 项及自动重启设置；

点聚合服务：解决底板展示海量单点信息的痛点，会根据三维场景当前的镜头信息，对海量单点坐标进行运算，将结果以聚合图标的形式友好的展示在屏幕上

在云渲染后台管理界面, 可根据客户本地网络环境, 自行设定点聚合服务端口:7009（默认）

系统自检：验证系统环境是否满足软件运行条件，包括网络，渲染机，数据库等

配置启动项：根据使用场景，可以设置选择软件启动后默认进入页面，设置后需重新启动软件后该设置生效

自动重启设置：设置工作机重启服务的时间和重启频度

 

 

 

硬件检测：数字孪生PaaS平台的预览和部署对硬件要求较高，针对系统硬件提供检测功能，并对检测结果给出综合结果

 

 

 

网速测试：检测设备与服务器之间的下载速度与上传速度；记性延迟测试：查看流量的速度数据往返进程的估计时间，以确保延迟不会影响网络的性能

 

 

 

预热驻留：为了解决底板开启加载速度慢，等待时间过长的问题，根据拥有的渲染资源提前设置预热该底板，达到需要访问此底板的用户可以立刻打开底板，节省等待时间，提升用户体验

用户设置：支持分辨率设置

 

三

--SuperAPI参考手册--

 

SuperAPI是开发者和AES场景底板的桥梁，它是一套由JavaScript语言开发的负责交涉Web页面（51浏览器）和51Cloud云渲染平台之间的编程接口，基于51Cloud云渲染平台使用；用户可在Web页面（51浏览器）上创建任意HTML5 UI元素，利用SuperAPI与AES场景底板进行双向交互。

SuperAPI兼容当前主流的JavaScript前端框架，为前端开发人员提供快速便捷的开发接口。

  • SuperAPI for PaaS 用于服务WDP4.0的相关场景
  • SuperAPI for Project 用于服务WDP3.0的相关场景

详细的参考手册请点击链接查看?：《【使用手册】用PaaS搭建第一个属于你的数字孪生应用》

 

四

--常见问题--

一、热门问题FAQ：

1、平台可以试用吗？

答：可以申请试用。详见：https://wdp4.51aes.com/join-service?origin=paas，12月1日正式开放。

2、平台支持离线部署吗？

答：支持离线部署。

3、平台支持哪些BIM模型格式？

答：FBX、RVT、DGN（待开放）

4、用户需要的场景或模型没有提供怎么办？

答：若需要定制场景，请联系51WORLD商务进一步洽谈。要填报项目基本信息，我们会有商务工作人员主动联系您，说明对接流程及需求梳理；填写表单地址：https://www.51aes.com/about/contactus

5、平台可以对接已有的信息业务系统作集成开发么？

答：可以的。         
WDP开发者平台支持两种开发方式：     
        - 一种是基于SuperGUI产品进行零代码、PPT式的开发方式，满足高效率、低成本数字孪生业务场景构建需求； 
        - 一种是基于SuperAPl产品进行JS SDK集成的开发方式，满足拥有技术开发能力并需要大量自定义业务功能开发需求的团队进行集成开发。

6、三维场景是否支持VR终端浏览？

答：目前不支持。

7、三维场景是否支持路网资产模型导入？

答：目前不支持。

8、本地版云渲染地址出问题了， 请问如何解决？

答：要看一下8889这个端口地址是不是被其他占用了 也可以到windows 系统控制面板，卸载程序，下，点击右键，选择“更改”，再点击“修复”一下看看

9、有导入3DSMAX模型的临时方案吗？

答：检测材质是否能够被导出，Standard (Legacy) 则可无损导出FBX中。在max软件界面菜单栏->文件->导出→导出，如下图所示。选择保存类型为fbx。
 

二、其他文档&视频课程：

WDP相关产品文档汇总：https://bbs.51aes.com/blog/hot/1417365310445178881.html

WDP相关视频课程学习：https://bbs.51aes.com/study

PaaS相关问题答疑参考：https://bbs.51aes.com/faq/new/1417365310445178881.html

 

更多疑问请前往?【问答区——求助区?】查找，或直接在社区搜索框搜索关键词查找问题~

 

如需产品同学协助解决问题的开发者

请加入开发者社区官方QQ答疑群（群号：780777412）领取

???

 

您愿意向朋友推荐 ‘社区博客’ 吗？
强烈不推荐 不推荐 无所谓 推荐 强烈推荐
感谢您的反馈，谢谢！
阅读 3008 本作品系原创，转载请联系作者授权
赞 1 收藏
全部评论({{commentCount}}条评论)
得票数 最新

暂无数据