外观
相机、轨迹与地图节点
这组节点用于镜头切换、曲线路径、对象运动和地图场景。
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。
经纬度顺序
地图坐标通常使用 [经度, 纬度],不要与 [纬度, 经度] 混淆。先用短距离测试确认位置正确。