CameraService

Camera 相机服务，提供编辑器视角属性的读取与设置。

Overview

相机服务，用于读取和设置当前编辑视角的相机属性，例如视野角度、位置与朝向等。通过统一的属性表结构，脚本可以获取相机当前参数、修改后一次性写回，实现视角控制或参数恢复。

Get by:

-- @runtime client
local service = editor:GetService("Camera")

Public

GetCameraProperties

获取当前编辑器相机的属性映射。

返回值

类型	说明
Table	当前相机属性；无可用相机数据时返回空表。

读取当前相机属性

-- @runtime client
local camera = editor:GetService("Camera")
local properties = camera:GetCameraProperties()
print("当前视场角:", properties["CameraFov"])

SetCameraProperties

批量设置当前编辑器相机属性。属性字段和值应来自当前版本 GetCameraProperties() 返回的映射。

参数

参数	类型	说明
properties	Table	要更新的相机属性映射。

使用普通 Table 更新相机属性

-- @runtime client
local camera = editor:GetService("Camera")
local current = camera:GetCameraProperties()
-- 返回映射是只读对象；传入新的普通 Table，并复用当前值避免改变场景
camera:SetCameraProperties({ CameraFov = current["CameraFov"] })