模型加载器是城市三维场景构建器的数据映射子组件，支持独立的样式和数据配置，包括模型加载器的动画配置、样式配置和阴影设置等样式配置。模型加载器适用于查看模型数据，如gltf格式的模型。本文介绍模型加载器配置项的含义。

单击子组件管理下方的模型加载器子组件，进入配置面板配置模型加载器子组件的样式和数据。
说明 如果子组件管理中没有模型加载器，说明您还未添加模型加载器子组件，请参见添加子组件进行添加。

配置

模型加载器配置面板
模型加载器配置面板参数说明。
参数 说明
已分配场景 详细功能说明，请参见已分配场景。
模型地址 您可以自定义输入gltf格式模型的URL地址。
动画配置 模型加载器的动画配置样式。
  • 显示骨骼：打开开关，显示模型动画骨骼样式； 关闭开关，不显示动画骨骼。
  • 启动动画：打开开关，开启动画；关闭开关，不启动动画。
  • 默认循环模式：单击下拉框选择动画播放模式，可选重复、一次和反向。
  • 动画速率：拖动滑块调整动画的播放速率，取值范围-1.5~1.5。仅在打开启动动画开关后可以配置。
  • 动作列表：单击右侧的加号图标或垃圾桶图标图标，添加或删除一个动作系列。单击横排列图标或竖排列图标图标配置多个动作系列的排列样式。
    • 动作名：您可以自定义设置动作名的内容，当设置的动作名无效时会启用第一个动作。
    • 循环模式：单击下拉列表，选择动画动作的循环模式，可选重复、一次和反向。
    • 权重：拖动滑块调整动作的权重值，取值范围为0~1。
样式配置 模型加载器的样式配置。
  • 环境贴图：单击环境贴图下拉框选择一个环境贴图样式，可选无、立方体和球形。
  • 环境贴图强度：拖动滑块设置地面的环境贴图强度值，取值范围为0~10。仅在环境贴图样式选择立方体或球形时可配置。
  • 贴图地址nx/ny/nz/px/py/pz：自定义设置从正反面方向分别沿着x/y/z三个方向的贴图的URL地址。仅在环境贴图样式选择立方体时可配置。
  • 贴图地址：自定义设置贴图的URL地址。仅在环境贴图样式选择球形时可配置。
  • 深度测试：打开开关，开启模深度测试样式； 关闭开关，不开启深度测试样式。
  • 显示线框：打开开关，显示线框样式； 关闭开关，不显示线框样式。
  • 透明度：拖动滑块调整模型全局透明度值，取值范围为0~1。
  • X/Y/Z缩放：拖动滑块调整模型沿着X、Y和Z三个方向的缩放值。
阴影设置 设置模型加载器的阴影样式，通过打开或关闭发射阴影和接收阴影的开关加载，控制模型加载器的阴影效果样式。
点击事件 设置模型加载器的点击事件样式。
  • 点击：打开开关，开启单击模型时触发事件的样式； 关闭开关，不开启单击模型触发事件样式。
  • 颜色：仅在打开点击开关时可配置模型内部件被单击后显示的颜色。
爆炸效果 设置模型加载器的爆炸效果样式。
  • 爆炸：打开开关，开启模型加载器的爆炸效果样式；关闭开关，模型加载器不显示爆炸样式效果。
  • 爆炸系数：拖动滑块调整爆炸效果扩散的范围值，取值范围为0~1000。爆炸系数配置项仅在打开爆炸开关后可配置。
切割效果 设置模型加载器的切割效果样式。
  • 切割炸：打开开关，开启模型加载器的切割效果样式；关闭开关，模型加载器不显示切割样式效果。
  • 切割面X/Y/Z：拖动滑块调整切割面X轴、Y轴和Z轴方向坐标的值，取值范围为-1~1。切割面X/Y/Z配置项仅在打开切割开关后可配置。
  • 切割面高度：拖动滑块调整切割面高度的值，取值范围为-1000~1000。切割面高度配置项仅在打开切割开关后可配置。
位置配置 设置模型加载器的位置配置参数。
  • 经度：模型加载器位置的经度。
  • 纬度：模型加载器位置的纬度。
  • 高度：模型加载器位置的高度。
  • X/Y/Z轴旋转：模型加载器沿着X/Y/Z轴方向的旋转角度值。
表 1. 配置项说明
配置项 说明
受控模式 打开开关，组件初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。开关默认为关闭状态。
自动更新请求 选中后可以设置动态轮询，还可以手动输入轮询的时间频次。清除后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源 单击配置数据源，可在设置数据源页面中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置组件数据。
数据过滤器 数据过滤器提供数据结构转换、筛选和一些简单的计算功能。单击添加过滤器，可在设置数据源页面配置数据过滤器脚本，详情请参见组件过滤器使用说明。
数据响应结果 展示数据请求的响应结果。当数据源发生改变时，可单击右侧的刷新图标 图标，实时查看数据响应结果。

数据

数据面板

设置裁剪范围：在数据面板内可以单击下方设置裁剪范围，打开选择子组件对话框，重新选择需要裁剪范围的子组件以及对应的数据范围，详情请参见添加组件并选择场景范围区域。

模型层

url：模型加载器的URL地址。

蓝图编辑器交互配置

  1. 在当前场景编辑器页面，单击左侧子组件管理列表中模型加载器右侧的导出到蓝图编辑器图标。
  2. 鼠标移动到页面左上角的返回图标，单击弹出对话框中的蓝图编辑器。
  3. 在蓝图编辑器配置页面，单击导入节点栏内的模型加载器子组件，在画布中可以看到如下图所示的模型加载器的蓝图编辑器配置参数。组合模型加载器蓝图参数
    • 事件

      模型加载完成：模型加载器模型加载完成时抛出的事件，同时抛出object类型的数据。

    • 动作
      动作 说明
      更新配置 动态更新组件的样式配置。需要先在组件的配置面板中，单击复制配置到剪贴板，获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。
      更新数据 动态更新组件的数据配置，同时传入object类型的数据。
      组件销毁 销毁组件，不需要参数。
      显示组件 显示组件，不需要参数。
      隐藏组件 隐藏组件，不需要参数。
      模型展开 将模型展开。参考数据示例如下。 
      {
  "id": [],        //模型分组ID
  "offset": 0,     //偏移量
  "axisType": "y", //偏移方向
  "duration": 1000 //持续时间
}
      模型分组展开 将模型分组后展开。参考数据示例如下。 
      {
  "id": [],        //模型分组ID
  "offset": 0,     //偏移量
  "axisType": "y", //偏移方向
  "duration": 1000 //持续时间
}
      材质渐变 模型材质渐变。参考数据示例如下。 
      {
  "id": [],          //模型分组ID
  "duration": 1000,  //持续时间
  "options": {       //透明度颜色参数
    "color": "",     //颜色
    "opacity": 1     //透明度
  }
}