路径动画模型是三维城市构建器创建模型的图层，支持独立的样式配置，包括路径动画模型的通用样式、图形样式、动效样式和交互样式等。本文介绍路径动画模型各配置项的含义。

在场景编辑器左侧图层列表中，单击路径动画模型图层，进入配置面板配置路径动画模型图层的样式和数据。
说明 如果图层列表中没有路径动画模型，说明您还未添加路径动画模型图层，请参见添加子组件进行添加。

配置

说明 避免添加多个路径动画模型，免得性能开销过大。
配置面板
  • 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置面板中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索资产配置。
  • 路径动画模型配置面板中的参数说明。
    • 通用
      参数 说明
      阴影设置 打开开关，路径动画模型加载的模型可以设置阴影效果；关闭开关，路径动画模型加载的模型不能进行阴影设置。
      深度测试 打开开关，路径动画模型加载的模型可以进行深度测试；关闭开关，路径动画模型加载的模型不可以进行深度测试。
      说明 深度测试打开可能后会导致该对象被其后面的对象遮挡。
      显示线框 打开开关，显示路径动画模型加载的模型的线框；关闭开关，不显示路径动画模型加载的模型线框。
      不透明度 设置路径动画模型加载的模型的不透明度系数，取值范围为0~1。
      高度偏移 路径动画模型加载的模型距离地平面高度的偏移值 ，取值范围为-300~5000。
      光效设置 拖动滑块设置路径动画模型加载的模型的发光强度，取值范围为0~1。
    • 图形
      参数 说明
      模型地址 设置路径动画模型加载的模型的地址。
      旋转 拖动滑块设置路径动画模型加载的模型在X轴、Y轴和Z轴三个方向的旋转角度。
      缩放 拖动滑块设置路径动画模型加载的模型在X轴、Y轴和Z轴三个方向的缩放值。
    • 动效
      参数 说明
      模型动画 设置路径动画模型加载的模型的动画样式。
      • 自动播放：打开开关，开启动画播放；关闭开关，关闭动画播放。
      • 循环模式：设置路径动画模型播放的循环模式，可选重复播放、单次播放和反向播放。
      • 动画速率：动滑块设置路径动画模型加载的模型动画速率，取值范围为-1.5~1.5。
      扫光动画 打开开关，设置扫光动画样式；关闭开关，无法设置扫光动画样式。
      • 锋面类型：设置扫光动画的锋面类型，包括平面类型和曲面类型。
      • 扫描轴向：当锋面类型选择平面时，扫描轴向包括X、Y和Z轴。
      • 正负方向：设置扫光动画的正负方向，包括正方向和负方向。
      • 颜色：设置扫光动画的颜色，请参见颜色选择器说明修改颜色。
      • 扫光长度：拖动滑块设置扫光动画的长度比例，取值范围为0.01~1。
      • 扫光速度：拖动滑块设置扫光动画的速度比例，取值范围为0~0.05。
      路径动画 打开开关，启用路径动画；关闭开关，停止路径动画。
      • 自动播放：打开开关，路径动画可以自动播放；关闭开关， 路径动画暂停播放。
      • 循环模式：设置路径动画模型播放的循环模式，可选重复播放和单次播放。
      • 动画时间：拖动滑块设置动画播放时间，单位为ms。
      • 显示路径：打开开关，显示路径；关闭开关，不显示路径。
      • 路径高度：拖动滑块调整运动路径高程，取值范围为0~5000。
      • 曲线张力：拖动滑块调整路径曲线弧度，取值范围为0~1，数值越大，弧度越大。
      模型展开 单击右侧的加号图标或垃圾桶图标图标，添加或删除一个模型展开样式。 单击横排列图标或竖排列图标图标配置多个模型展开样式。单击复制图标图标，即可复制当前选中模型展开样式并新增一个同样配置的模型展开样式。
      • 面id：输入模型需要展开的对象名称。
      • 偏移量：拖动滑块设置模型需要展开对象的偏移量。
      • 偏移方向：设置模型需要展开的对象在X轴、Y轴和Z轴的偏移方向。
      • 持续时间：拖动滑块设置模型展开动画的持续时间。
    • 交互：设置路径动画模型的交互样式。
      参数 说明
      鼠标交互 打开开关，开启鼠标控制交互的效果；关闭开关，鼠标无法控制交互。
      点击区域 设置鼠标单击路径动画模型加载模型的区域选项，包括局部和整体两个选择。
      点击颜色 单击路径动画模型加载的模型时，选中对象的颜色。

