开发者必看！图观™统一开发API及API调试器入门 第六讲

课程6：模型操作

小伙伴们大家好，欢迎大家来到图观统一开发API及API调试器入门课程的第6课。

上节内容，大家介绍了 “地标点、路径图、区域图、地标图、气泡图、热图以及自定义模型和图标”几种图层的操作方法。

本节课程，我们主要讲解“模型操作“，主要包含“模型操作 、获取建筑、拆分楼层、3DMarker ”4部分内容，并会在统一API调试器中进行相关的演示操作。

图观™引擎 统一API调试器零基础入门课程6《模型操作》

本节课程安排

第一部分：【模型操作】

第二部分：【获取建筑】

第三部分：【拆分楼层】

第四部分：【3DMarker】

本节课程详解

一、模型操作

·添加模型

我们在API调试器里，点开添加模型，可以看到有添加模型、删除模型、控制模型转换这三个接口。

首先我们来介绍一下如何添加模型，通过调用”addModel”方法添加模型，这里我们需要”modelType”（模型的名称），可以通过”获取自定义模型和图标”的方法，点击执行后，在下方回调信息中找到”customModels”，我们这里选用 ID“18639”的模型，这个模型是场景中遮阳伞贩卖机模型。

回到添加模型接口中，我们来添加模型。在右上方代码面板中，我们先把不需要的代码删掉，来看一下添加模型的参数信息。

方法中有模型的id、轴坐标、经纬度、高度，

rotation——为三轴旋转角度，

alpha——透明度，

scale——缩放倍数，

titleText——特效标签文字，

titleColor——文本颜色，下面是文本颜色，

visible——当前模型显隐状态，

modelType——添加的模型，

点击执行该方法后，就可以看到模型出现在场景中了。

·模型转换

转换的模型id是customModel01,控制模型基础变换使用的是“setModelTransform2”方法，在此方法里，我们可以修改模型的经纬高、旋转角度、缩放倍数、持续时间等，druation是模型转换完成所需要的时间，是指从改变前位置到改变后位置所用的时间。

在当前的代码中，我们更改了模型的位置、缩放倍数，点击执行，可以看到模型发生了位移，且随着位移过程进行了放大。这就是修改模型属性进行模型转换的方法。

·删除模型

删除模型使用的是“removeModel”方法，该方法我们只需要传入模型“id”即可删除对应的模型，我们点击执行，可以看到场景中的模型就被删除了。

以上就是模型操作的方法。

二、获取建筑

获取建筑使用的是“getBuildings”方法，可以获取到场景内的建筑信息，点击执行，可以在“事件日志”中看见有一个名字为“buildings”的数组，包含“id”“floors”“num”“rooms”几个参数，获取这些信息之后，可对模型进行剖分，展示更多的细节。

三、拆解楼层

首先来看一下API调试器中内置代码的效果，点击执行，可以看到场景聚焦到了单体建筑，并且展示出了建筑剖分后室内结构的状态，并在3秒后恢复楼宇的外观效果。再次执行，可以清晰地看到场景聚焦-拆分-高亮-恢复地全过程。

下面我们来分步为大家讲解一下：

首先介绍聚焦楼层的操作。使用“focusBuilding”方法，通过传入“buildingid”和“distance”镜头局建筑物的距离，点击执行，即可聚焦建筑。这里还可以看到建筑包含高亮的效果，高亮效果使用的是“highlightBuilding”方法，通过传入建筑的id和“type”（高亮风格），就可以实现了。

拆解楼层使用的是“showBuildingFloor”方法，要设置好建筑的“id”、“floor”拆解的楼层号、“animation”楼层拆解的动画，就可以完成楼层拆解的操作。

接着我们来恢复建筑，恢复拆解使用的是“resetBuildingFloor”方法，只需要传入id，点击执行即可恢复建筑。

四、3DMarker

3Dmarker类似于在场景上添加一个地标点，但是并不是图标，而是一个动态的模型特效。 

我们先来看一下代码中的参数信息：

add3DMarker方法：添加3DMarker

update3DMarkerCoord方法：更新数据

update3DMarkeStyle方法：更新样式

removeOverlay：删除3DMarker

下面我们，来看一下代码拆分的效果。

·添加3DMarker

首先，我们先来添加3DMarker，我们当前定义了代码数据，其中，

alpha——透明度

scale——缩放倍数

type——特效样式类型，可以修改不同的样式

titleText——特效标签文字

coord——经纬度

coordZ——高度

tag——自定义的数据

visible——当前图层的显隐状态

通过add3DMarker方法就可以进行添加，执行之后，我们可以看见，在场景里出现了一个旋转菱形地标，下方带有旋转光圈，这就是其中一种3DMarker。我们将其删除，添加另外一种类型的3DMarker，我们选择样式为“Revolve01”，执行之后，我们可以看到场景中出现了一个白色半透明且旋转的3DMarker。这些就是添加3DMarker的操作。

·更新3DMarker位置

使用update3DMarkerCoord方法，点击执行之后，我们可以看到场景中3DMarker的位置发生了变化，使用update3DMarkerCoord方法，修改经纬度信息、高度信息，就可以完成3DMarker的位置更新。

·更新3DMarker样式

使用uppdate3DMarkerStyle方法可以更新3DMarker的样式，我们可以修改其scale（缩放）大小、alpha（透明度）、还有type（类别样式）、titleText（文字）也是可以修改的。当前代码我们已经定义了一套新的数据，点击执行，可以在场景里看到3DMarker的样式发生了变化，并且上方多了“更新特效”的文字。这就是3DMarker更新样式的方法。全部样式清单可以参考：https://www.tuguan.net/doc/tg-api/?manual.model.marker.operation，文档的描述。

·删除3DMarker

删除操作使用的是clearOverlayType方法，我们只需要在OverlayTyp指令后传入要删除的模型类型，这里我们传入“3DMarker”，点击执行，可以看到场景中的3DMarker被删除掉了。

以上就是3DMarke操作的内容。

本节总结

好了，本节课和大家介绍了模型操作、获取建筑、拆解建筑、3DMarker操作的内容，小伙伴可以自己在API调试器中进行联系使用哦~

下节预告

下节课，我们将为大家介绍模型轨迹图的相关操作，会在API调试器中为大家详细演示，助您更加便捷高效地调试复杂代码、构建数字孪生应用。记得一定要持续关注我们哦~