UserGameSettings

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Brak możliwości tworzenia
Ustawienia użytkownika
Bez replikacji

Ustawienia gry użytkownika są klasą jedyną, znalezioną w środku singletonu UserSettings.Zawiera różne trwałe ustawienia dotyczące sposobu, w jaki użytkownik chce kontrolować swoją kamerę i ich postać.

Możesz uzyskać dostęp do tego obiektu z LocalScript


UserSettings():GetService("UserGameSettings")

Ten obiekt jest przeznaczony do użycia tylko na klientzie, ponieważ nie służy żadnemu celowi na serwerze.Odbije to także twoje własne ustawienia podczas testowania w Roblox Studio.

Przykłady kodu

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.

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)

Podsumowanie

Właściwości

Metody

Zdarzenia

Właściwości

AllTutorialsDisabled

Zabezpieczenia skryptów Roblox
Odczyt równoległy
Zabezpieczenia skryptów Roblox
Odczyt równoległy

ChatVisible

Zabezpieczenia skryptów Roblox
Odczyt równoległy

ComputerCameraMovementMode

Odczyt równoległy

Tryb ruchu kamery obecnie używany przez klienta na pulpicie komputer stacjonarny.

ComputerMovementMode

Odczyt równoległy

Typ kontroli używanych przez klienta na pulpicie komputer stacjonarny.

ControlMode

Odczyt równoległy

Przełącza, czy klient może korzystać z trybu blokady myszy, czy nie.

Fullscreen

Zabezpieczenia skryptów Roblox
Odczyt równoległy

GamepadCameraSensitivity

Odczyt równoległy

Opisuje, jak czuła jest kamera podczas używania gamepada.

GraphicsOptimizationMode

Zabezpieczenia skryptów Roblox
Odczyt równoległy

GraphicsQualityLevel

Zabezpieczenia skryptów Roblox
Odczyt równoległy

HasEverUsedVR

Zabezpieczenia skryptów Roblox
Odczyt równoległy

MasterVolume

Zabezpieczenia skryptów Roblox
Odczyt równoległy

A pływanie między 0 a 1 reprezentujące objętość klienta gra

MasterVolumeStudio

Zabezpieczenia skryptów Roblox
Odczyt równoległy

MaxQualityEnabled

Zabezpieczenia skryptów Roblox
Odczyt równoległy

MouseSensitivity

Odczyt równoległy

Pływ między 0 a 4 reprezentujący czułość wrażliwości kamery klienta.

OnboardingsCompleted

Zabezpieczenia skryptów Roblox
Odczyt równoległy

PartyVoiceVolume

Zabezpieczenia skryptów Roblox
Odczyt równoległy

RCCProfilerRecordFrameRate

Odczyt równoległy

RCCProfilerRecordTimeFrame

Odczyt równoległy

RotationType

Odczyt równoległy

Kontroluje, w jaki sposób obrócony jest charakter klienta.

SavedQualityLevel

Odczyt równoległy

Poziom jakości grafiki ustawiony przez klienta.

StartMaximized

Bez replikacji
Brak możliwości dodawania do skryptu
Zabezpieczenia skryptów Roblox
Odczyt równoległy

StartScreenPosition

Bez replikacji
Brak możliwości dodawania do skryptu
Zabezpieczenia skryptów Roblox
Odczyt równoległy

StartScreenSize

Bez replikacji
Brak możliwości dodawania do skryptu
Zabezpieczenia skryptów Roblox
Odczyt równoległy

TouchCameraMovementMode

Odczyt równoległy

Typ kamery używany przez klienta podczas korzystania z urządzeniemobilnego.

TouchMovementMode

Odczyt równoległy

Typ kontroli używanych przez klienta na urządzeniemobilnym.

UsedCoreGuiIsVisibleToggle

Zabezpieczenia skryptów Roblox
Odczyt równoległy

UsedCustomGuiIsVisibleToggle

Zabezpieczenia skryptów Roblox
Odczyt równoległy

UsedHideHudShortcut

Zabezpieczenia skryptów Roblox
Odczyt równoległy

VREnabled

Zabezpieczenia skryptów Roblox
Odczyt równoległy

VRRotationIntensity

Zabezpieczenia skryptów Roblox
Odczyt równoległy

VRSmoothRotationEnabled

Zabezpieczenia skryptów Roblox
Odczyt równoległy

VignetteEnabled

Zabezpieczenia skryptów Roblox
Odczyt równoległy

Metody

GetCameraYInvertValue

Zwraca wartość Y-invert kamery.


Zwroty

GetOnboardingCompleted

Sprawdza, czy dane wdrożenie zostało jeszcze zakończone, co jest przydatne do uniknięcia ponownego wyświetlania animacji wdrożenia.

Jeśli onboardingId nie jest jednym z akceptowanych ID, wystąpi błąd.

Proces wdrożenia jest jednostronny. Oznacza to, że jako programista możesz zmusić proces wdrożenia do zakończenia, ale nie możesz go zresetować.

Zobacz także:

Parametry

onboardingId: string

ID wdrożenia do zapytania.

Wartość domyślna: ""

Zwroty

Czy szkolenie w szczególności zostało jeszcze zakończone, czy nie.

InFullScreen

Wyświetla prawdę, jeśli okno Roblox użytkownika jest w trybie pełnego ekranu.


Zwroty

InStudioMode

Zwraca prawdę, jeśli sesja gry klienta jest w Roblox Studio.


Zwroty

SetCameraYInvertVisible

()

Jeśli zostanie wezwany, Roblox przełącza opcję menu, aby odwrócić osi kamery użytkownika.


Zwroty

()

SetGamepadCameraSensitivityVisible

()

Jeśli zostanie wezwany, Roblox przełącza opcję menu, aby kontrolować czułość kamery za pomocą gamepadów.


Zwroty

()

SetOnboardingCompleted

()

Ustawia wdrożenie podane jako zakończone, więc nie zostanie ponownie pokazane użytkownikowi następnym razem, gdy grać.

Obecnie ta funkcja akceptuje tylko Dynamiczny Thumbstick, i jest używana do trwałego śledzenia, czy gracz zakończył samouczek dla schematu kontroli Dynamicznego Thumbsticka.Jeśli onboardingId nie jest jednym z akceptowanych ID, wystąpi błąd.

Proces wdrożenia jest jednostronny. Oznacza to, że jako programista możesz zmusić proces wdrożenia do zakończenia, ale nie możesz go zresetować.

Zobacz także:

Parametry

onboardingId: string

ID wdrożenia do ustawienia jako zakończone.

Wartość domyślna: ""

Zwroty

()

Zdarzenia

FullscreenChanged

Wypala, jeśli zmieniony zostanie pełnoekranowy tryb użytkownika.Wydarzenie będzie uruchamiane tylko na urządzeniach desktopowych, które mogą przełączać tryb pełnego ekranu.Gra zawsze będzie w pełnym ekranie na urządzeniach mobilnych i konsolach.

Parametry

isFullscreen: boolean

Przykłady kodu

A LocalScript that demonstrates how you can detect whether a game is in full screen or not.

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

Wysyłany, gdy klient użytkownika przełącza się między trybem Studio a trybem w grze. To się zdarza okresowo w Roblox Studio, gdy rozpoczyna się sesja.

Parametry

isStudioMode: boolean