课程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/doc/tg-api/?manual.model.marker.operation,文档的描述。
·删除3DMarker
删除操作使用的是clearOverlayType方法,我们只需要在OverlayTyp指令后传入要删除的模型类型,这里我们传入“3DMarker”,点击执行,可以看到场景中的3DMarker被删除掉了。
以上就是3DMarke操作的内容。
本节总结
好了,本节课和大家介绍了模型操作、获取建筑、拆解建筑、3DMarker操作的内容,小伙伴可以自己在API调试器中进行联系使用哦~
下节预告
下节课,我们将为大家介绍模型轨迹图的相关操作,会在API调试器中为大家详细演示,助您更加便捷高效地调试复杂代码、构建数字孪生应用。记得一定要持续关注我们哦~
更多推荐
开发者必看!图观™统一开发API及API调试器入门 第六讲
发布评论