山海鲸操作实例培训资料.docxVIP

山海鲸制作的页面更适合作为页面展示,不适合做过多的复杂交互,其中3D页面对数据展示的也比较少,更多的是通过2D页面对数据进行一个展示

3D的页面常见的操作可以有:

切换相机的视角

静态或者动态添加标注点或者添加弹框

2D常见的页面展示有

子看板的切换(包括子看板内容和tab键[可以理解为切换键]选中之后的状态变化)

Echart图表的展示

表格展示(包括利用下拉菜单联动查询,但目前表格不支持文本框的模糊查询)

分组面板(选项卡)的使用

下拉菜单的使用

缺点

所谓3D页面其实更类似于2.5D,目前还是偏重于展示模型或一些简单的数据,不能做到对一些工业化的场景进行实时数据传输和展示,更多的数据展示是通过2D组件来实现的,但是2D组件也是更多倾向于绑定数据库表格和字段展示信息,复杂的一些交互操作不能直接通过配置实现,还得配置+二开来完成,比如说点击表格传参并打开弹框根据不同的参数展示不同的数据,需要在”交互”面板发起一个”点击某一行”的交互设置,然后通过动作”触发二次开发中的事件”,锁定到具体的目标组件,和具体的动作名称,再在二开交互的脚本中去监听这个动作名称来实现逻辑

这个过程其实显得繁琐了,如果是通过正常的项目自定义代码去实现会简单好多

静态的3D物体添加标记点及点击标记点时相机转动到对应位置和弹出标记点的弹框信息

①标绘栏根据需要选择标记

②把标记添加到对应的物体上

③前景看板添加弹窗,并给弹窗设置不同的状态

④给标记组添加交互,主要是设置”标记组选中”时实现动作”切换到标记视角”,因为设置的是标记组,所以选中单个标记时都会执行这个交互

⑤单独设置单个标注点的交互,实现点击不同标注点展示不同的弹框并同时关闭其他弹框

给带有动画路径的物体添加弹框信息

从山海鲸编辑器4.20版本开始可以给带有路径动画的物体通过”标记面板”添加绑定弹框信息

项目通过iFrame的方式集成到其他网页当中时通过url传参与项目参数的设置

山海鲸项目一般是作为一个页面,利用山海鲸编辑器可以发布为一个链接或者是iFrame内嵌代码,如果是iFrame内嵌代码则可以通过iFrame的方式集成到其他网页,在其他网页通过iFrame的src属性传参数.

iFrame传递过来的参数,如果在项目中有使用到的话,就需要先在项目中的”项目设置”对”项目参数”进行设置,传过来的参数字段名是什么,一般在项目参数里面也设置相应的字段名,方便后面的理解和对应.

API请求使用项目参数是最频繁的,一般来说在上述传参和项目参数设置没问题后,API是GET请求的话,我们将这个API导入到山海鲸当中，注意在参数中需要填写成如下的形式：

\t/docs/v1/kkzp9pm4ifpwxyr2/_blank36:65535/v1/app/4e33ed8b-1d91-4b73-ab26-cb204508c572/46fa577b/?type={:city}

本地项目起的一个服务示例API请求为

6:8333/metroGis/geojson/test.json?text={:text}

可以看到请求是成功的,有数据返回,但是这些API请求接口是通过websocket请求到软件的系统进程中,在用系统进程请求的,这样可以解决跨域的问题,这种情况下自定义的接口请求是不会暴露出来在浏览器上的,所以浏览器看不到这个接口请求.如果要看项目参数是否有正确获取到的话只能通过其他形式来判断,比如项目中绑定一个文本组件来显示项目参数,

在设置项文字后面，鼠标移动上去，可以看到三个点，注意一定要点击三个点之后切换成动态值，才可以使用项目参数。

如图所示,参数city是有传到项目当中的,注意city后的参数实际是中文上海，需要用URLEncode后传入（这里采用UTF8编码）。所以API中有使用到参数的话先看下项目参数是否接收到url的设置了,只要这一步对了,url那边写的是对的,API请求就能顺利带上参数

对API请求接口返回的数据格式有什么要求?

山海鲸可视化支持采用JSON返回的API形式，推荐大家一个API内只返回一组数据。如果返回多组数据，软件也会尝试进行自动识别，不过可能会有一定的误差。如图是通过本地服务模拟的接口返回的数据

数组下嵌套数组会识别不出来

对象下的数据展示效果

对象下子属性又是一个对象的展示效果

返回的是字符串的展示效果

常见的表格操作

①表格查询(包括精准查询和模糊查询)

精准查询主要通过下拉菜单与表格间的数据联动进行配合查询,具体操作如下

一添加下拉菜单,选中下拉菜单,在下拉菜单的选项属性的扩展功能(三个点)设置”生成数据字段”

设置后选项属性如图所示

点击上图圈起的”请设置数据字段”会直接跳转到