功能概述

3D场景支持两种漫游动画，基于数据点的漫游动画和基于路径的漫游动画。

1. 数据点漫游动画

在3D场景中添加数据图层之后，会有部分的模型节点产生数据绑定，数据点漫游就是轮流聚焦这些模型节点，生成动画。

下图是设置了数据点漫游后的效果，场景轮流聚焦数据图层模型节点，并进行高亮显示。

1.1 场景数据点漫游设定

可以设置聚焦时的相机角度、距离、移动动画时间和相机停滞时间。

• 相机Alpha弧度：指的是水平方向的旋转弧度；

• 相机Beta弧度：指的是垂直方向的旋转弧度，范围为0.01到1.57；

• 相机距离：指的是相机到模型的距离，范围为0到500。

• 移动画面时间：画面移动所花费的时间，数据越小画面移动越快。

• 相机停滞时间：画面聚焦到某一个模型上，停留的时间。数据越大，停留时间越长。

设置后，场景中各个模型节点默认继承该设置。

1.2 节点漫游设定

模型节点上也可以设定自定义的相机设置，设置后以模型节点中的设置为准。

选中模型节点，可以直接输入数据，点击预览相机位置 ；

也可以在画布中拖动模型，角度合适后点击应用编辑器相机位置 。此时数据也会显示在属性设置中。

• Alpha弧度：指的是水平方向的旋转弧度；

• Beta弧度：指的是垂直方向的旋转弧度，范围为0.01到1.57；

• 距离：指的是相机到模型的距离，范围为0到500。

type=info

提示

设置的数据不仅对轮播时聚焦有效，对手动聚焦模型节点时也有效。

2. 路径漫游

路径漫游是指通过添加多个相机视点来形成一个漫游路径。

2.1 添加漫游路径

2.2 漫游路径设定

• 名称：指定动画的名称，这个名称会在自定义脚本或者仪表板端使用。

• 移动时间：当前视点移动到下一个视点的时间

• 停留时间：在每一个相机视点上的停留时间

• 相机视点列表：每一个特定的相机视点，通过画面上视角的改变，来增加当前视角到列表中去，支持上下移动。

点击确定，完成路径的设定。

2.3 漫游路径预览

添加完成漫游路径之后，点击预览按钮进行动画预览。

3. 如何开启漫游动画

提供了两种方式开启漫游动画：

3.1 在3D场景中开启

3D场景支持在自定义脚本中开启漫游动画，sceneData上增加了对应的接口：

interface sceneData{
     //path travel
     playPathTravel(pathTravelName:string, loopMode:LoopMode)
     switchPathTravel()
     stopPathTravel()
 
     //data points travel
     playDataPointsTravel(loopMode?:LoopMode)
     switchDataPointsTravel()
     stopDataPointsTravel()
}
enum LoopMode{
  'once', //travel only runs once
  'repeat',//travel repeat
}

在执行的时候，可以通过 loopMode 参数 决定执行一次，还是重复执行。，

脚本执行时机

• 数据点漫游动画：数据点漫游动画必须在数据点加载完成后执行，否则会找不到数据点。

• 路径漫游动画：在场景模型加载完成就可以执行。

3.2 在仪表板中开启

在仪表板中提供了新的命令

• 3D场景数据点漫游

• 3D场景路径漫游

通过按钮或者图片组件可以绑定3D场景的漫游命令，来开启，暂停或者关闭漫游动画。