UserGameSettings

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
사용자 설정

UserGameSettings 는 UserSettings 싱글 중에 있는 클래스입니다. 여기에는 사용자가 카메라를 제어하고 캐릭터를 제어하는 방법과 관련된 다양한 지속 설정이 있습니다.

이 개체에 액세스하려면 LocalScript 을 통해 다음을 통해 액세스할 수 있습니다.


UserSettings():GetService("UserGameSettings")

이 개체는 서버에서 사용하기 위한 것이 아니므로 클라이언트에서만 사용해야 합니다. Roblox Studio에서 테스트할 때 자신의 설정을 반영하기도 합니다.

코드 샘플

UserGameSettings Listener

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)

요약

속성

메서드

이벤트

  • 사용자의 전체 화면 모드가 변경된 경우 화면을 켜줍니다.

  • 사용자의 클라이언트가 스튜디오 모드와 게임 모드를 전환할 때 발생합니다. 세션이 시작되면 Roblox Studio에서 주기적으로 발생합니다.

속성

AllTutorialsDisabled

병렬 읽기
Roblox 스크립트 보안
병렬 읽기
Roblox 스크립트 보안

ChatVisible

병렬 읽기
Roblox 스크립트 보안

ComputerCameraMovementMode

병렬 읽기

현재 클라이언트가 사용하는 카메라 데스크톱모드입니다.

ComputerMovementMode

병렬 읽기

클라이언트가 데스크톱에서 사용하는 컨트롤의 유형입니다.

ControlMode

병렬 읽기

클라이언트가 마우스 잠금 스위치 모드를 사용할 수 있는지 여부를 토글합니다.

Fullscreen

병렬 읽기
Roblox 스크립트 보안

GamepadCameraSensitivity

병렬 읽기

게임 패드를 사용할 때 카메라가 얼마나 민감한지 설명합니다.

GraphicsOptimizationMode

병렬 읽기
Roblox 스크립트 보안

GraphicsQualityLevel

병렬 읽기
Roblox 스크립트 보안

HasEverUsedVR

병렬 읽기
Roblox 스크립트 보안

MasterVolume

병렬 읽기
Roblox 스크립트 보안

게임 클라이언트의 볼륨을 나타내는 플롯 간의 유동 사이.

MasterVolumeStudio

병렬 읽기
Roblox 스크립트 보안

MaxQualityEnabled

병렬 읽기
Roblox 스크립트 보안

MouseSensitivity

병렬 읽기

클라이언트의 카메라 민감도를 나타내는 0에서 4 사이의 플롯.

OnboardingsCompleted

병렬 읽기
Roblox 스크립트 보안

PartyVoiceVolume

병렬 읽기
Roblox 스크립트 보안

RCCProfilerRecordFrameRate

병렬 읽기

RCCProfilerRecordTimeFrame

병렬 읽기

RotationType

병렬 읽기

클라이언트의 캐릭터가 어떻게 회전되는지 제어합니다.

SavedQualityLevel

병렬 읽기

클라이언트가 지정한 그래픽 품질 수준입니다.

StartMaximized

복제되지 않음
스크립팅할 수 없음
병렬 읽기
Roblox 스크립트 보안

StartScreenPosition

복제되지 않음
스크립팅할 수 없음
병렬 읽기
Roblox 스크립트 보안

StartScreenSize

복제되지 않음
스크립팅할 수 없음
병렬 읽기
Roblox 스크립트 보안

TouchCameraMovementMode

병렬 읽기

모바일 기기사용 중인 카메라 유형.

TouchMovementMode

병렬 읽기

모바일 기기클라이언트가 사용하는 컨트롤 유형입니다.

UsedCoreGuiIsVisibleToggle

병렬 읽기
Roblox 스크립트 보안

UsedCustomGuiIsVisibleToggle

병렬 읽기
Roblox 스크립트 보안

UsedHideHudShortcut

병렬 읽기
Roblox 스크립트 보안

VREnabled

병렬 읽기
Roblox 스크립트 보안

VRRotationIntensity

병렬 읽기
Roblox 스크립트 보안

VRSmoothRotationEnabled

병렬 읽기
Roblox 스크립트 보안

VignetteEnabled

병렬 읽기
Roblox 스크립트 보안

메서드

GetCameraYInvertValue

카메라의 Y 인버트 값을 반환합니다.


반환

GetOnboardingCompleted

보드 내 온보딩 애니메이션을 다시 표시하지 않도록 설정하는 데 유용합니다.

onboardingId가 허용되는 ID 중 하나가 아닌 경우 오류가 발생합니다.

인보딩 프로세스는 하나의 방향입니다. 즉, 개발자로서 인보딩 프로세스를 완료하지만 재설정할 수는 없습니다.

또한 참조하십시오.

매개 변수

onboardingId: string

쿼리하려는 탑승 ID입니다.


반환

특정 온보딩이 완료되었는지 여부.

InFullScreen

사용자의 Roblox 창이 전체 화면 모드인 경우 트루를 반환합니다.


반환

InStudioMode

클라이언트의 게임 세션이 Roblox Studio에 있는 경우 트루를 반환합니다.


반환

SetCameraYInvertVisible

void

호출되면 Roblox는 사용자의 카메라 축을 뒤집기 위해 메뉴 옵션을 전환합니다.


반환

void

SetGamepadCameraSensitivityVisible

void

호출되면 Roblox는 게임 패드에서 카메라 민감도를 조정하기 위해 메뉴 옵션을 전환합니다.


반환

void

SetOnboardingCompleted

void

지정된 온보딩을 완료로 설정하므로 다음에 플레이할 때 사용자에게 다시 표시되지 않습니다.

현재 이 함수는 DynamicThumbstick만 수락하며, 플레이어가 동적 썸바 컨트롤 스키마의 튜토리얼을 완료했는지 여부를 지속적으로 추적하는 데 사용됩니다. 보딩Id가 아닌 ID가 하나 이상 있으면 오류가 발생합니다.

인보딩 프로세스는 하나의 방향입니다. 즉, 개발자로서 인보딩 프로세스를 완료하지만 재설정할 수는 없습니다.

또한 참조하십시오.

매개 변수

onboardingId: string

완료로 설정할 ID입니다.


반환

void

이벤트

FullscreenChanged

사용자의 전체 화면 모드가 변경되면 이벤트가 발생합니다. 이벤트는 전체 화면 모드를 전환할 수 있는 컴퓨터 장치에서만 발생합니다. 게임은 항상 모바일 장치 및 콘솔에서 전체 화면 모드로 전환됩니다.

매개 변수

isFullscreen: bool

코드 샘플

Full Screen Mode Detection

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에서 주기적으로 발생합니다.

매개 변수

isStudioMode: bool