UserGameSettings 는 UserSettings 싱글 중에 있는 클래스입니다. 여기에는 사용자가 카메라를 제어하고 캐릭터를 제어하는 방법과 관련된 다양한 지속 설정이 있습니다.
이 개체에 액세스하려면 LocalScript 을 통해 다음을 통해 액세스할 수 있습니다.
UserSettings():GetService("UserGameSettings")
이 개체는 서버에서 사용하기 위한 것이 아니므로 클라이언트에서만 사용해야 합니다. Roblox Studio에서 테스트할 때 자신의 설정을 반영하기도 합니다.
코드 샘플
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 사이의 부동 소수점입니다.A float between 0 and 1 representing the volume of the game's client.
클라이언트의 카메라 민감도를 나타내는 0에서 4 사이의 플롯.
클라이언트의 캐릭터가 어떻게 회전되는지 제어합니다.
클라이언트가 지정한 그래픽 품질 수준입니다.
모바일 기기사용 중인 카메라 유형.
모바일 기기클라이언트가 사용하는 컨트롤 유형입니다.
메서드
카메라의 Y 인버트 값을 반환합니다.
탑승 절차가 완료되었는지 여부를 확인합니다.
사용자의 Roblox 창이 전체 화면 모드인 경우 트루를 반환합니다.
클라이언트의 게임 세션이 Roblox Studio에 있는 경우 트루를 반환합니다.
호출되면 Roblox는 사용자의 카메라 축을 뒤집기 위해 메뉴 옵션을 전환합니다.
호출되면 Roblox는 게임 패드에서 카메라 민감도를 조정하기 위해 메뉴 옵션을 전환합니다.
보드링을 완료로 설정합니다.
이벤트
사용자의 전체 화면 모드가 변경된 경우 화면을 켜줍니다.
사용자의 클라이언트가 스튜디오 모드와 게임 모드를 전환할 때 발생합니다. 세션이 시작되면 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만 수락하며, 플레이어가 동적 썸바 컨트롤 스키마의 튜토리얼을 완료했는지 여부를 지속적으로 추적하는 데 사용됩니다. 보딩Id가 아닌 ID가 하나 이상 있으면 오류가 발생합니다.
인보딩 프로세스는 하나의 방향입니다. 즉, 개발자로서 인보딩 프로세스를 완료하지만 재설정할 수는 없습니다.
또한 참조하십시오.
- UserGameSettings:GetOnboardingCompleted() , 보드링을 완료했는지 여부를 확인합니다
매개 변수
완료로 설정할 ID입니다.
반환
이벤트
FullscreenChanged
사용자의 전체 화면 모드가 변경되면 이벤트가 발생합니다. 이벤트는 전체 화면 모드를 전환할 수 있는 컴퓨터 장치에서만 발생합니다. 게임은 항상 모바일 장치 및 콘솔에서 전체 화면 모드로 전환됩니다.
매개 변수
코드 샘플
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
사용자의 클라이언트가 스튜디오 모드와 게임 모드를 전환할 때 발생합니다. 세션이 시작되면 Roblox Studio에서 주기적으로 발생합니다.