사용자 게임 설정은 단일 클래스로, UserSettings 단일 내에서 찾을 수 있습니다.사용자가 카메라와 캐릭터를 제어하는 방법과 관련된 다양한 영구 설정을 보유합니다.
이 개체에 액세스할 수 있는 방법은 다음과 같습니다. LocalScript를 통해:
이 개체는 서버에서 목적이 없기 때문에 클라이언트에서만 사용되도록 의도되었습니다.Roblox Studio에서 테스트할 때 자신의 설정도 반영됩니다.
코드 샘플
A basic example that shows how you can listen to changes in the user's settings. With this code pasted into a LocalScript running in the StarterPlayerScripts, you can change settings in Roblox's game menu, and see their values appear in the output as detected changes.
local gameSettings = UserSettings().GameSettings
local function onGameSettingChanged(nameOfSetting)
-- Fetch the value of this setting through a pcall to make sure we can retrieve it.
-- Sometimes the event fires with properties that LocalScripts can't access.
local canGetSetting, setting = pcall(function()
return gameSettings[nameOfSetting]
end)
if canGetSetting then
print("Your " .. nameOfSetting .. " has changed to: " .. tostring(setting))
end
end
gameSettings.Changed:Connect(onGameSettingChanged)요약
속성
현재 데스크톱에서 클라이언트가 사용하는 카메라 이동 모드.
클라이언트가 데스크톱에서 사용하는 컨트롤 유형.
클라이언트가 마우스 잠금 스위치 모드를 사용할 수 있는지 여부를 전환합니다.
게임패드를 사용할 때 카메라가 얼마나 민감한지 설명합니다.
게임 클라이언트의 용량을 나타내는 0과 1 사이의 부동 소수점입니다.
클라이언트 카메라 감도의 민감도를 나타내는 0에서 4 사이의 부동 소수점입니다.
클라이언트의 문자가 회전되는 방식을 제어합니다.
클라이언트에서 설정한 그래픽 품질 수준입니다.
모바일 기기클라이언트가 사용하는 카메라 유형.
모바일 기기클라이언트가 사용하는 컨트롤 유형.
메서드
카메라의 Y-인버트 값을 반환합니다.
온보딩이 완료되었는지 확인합니다.
사용자의 Roblox 창이 전체 화면 모드에 있으면 true를 반환합니다.
클라이언트의 게임 세션이 Roblox Studio에 있는 경우 true를 반환합니다.
호출되면 Roblox는 메뉴 옵션을 토글하여 사용자의 카메라 축을 반전합니다.
호출되면 Roblox는 메뉴 옵션을 전환하여 게임패드로 카메라 감도를 제어합니다.
온보딩을 완료로 설정합니다.
이벤트
사용자의 전체 화면 모드가 변경되면 발화합니다.
사용자의 클라이언트가 Studio 모드와 게임 모드 사이를 전환할 때 발생합니다. 세션이 시작될 때 Roblox Studio에서 주기적으로 발생합니다.
속성
AllTutorialsDisabled
CameraMode
ChatVisible
Fullscreen
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
메서드
GetOnboardingCompleted
지정된 온보딩이 아직 완료되지 않았는지 확인하여 온보딩 애니메이션을 다시 표시하지 않도록 합니다.
onboardingId가 허용된 ID 중 하나가 아니면 오류가 발생합니다.
온보딩 프로세스는 일방적입니다. 즉, 개발자로서 온보딩 프로세스를 완료하도록 강제할 수는 있지만 재설정할 수는 없습니다.
참조하세요:
- UserGameSettings:SetOnboardingCompleted() , 온보딩을 완료로 설정
매개 변수
조사할 ID 온보딩.
반환
특정 온보딩이 아직 완료되었는지 여부.
SetCameraYInvertVisible
호출되면 Roblox는 메뉴 옵션을 토글하여 사용자의 카메라 축을 반전합니다.
반환
SetGamepadCameraSensitivityVisible
호출되면 Roblox는 메뉴 옵션을 전환하여 게임패드로 카메라 감도를 제어합니다.
반환
SetOnboardingCompleted
제공된 온보딩을 완료로 설정하여 다음에 플레이할 때 사용자에게 다시 표시되지 않습니다.
현재 이 함수는 DynamicThumbstick만 받으며, 플레이어가 동적 썸브닉 컨트롤 스키마에 대한 튜토리얼을 완료했는지 지속적으로 추적하는 데 사용됩니다.onboardingId가 허용된 ID 중 하나가 아니면 오류가 발생합니다.
온보딩 프로세스는 일방적입니다. 즉, 개발자로서 온보딩 프로세스를 완료하도록 강제할 수는 있지만 재설정할 수는 없습니다.
참조하세요:
- UserGameSettings:GetOnboardingCompleted() , 온보딩이 완료되었는지 확인
매개 변수
완료로 설정할 ID 온보딩.
반환
이벤트
FullscreenChanged
사용자의 전체 화면 모드가 변경되면 발화합니다.이벤트는 전체 화면 모드를 전환할 수 있는 데스크톱 장치에서만 발생합니다.게임은 모바일 장치와 콘솔에서 항상 전체 화면으로 표시됩니다.
매개 변수
코드 샘플
A LocalScript that demonstrates how you can detect whether a game is in full screen or not.
local gameSettings = UserSettings().GameSettings
local function checkFullScreenMode()
local inFullscreen = gameSettings:InFullScreen()
if inFullscreen then
print("Full Screen mode enabled!")
else
print("Full Screen mode disabled!")
end
end
checkFullScreenMode()
gameSettings.FullscreenChanged:Connect(checkFullScreenMode)StudioModeChanged
사용자의 클라이언트가 Studio 모드와 게임 모드 사이를 전환할 때 발생합니다. 세션이 시작될 때 Roblox Studio에서 주기적으로 발생합니다.