飞渡内部培训

一、安装

Explorer、Cloud、Engine

安装

        略

配置pak

先配置Cloud的，Explorer可以选择相同路径，Engine不需要配置，但需要对应的建模软件。

a、选择目录：选择有pak的文件夹路径

b、打开：打开当前目录，将pak拷贝到该的文件夹中

Cloud：

Explorer：

二、模型处理

地形影像

tif格式文件的影像和高程，选择输出地址和文件名，其他配置不管。可以不需要高程，发布成平面

其中下载的影像和高程需要转坐标系，2000 中央子午线3度 120E

倾斜摄影

osgb格式文件，选择整个目录

MAX模型

max格式、fbx格式，添加文件后，左键选中再点击设置类型或者直接右键设置类型，模型是什么类型就选什么类型，主要是建筑、地面、水、地下管线这四类

模型处理完后，添加到工程里，发现远看和近看有材质消失时，勾选剔除偏远模型

BIM

rvt、dwg、ifc、主要是这三类，其他格式看介绍。其中rvt文件对模型软件的版本有严格要求，跨版本处理不了，点击下面的数据预检，看是否有匹配的模型软件版本，没得就要么安装对应版本的模型软件，或者将模型文件升级

其他

目前没遇到过其他模型文件，发布操作看官网教程

三、场景搭建

打开工程

打开工程文件夹中的acp文件

新建工程

选择坐标系 CM 120E 以便匹配影像地形

导入3dt

engine处理后的文件都是3dt格式，先导入地形为基准，再导入模型做位置调整

因为地形较大，中心移动点离边角较远，对齐不方便，模型一般较小，方便对齐边角

路径管理

在带入3dt之前，先将3dt拷贝到工程文件里，以便软件采用相对路径存储文件，方便后期拷贝工程时简化配置操作

例如：D:\05党建大屏BIM模型\xxxx2025\轨道集团桥梁运维2025_files\3dt

D:\05党建大屏BIM模型\：是工程文件路径

xxxx20252025\：是工程文件夹，包含以下内容，acp是工程内容文件，dtml是工程内容标记文件，xml是个人导出的植被文件

xxxx20252025_files\3dt：是工程内容保存的文件夹，将处理的3dt放在这里就行，backups是历史保存文件，可以用来回溯编辑版本，将里面的文件名改成acp的文件名和文件格式再取而代之即可

标注美化

常用工具：材质、植被、交通工具、折线、多边形、灯光、标签、动态标记、光流

标签

这是默认配置

标题内容：就是要显示的文字

引线：就是标签到地面的线，w设置为0就是没有线

可见范围：整体可见范围，距离0-10000可见

文字可见范围：距离0-6000可见，当处理6001-10000时，只有标签图标没有文字，当鼠标放在标签上时，会显示出文字

剔除遮挡：就是标签直线不可见时会隐藏，一般关闭

折线

点击创建，操作逻辑是左键添加路径点，右键单点是结束编辑，右键长按可以旋转视角，然后通过键盘wsad复制移动相机位置来编辑路径点

创建完后，关闭折线添加框，再在图层树里编辑折线样式

觉得线路有问题，再点开这个折线添加框，然后左键点击添加的折线会出现之间点击的路径点，点击这个路径点可以调整它的位置，或者点击点与点之间的线段，可以选中这整个线，整体移动位置

光流、多边形同理

图层树

最下的字符串就是该图层的id

变换：就是偏移，第一个是可以旋转，第二个只能上下左右移动，也可以输入具体数值来移动

这个是以物体中心为基点，生成移动轴，所以需要以小物体去匹配大物体

图层文件夹

点击新增文件夹，若没有选中图层则是最外层新增文件夹，若选中了图层，包括文件夹，则会新建一个文件夹将选中的图层包裹起来，成为它的父文件夹，这个需要注意

四、代码开发

sdk

在cloud中有sdk入口，里面有所有类的所有方法介绍

实际调用

cloud中在实例管理里面，已启动的实例点选后，点击API实例，会给出该方法的实际调用形式和处理逻辑，主要是看需不需要异步调用和快速获取对象类的所有参数项

其中，勾选 点击不执行，再手动点击执行JS，防止误触

五、常见问题处理

1、快速匹配位置

变换：用坐标测量模型在地膜的大概位置，然后减去模型大致的中心位置的坐标就是偏移量，即终点减去起点坐标，得到的结果输入在变换里，然后再细调位置和旋转，

旋转：主要是调整Z，顺时针是+正数变大，逆时针是-负数变小

2、处理模型闪面

在材质编辑中，吸取有闪烁的材质面，然后调整材质的遮挡顺序

3、实例加载异常

运行状态：

Running，才是正常

Stop，停止，原因可能是手动停止或者异常停止，需要手动启动，右键后点击启动即可

六、进阶操作

配置Https

需要证书和私钥，至于端口映射根据需求来，启动https后，访问地址从

http://172.17.16.51:8080/samples/locale_zh/player.html?iid=2462623268777

变成

https://172.17.16.51:8080/samples/locale_zh/player.html?iid=2462623268777

端口映射后变成 域名访问

事件回调

在视频流加载出来后，左键点击场景中的内容会有回调事件，部分内容没有，比如在explorer中添加非模型内容，标签，线，面等

根据业务交互需求来配置对应的处理方式，怎么搭配

主要回调类型有左键点击，漫游结束，相机停止移动