Roblox Studio中Camera系统的Viewport Frame无法显示求助

你的脚本存在几个关键问题，导致ViewportFrame无法正常显示，以下是具体分析和修复：

1. 错误操作StarterGui而非PlayerGui #

StarterGui是UI的模板容器，仅在玩家刚加入游戏时，其中的内容会复制到PlayerGui。运行时修改StarterGui不会对当前玩家的显示UI产生任何影响，必须操作game.Players.LocalPlayer.PlayerGui：

local player = game.Players.LocalPlayer
local playerGui = player.PlayerGui
-- 后续所有UI操作都基于playerGui，而非game.StarterGui

2. 遍历地图对象时的逻辑错误 #

你的循环中遇到Sound类对象就直接return，这会导致循环提前终止，后续的地图对象都不会被克隆到WorldModel中。应该改为跳过当前对象，继续遍历：

for _, minimapObjects in pairs(game.Workspace.Map:GetChildren()) do
    if minimapObjects:IsA("Sound") or minimapObjects:IsA("SoundGroup") or minimapObjects:IsA("SoundEffect") then
        continue -- 跳过当前对象，继续循环
    end
    minimapObjects:Clone().Parent = model
end

注：如果你的Roblox Lua版本不支持continue，可以用else包裹克隆逻辑：

for _, minimapObjects in pairs(game.Workspace.Map:GetChildren()) do
    if not (minimapObjects:IsA("Sound") or minimapObjects:IsA("SoundGroup") or minimapObjects:IsA("SoundEffect")) then
        minimapObjects:Clone().Parent = model
    end
end

3. 未清理重复的RenderStepped连接 #

每次点击按钮都会创建一个新的RenderStepped连接，未断开旧连接会导致内存泄漏，甚至相机位置更新异常。需要保存连接引用，切换相机时断开：

-- 在函数外部保存连接变量
local camConnection = nil

local function onCameraEvent(cameraName)
    -- ...其他代码...

    -- 先断开旧连接
    if camConnection then
        camConnection:Disconnect()
        camConnection = nil
    end

    -- 创建新连接
    camConnection = game.RunService.RenderStepped:Connect(function()
        local camFr = game.Workspace.Cameras[cameraName].CFrame
        cam.CFrame = camFr
    end)
end

4. 额外排查点 #

• 确认脚本是LocalScript，且放置在PlayerGui、StarterPlayerScripts或StarterCharacterScripts中（只有LocalScript能访问PlayerGui和RenderStepped）。
• 检查SurfaceGui的属性：
  • Adornee是否正确绑定到Workspace中的部件
  • Enabled是否设为true
  • Face是否设置为正确的部件表面（如Front、Top）
  • Size是否足够显示ViewportFrame
• 检查ViewportFrame的属性：
  • Size、Position是否未被其他UI遮挡
  • BackgroundTransparency是否设为合理值
  • CurrentCamera是否正确指向创建的Camera对象

修复后的完整脚本示例 #

local player = game.Players.LocalPlayer
local playerGui = player.PlayerGui
local runService = game.RunService

local camConnection = nil

local function onCameraEvent(cameraName)
    print("Clicked")
    local camerasFolder = playerGui.CamerasUI.Cameras

    -- 处理其他ViewportFrame
    for _, child in pairs(camerasFolder:GetChildren()) do
        if child.Name ~= cameraName then
            child.Visible = false
            -- 清理后代
            for _, descendant in pairs(child:GetDescendants()) do
                descendant:Destroy()
            end
        end
    end

    local targetViewport = camerasFolder[cameraName]
    targetViewport.Visible = true

    -- 创建相机
    local cam = Instance.new("Camera")
    cam.Name = "Cam"
    cam.CameraType = Enum.CameraType.Scriptable
    cam.FieldOfView = 70
    cam.Parent = targetViewport
    targetViewport.CurrentCamera = cam

    -- 创建WorldModel并克隆地图
    local model = Instance.new("WorldModel")
    model.Name = "World Model"
    model.Parent = targetViewport

    for _, minimapObjects in pairs(game.Workspace.Map:GetChildren()) do
        if minimapObjects:IsA("Sound") or minimapObjects:IsA("SoundGroup") or minimapObjects:IsA("SoundEffect") then
            continue
        end
        minimapObjects:Clone().Parent = model
    end

    -- 断开旧连接，创建新的相机位置同步
    if camConnection then
        camConnection:Disconnect()
        camConnection = nil
    end

    local camPart = game.Workspace.Cameras:WaitForChild(cameraName)
    camConnection = runService.RenderStepped:Connect(function()
        cam.CFrame = camPart.CFrame
    end)
end

内容的提问来源于stack exchange，提问作者Craexz