用途:在 Decentraland 场景中控制相机行为,涉及 CameraMode、CameraModeArea、VirtualCamera、MainCamera 以及相机与碰撞体的交互。
主要能力:读取 engine.CameraEntity 的位置与旋转(只读);用 CameraMode 判断第一/第三人称,并可用 CameraMode.onChange 监听切换;用 CameraModeArea 在指定区域内强制视角(离开后恢复偏好模式);用 VirtualCamera 配合 MainCamera.virtualCameraEntity 创建过场或特殊视角,支持 Speed/Time 过渡、lookAtEntity 跟踪目标、可选 fov 视野参数。
使用方式:创建实体并添加相应组件,通过 MainCamera.createOrReplace 绑定虚拟相机,用 getMutableOrNull 切换或置为 undefined 返回普通视角。虚拟相机每帧驱动其 Transform 即可移动视角;停用时先清空绑定,延迟约 1 秒再删除实体。Creator Hub 提供 CameraModeArea 检查面板与 Camera Modifier Area 智能物品。
限制:不能直接移动玩家真实相机;同时只有一个 VirtualCamera 生效;移动端 screenDelta 始终为 0,鼠标视角仅限桌面;引擎会在包裹边界外禁用虚拟相机。碰撞方面,需同时为实体指定 CL_PHYSICS 与 CL_POINTER 层才能阻止第三人称相机穿墙。