[]
        
在线Demo 免费试用
(Showing Draft Content)

漫游动画

1. 概述

1.1功能概述

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

2. 操作步骤

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

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

轮播效果

2.1 场景数据点漫游设定

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

    属性

    说明

    相机Alpha弧度

    指的是水平方向的旋转弧度

    相机Beta弧度

    指的是垂直方向的旋转弧度,范围为0.01到1.57

    相机距离

    指的是相机到模型的距离,范围为0到500

    移动画面时间

    画面移动所花费的时间,数据越小画面移动越快

    相机停滞时间

    画面聚焦到某一个模型上,停留的时间。数据越大,停留时间越长

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

    image

2.2 节点漫游设定

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

  1. 选中模型节点,可以直接输入数据,单击预览相机位置 ;也可以在画布中拖动模型,角度合适后点击应用编辑器相机位置 。此时数据也会显示在属性设置中。

    属性

    说明

    Alpha弧度

    指的是水平方向的旋转弧度

    Beta弧度

    指的是垂直方向的旋转弧度,范围为0.01到1.57

    距离

    指的是相机到模型的距离,范围为0到500

    image

    type=info

    提示

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

    image

3. 路径漫游

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

image

3.1 添加漫游路径

  1. 单击路径漫游属性后的添加项目即可添加漫游路径设定。设置完成后单击确定,完成路径的设定。

    image

    属性

    说明

    名称

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

    移动时间

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

    停留时间

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

    相机视点列表

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

3.2 漫游路径预览

  1. 添加完成漫游路径之后,单击预览按钮进行动画预览。

    image

4. 如何开启漫游动画

系统提供了两种方式开启漫游动画:

4.1 在3D场景中开启

  1. 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
    }
  2. 在执行的时候,可以通过 loopMode 参数 决定执行一次,还是重复执行。,

    image

  • 脚本执行时机:

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

      image

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

4.2 在仪表板中开启

  1. 仪表板的鼠标左键选项的命令属性提供了新的命令:3D场景数据点漫游和3D场景路径漫游

    PixPin_2025-06-09_17-11-35

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

    PixPin_2025-06-09_17-12-37