场景管理器是3D地球(2018)的子组件,支持独立的样式、数据和交互配置,能够使用数据定义镜头位置,通过移动和缩放的动效展示球体的不同位置。本文档为您介绍场景管理器各配置项的含义,帮助您快速准确地使用场景管理器子组件。

参考地球容器添加场景管理器子组件,并配置其参数。

配置


场景管理器配置面板
  • 搜索配置:单击配置面板右上角的搜索配置,可在搜索配置弹出框中输入您需要搜索的配置项名称,快速定位到该配置项,系统支持模糊匹配。详情请参见搜索组件配置
  • 启用:勾选后,启用场景管理器。在进行下面的配置前,请首先勾选此配置项。
  • 轮播模式:场景动画轮播的模式,可选:单次轮播循环轮播
  • 持续时间:单个场景动画的持续时间,取值范围为0到30000,单位为ms。如果数据中有duration字段,则优先使用数据中的配置。
  • 延迟时间:一个场景动画结束到下一个场景动画开始所停留的时间,取值范围为0到30000,单位为ms。如果数据中有delay字段,则优先使用数据中的配置。
  • 回调ID:设置组件之间数据联动的变量,需要配置为数据中的某一个字段。
    注意 此功能已更新到交互面板中,样式面板的该功能将弃用,请尽快升级。新版本的交互功能支持配置多个字段。

数据


场景管理器数据面板

上图中的示例JSON代码如下:

[
  {
    "id": "1",
    "name": "beijing",
    "position": {
      "fov": 50,
      "lat": 39,
      "lng": 115,
      "distance": 400
    },
    "duration": 3000,
    "delay": 3000
  },
  {
    "id": "2",
    "name": "shanghai",
    "position": {
      "fov": 30,
      "lat": 30,
      "lng": 120,
      "distance": 300
    },
    "duration": 3000,
    "delay": 3000
  },
  {
    "id": "3",
    "name": "guangzhou",
    "position": {
      "fov": 50,
      "lat": 23,
      "lng": 113,
      "distance": 400
    },
    "duration": 3000,
    "delay": 3000
  }
]
  • name:场景的名称。
  • position:场景的坐标位置以及相机角度距离,内部有4个属性值,分别为fov(相机角度)、lat(纬度)、lng(经度)、distance(相机距离)。
  • duration:(可选)场景动画的持续时间,与持续时间配置项作用相同,如果两者都进行了配置,则优先使用数据中的配置。
  • delay:(可选)不同场景动画的间隔时间,与延迟时间配置项作用相同,如果两者都进行了配置,则优先使用数据中的配置。
表 1. 配置项说明
配置项 说明
自动更新请求 勾选后可以设置动态轮询,还可以手动输入轮询的时间频次。
数据源 单击配置数据源,可在设置数据源页面中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置组件数据
数据过滤器 单击添加过滤器,可在设置数据源页面中配置数据过滤器,详情请参见组件过滤器使用说明
数据响应结果 展示数据请求的响应结果。当数据源发生改变时,可单击右侧的刷新图标,实时查看数据响应结果。

交互

勾选启用,开启组件交互功能。场景管理器拥有交互配置,可在某场景结束时抛出回调值,默认抛出数据中的id字段。具体配置请参考组件回调ID配置


场景管理器交互面板