学习
引擎类
UserGameSettings
无法创建
服务
未复制

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处


概要
继承成员
代码示例
用户游戏设置监听器
local gameSettings = UserSettings().GameSettings
local function onGameSettingChanged(nameOfSetting)
-- 通过 pcall 获取此设置的值,以确保我们可以检索它。
-- 有时事件会在 LocalScripts 无法访问的属性下触发。
local canGetSetting, setting = pcall(function()
return gameSettings[nameOfSetting]
end)
if canGetSetting then
print("您的 " .. nameOfSetting .. " 已更改为: " .. tostring(setting))
end
end
gameSettings.Changed:Connect(onGameSettingChanged)

API 参考
属性
AllTutorialsDisabled
Roblox 脚本安全性
读取并联
UserGameSettings.AllTutorialsDisabled:boolean

BadgeVisible
Roblox 脚本安全性
读取并联
UserGameSettings.BadgeVisible:boolean

CameraMode
Roblox 脚本安全性
读取并联
UserGameSettings.CameraMode:Enum.CustomCameraMode

ChatVisible
Roblox 脚本安全性
读取并联
UserGameSettings.ChatVisible:boolean

ComputerCameraMovementMode
读取并联
功能: Input
UserGameSettings.ComputerCameraMovementMode:Enum.ComputerCameraMovementMode

ComputerMovementMode
读取并联
功能: Input
UserGameSettings.ComputerMovementMode:Enum.ComputerMovementMode

ControlMode
已弃用

Fullscreen
Roblox 脚本安全性
读取并联
UserGameSettings.Fullscreen:boolean

GamepadCameraSensitivity
读取并联
功能: Input
UserGameSettings.GamepadCameraSensitivity:number

GraphicsOptimizationMode
Roblox 脚本安全性
读取并联
UserGameSettings.GraphicsOptimizationMode:Enum.GraphicsOptimizationMode

GraphicsQualityLevel
Roblox 脚本安全性
读取并联
UserGameSettings.GraphicsQualityLevel:number

HasEverUsedVR
Roblox 脚本安全性
读取并联
UserGameSettings.HasEverUsedVR:boolean

MasterVolume
Roblox 脚本安全性
读取并联
UserGameSettings.MasterVolume:number

MasterVolumeStudio
Roblox 脚本安全性
读取并联
UserGameSettings.MasterVolumeStudio:number

MaxQualityEnabled
Roblox 脚本安全性
读取并联
UserGameSettings.MaxQualityEnabled:boolean

MouseSensitivity
读取并联
功能: Input
UserGameSettings.MouseSensitivity:number

OnboardingsCompleted
Roblox 脚本安全性
读取并联
UserGameSettings.OnboardingsCompleted:string

PartyVoiceVolume
Roblox 脚本安全性
读取并联
UserGameSettings.PartyVoiceVolume:number

PeoplePageLayout
Roblox 脚本安全性
读取并联
UserGameSettings.PeoplePageLayout:Enum.PeoplePageLayout

PlayerListVisible
Roblox 脚本安全性
读取并联
UserGameSettings.PlayerListVisible:boolean

PlayerNamesEnabled
Roblox 脚本安全性
读取并联
UserGameSettings.PlayerNamesEnabled:boolean

RCCProfilerRecordFrameRate
读取并联
UserGameSettings.RCCProfilerRecordFrameRate:number

RCCProfilerRecordTimeFrame
读取并联
UserGameSettings.RCCProfilerRecordTimeFrame:number

RotationType
读取并联
功能: Input
UserGameSettings.RotationType:Enum.RotationType

SavedQualityLevel
读取并联
功能: Players
UserGameSettings.SavedQualityLevel:Enum.SavedQualitySetting

StartMaximized
未复制
不可写入脚本
Roblox 脚本安全性
读取并联
UserGameSettings.StartMaximized:boolean

StartScreenPosition
未复制
不可写入脚本
Roblox 脚本安全性
读取并联
UserGameSettings.StartScreenPosition:Vector2

StartScreenSize
未复制
不可写入脚本
Roblox 脚本安全性
读取并联
UserGameSettings.StartScreenSize:Vector2

TouchCameraMovementMode
读取并联
功能: Input
UserGameSettings.TouchCameraMovementMode:Enum.TouchCameraMovementMode

TouchMovementMode
读取并联
功能: Input
UserGameSettings.TouchMovementMode:Enum.TouchMovementMode

UsedCoreGuiIsVisibleToggle
Roblox 脚本安全性
读取并联
UserGameSettings.UsedCoreGuiIsVisibleToggle:boolean

UsedCustomGuiIsVisibleToggle
Roblox 脚本安全性
读取并联
UserGameSettings.UsedCustomGuiIsVisibleToggle:boolean

UsedHideHudShortcut
Roblox 脚本安全性
读取并联
UserGameSettings.UsedHideHudShortcut:boolean

VignetteEnabled
Roblox 脚本安全性
读取并联
UserGameSettings.VignetteEnabled:boolean

VREnabled
Roblox 脚本安全性
读取并联
UserGameSettings.VREnabled:boolean

VRRotationIntensity
Roblox 脚本安全性
读取并联
UserGameSettings.VRRotationIntensity:number

VRSmoothRotationEnabled
Roblox 脚本安全性
读取并联
UserGameSettings.VRSmoothRotationEnabled:boolean

方法
GetCameraYInvertValue
功能: Input
UserGameSettings:GetCameraYInvertValue():number
返回

GetOnboardingCompleted
功能: Players
UserGameSettings:GetOnboardingCompleted(onboardingId:string):boolean
参数
onboardingId:string
返回

InFullScreen
功能: Players
UserGameSettings:InFullScreen():boolean
返回

InStudioMode
功能: Players
UserGameSettings:InStudioMode():boolean
返回

SetCameraYInvertVisible
功能: Input
UserGameSettings:SetCameraYInvertVisible():()
返回
()

SetGamepadCameraSensitivityVisible
功能: Input
UserGameSettings:SetGamepadCameraSensitivityVisible():()
返回
()

SetOnboardingCompleted
功能: Players
UserGameSettings:SetOnboardingCompleted(onboardingId:string):()
参数
onboardingId:string
返回
()

活动
FullscreenChanged
UserGameSettings.FullscreenChanged(isFullscreen:boolean):RBXScriptSignal
参数
isFullscreen:boolean
代码示例
全屏模式检测
local gameSettings = UserSettings().GameSettings
local function checkFullScreenMode()
local inFullscreen = gameSettings:InFullScreen()
if inFullscreen then
print("全屏模式已启用!")
else
print("全屏模式已禁用!")
end
end
checkFullScreenMode()
gameSettings.FullscreenChanged:Connect(checkFullScreenMode)

StudioModeChanged
UserGameSettings.StudioModeChanged(isStudioMode:boolean):RBXScriptSignal
参数
isStudioMode:boolean

©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。