Skip to content

相机、轨迹与地图节点

这组节点用于镜头切换、曲线路径、对象运动和地图场景。

Set Camera View

将活动相机切换到保存视角,也可以设置过渡时间。

输入说明
trigger开始切换
uuid可选的相机对象;留空使用活动相机
matrix保存的视角矩阵
time过渡时间
fov透视视角大小
near / far相机近远裁剪范围
done切换完成

建议通过编辑器的视角捕获能力保存视角,不要手工填写矩阵。

相机曲线

Set Camera Curve Pose

把相机设置到曲线 0–1 的指定进度,适合滑块控制或分段预览。

主要参数包括曲线识别码、进度、观察方式、目标对象和前视距离。

Play Camera Curve

按指定时长播放完整相机曲线。

参数说明
curveId曲线对象识别码
duration播放秒数
lookMode沿切线、看向指定点或跟随对象
easing线性或缓入缓出
loop是否循环
started / done开始和完成事件

对象沿曲线运动

Set Object Curve Proportion

让一个对象沿指定曲线移动。可设置目标对象、曲线、0–1 进度、持续时间和循环。

Object Track Curve Spawn

连续复制源对象,并让副本沿曲线运动。

常用参数:

  • sourceUuid:源对象;
  • curveId:运动曲线;
  • duration:每个副本完成一次运动的时长;
  • interval:生成间隔;
  • count:生成数量;
  • mode:生成模式;
  • look:是否沿路径朝向;
  • startT / endT:运动区间;
  • offset:位置偏移。

Object Track Curve Trigger Spawn

每次收到 trigger 时生成一个运动副本,适合按事件创建车辆、物料或演示对象。Max Active 用于限制同时存在的副本数量。

地图节点

Fly from → to

将地图视角飞行到目标经纬度。可设置起点、终点、缩放级别、俯仰角、方位角和时长,并通过 onFlyEnd 继续流程。

Add World Marker

在指定经纬度添加地图标记。可以使用 [lng, lat]、分别填写经纬度或传入选项对象。

Object Fly (arc)

让 3D 对象在地图两个位置之间沿弧线飞行。可设置对象、起止经纬度、时长和弧线高度,完成后输出 onFlyEnd

经纬度顺序

地图坐标通常使用 [经度, 纬度],不要与 [纬度, 经度] 混淆。先用短距离测试确认位置正确。

让 3D 内容更容易创建、管理、展示与交付。