数据

数据面板
表 1. 字段说明
字段 说明
id 路径动画模型加载的路径id。
geometry 路径动画模型加载的路径坐标。
如果您在创建三维城市构建器项目时，使用了空间数据项目模式，并且项目内包含了路径动画模型的数据内容。在场景编辑器内配置路径动画模型的数据面板时，您还可以使用空间构建数据源获取空间地图上路径动画模型的数据， 具体步骤如下：
  1. 在图层配置面板中选择数据页签，单击面板下方的数据源类型下拉框，选择空间构建数据源。
  2. 在面板下方的数据项目下拉列表中，选择一个空间构建平台内已有的数据项目。选择数据项目
  3. 选择完数据项目后，在数据集下拉列表中，选择一个匹配的数据。数据集面板
    说明 如果数据项目和数据集配置项内没有任何可供配置数据类型的内容，请您单击面板内前往空间构建平台管理数据处，进入空间构建平台配置数据。详情请参见空间数据管理概览。
    管理构建平台入口

蓝图编辑器交互配置

  1. 在当前场景编辑器页面，单击左侧图层列表中路径动画模型右侧的导出到蓝图编辑器图标。
  2. 单击页面左上角的蓝图图标图标。
  3. 在蓝图编辑器配置页面，单击导入节点栏内的路径动画模型图层，在画布中可以看到如下图所示的路径动画模型的蓝图编辑器配置参数。蓝图配置面板
    • 事件
      事件 说明
      当运动路径请求完成时 当运动路径请求完成时，抛出数据为array类型，包含id和geometry字段。
      左键点击模型 当鼠标左键单击模型时的事件，抛出单击的对象、对象名和对象实例id。
      右键点击模型 当鼠标右键单击模型时的事件，抛出单击的对象、对象名和对象实例id。
      模型加载完成 当模型加载完成时的事件，抛出类型为object的数据。
    • 动作
      动作 说明
      请求运动路径 重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如路径动画模型配置了API数据源为http://api.test，传到请求运动路径动作的数据为{ id: '1'}，则最终请求接口为htp://api.test?id=1。
      导入运动路径 导入运动路径，动作传入数据为array类型，包含id和geometry字段。
      显示组件 显示组件，不需要参数。
      隐藏组件 隐藏组件，不需要参数。
      扫光动画 更新扫光动画配置，动作传入数据为object类型。数据示例如下。
      { 
  "enable": false,   //开启或关闭扫光动画，默认值false。
  "frontier": 1,     //锋面类型，默认值1。
  "axisType": 1,     //扫描轴向，默认值1。
  "direction": 1,    //扫描方向，默认值1。
  "color": "#6699ff",//扫光颜色。
  "length": 0.05,    //扫光长度。
  "speed": 0.05      //扫光速度。
}
      播放所有模型动画 播放所有模型动画，不需要参数。
      停止所有模型动画 停止所有模型动画，不需要参数。
      播放模型动画 通过动画名称，播放指定模型动画。
      停止模型动画 通过动画名称，停止指定模型动画。
      展开模型 展开模型，动作传入数据为object类型，包含的字段有模型分组id、偏移量、偏移方向和持续时间。
      分组展开模型 分组展开模型，动作传入数据为array类型，包含的字段有模型分组id、偏移量、偏移方向和持续时间。
      复原展开模型 复原展开模型，不需要参数。
      初始化路径动画 初始化设置路径动画数据并播放动画。动作传入数据为object类型，包含路径、动画时间、是否循环、曲线张力和显示路径字段。
      开始路径动画 从头开始播放路径动画，不需要参数。
      终止路径动画 终止播放路径动画，不需要参数。
      继续路径动画 路径动画从暂停处继续播放，不需要参数。
      暂停路径动画 暂停路径动画，可以继续播放，不需要参数。