模型

在三维城市场景中，还支持glf与gltf格式模型的渲染。

如下图，在子组件列表中点击 “模型”可以进入模型子组件的相关设置。

数据项

模型子组建支持在数据项设置中传入数据，数据接口字段说明如下表：

字段	状态	说明
modelId	必传	用户自定义的模型ID,可以用来与其他的组件作交互绑定
lng	必传	模型所在位置的经度
lat	必传	模型所在位置的纬度
height	选传	模型所在位置的高度
url	必传	glf/gltf模型资源的在线链接地址

数据示例

[
    {
        "modelId": 1,
        "lat": 26.56819,
        "lng": 106.7145,
        "height": 1200,
        "url": "https://uniplore-source.oss-cn-chengdu.aliyuncs.com/bigscreen/city/model/feiji.glb"
    }
]

信息

注：中心点的高度并不是直接从地表开始算的，而是从地表往内的一段距离。当高度设置为1300时，在场景上显示的高度大概距离地表300米左右。以后涉及高度的设置都遵循这个原则。

基本设置

• 颜色：模型在场景中的颜色
• 模型最大比例：模型的最大比例
• 模型最小像素：无论模型缩放到什么比例，模型的近似最小像素大小。
• 缩放比例：模型的缩放比例。范围：[0,30]

姿态设置

场景中模型的姿态，包括偏航角，俯仰角、翻转角。

序号	设置项	取值范围
1	偏航角	[-180, 180]
2	俯仰角	[-180, 180]
3	翻转角	[-180, 180]

缩放设置

• 远距离缩放：开启/关闭远距离缩放，远距离缩放是针对当场景镜头与模型之间的距离超过一定的临界值时，模型将会按照设置好的缩放比例来缩放模型这种情况而设计的。距离临界值可以设置成数组。
• x向缩放：当关闭远距离缩放时有效，场景上东西方向的缩放。
• y向缩放：当关闭远距离缩放时有效，场景上南北方向的缩放。
• z向缩放：当关闭远距离缩放时有效，垂直与地表方向上的缩放。
• 缩放数组：(如上的第二张图)，当开启远距离缩放时有效，数组的每个元素可以设置缩放距离临界值和缩放比例。当模型与相机的距离超过临界值时，模型就会按照该临界值对应的缩放比例来缩放模型。

信息

模型的缩放数组元素之间可以乱序，内部会自动按照缩放距离临界值大小来排序的。但是在缩放数组内部一定要设置一个临界值为0的元素。

蓝图编辑器

事件

事件	说明
当数据接口数据请求完成时	数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。
点击模型时	开启场景交互拾取操作后，点击模型，会抛出被点击模型的guid

动作

动作	说明
当请求数据接口	重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如折线阶梯图配置了API数据源为 http://api.test，传到请求折线阶梯图接口动作的数据为{ id: '1'}，则最终请求接口为http://api.test?id=1。
当导入数据接口	按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。
镜头飞入该组件	场景相机镜头会缓慢飞入该子组件的上方。
显示	在三维城市场景中显示该子组件
隐藏	在三维城市场景中隐藏该子组件
触发缩放数组计算	开启远距离缩放后，有时候不能自动触发缩放数组的计算(比如镜头飞入其他非模型的子组件时，模型与场景相机的距离虽然发生改变，但是却无法触发缩放数组的计算)，需要手动调用来触发。
接受路径动画信息	使用于模型与路径动画子组件作绑定的场景，用户自行传入模型与路径动画的自定义id,路径动画加载好后会将自身的id数据抛出来，该蓝图动作就是用来接收路径动画抛出来的id数据。图示如下
设置路径动画	传入需要进行绑定的路径动画与模型的自定义id,示例数据：{ "modelId": "m0", "pathId": "p0" }