Roblox Camera 技能用于在 Roblox 中编写自定义相机行为,例如过场动画、第三人称跟随、自定义旋转,或操作 CFrame 实现定位与旋转、从屏幕发射射线,以及构建非默认的玩家视角。该技能仅在客户端使用。
一、核心对象与相机类型 workspace.CurrentCamera 每个客户端只有一个。把 CameraType 设置为 Scriptable 可禁用默认行为并完全接管控制;若不设置,默认行为会每帧覆盖你的 CFrame。 CameraType 包括:Fixed、Attach/Watch/Track/Follow(跟随主体)、Custom(默认)、Scriptable(无默认行为)、Orbital(固定 Y 轴、绕玩家旋转)。CameraSubject 不能为 nil,设置为 nil 会被还原。
二、关键属性 CFrame、CameraSubject、FieldOfView(角度)、FieldOfViewMode(Vertical/Diagonal)、NearPlaneZ、ViewportSize、HeadLocked、HeadScale、Focus。
三、CFrame 基础用法(Luau)
- 仅设置位置:CFrame.new(position)
- 朝向目标:CFrame.lookAt(position, target, upVector)
- XYZ 旋转:CFrame.Angles(rx, ry, rz)
- 局部转世界:cf * Vector3.new(0, 0, 10)
- 插值:cf:Lerp(goal, alpha)
- 单位轴:cf.LookVector、cf.RightVector、cf.UpVector
四、自定义相机循环 应始终使用 PreRender,而不要用 Heartbeat:
camera.CameraType = Enum.CameraType.Scriptable RunService.PreRender:Connect(function(dt) local desired = CFrame.lookAt(head.Position - offset, head.Position) camera.CFrame = camera.CFrame:Lerp(desired, math.min(dt * 10, 1)) end)
五、从相机发射射线 camera:ScreenPointToRay(mx, my) 会考虑 GUI 内边距;camera:ViewportPointToRay(mx, my) 为原始坐标、不含内边距。ScreenPointToRay 返回单位射线(长度 1 stud),实际射线检测时需将 Direction 乘以所需长度。
六、常见陷阱
- 仅客户端有效,服务端设置会被静默丢弃。
- 未设为 Scriptable 时,默认行为每帧覆盖你的 CFrame。
- 相机更新用 PreRender(与视觉同步);Heartbeat 会带来 1 帧延迟;RenderStepped 仍可用,但已被 PreRender 取代。
- Camera.CFrame 不包含 VR 头部旋转;真实视角应使用 GetRenderCFrame()。
- SetRoll 已过时;应通过 CFrame.Angles(0, 0, roll) 应用滚转。
- CFrame.new(pos, lookAt) 为遗留用法(仅向后兼容);新代码应使用 CFrame.lookAt(at, lookAt)。
更完整的第一/第三人称示例、过场动画、屏幕震动、鼠标视角与完整 API,见 references/full.md。