UserGameSettings
*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.
The UserGameSettings jest klasą jedynik, znajdującą się w środku singletonu Class.UserSettings. Przechowuje ona różne trwałe ustawienia dotyczące tego, jak użytkownik chce kontrolować swoją kamerę i ich postać.
Możesz uzyskać dostęp do tego obiektu z LocalScript za pośrednictwem:
Ten przedmiot jest przeznaczony tylko dla klienta, ponieważ służy do niczego na serwerze. Będzie również odzwierciedlać 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.
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
Tryb przemieszczania kamery obecnie używany przez klienta na komputer stacjonarny.
Typ sterowania używany przez klienta na komputer stacjonarny.
Przełącza czy klient może używać trybu Ustawienia Zablokowania Myszy.
Opisuje, jak bardzo czuła jest kamera podczas używania gamepada.
Pływająca pomiędzy 0 i 1 reprezentująca głośniki w gra.
Pływająca pomiędzy 0 i 4 reprezentująca czułość czujności kamery klienta.
Kontroluje, jak charakter klienta jest obrócony.
Kwalifikacja jakości grafiki ustawiona przez klienta.
Typ kamery w użyciu przez klienta na urządzeniemobilnym.
Typ sterowania używany przez klienta na urządzeniemobilnym.
Metody
Zwraca wartość Y inwerty kamery.
Sprawdza, czy onboarding został zakończony.
Wróщает prawdę, jeśli okno Roblox'a użytkownika jest w trybie pełnoekranowym.
Wróщает prawdę, jeśli sesja gry klienta jest w Roblox Studio.
Jeśli zostanie wywołany, Roblox przełącza opcję menu, aby znieść eksen o kamerze użytkownika.
Jeśli zostanie wywołany, Roblox przełącza opcję menu, aby kontrolować czułość kamery z użyciem gamepadów.
Ustawia onboarding jako zakończony.
Zdarzenia
Wystrzela, jeśli tryb pełnego ekranu użytkownika jest zmieniony.
Wystrzelony, gdy klient użytkownika przełącza się między trybem studio i trybem w grze. To jest wstrzelane regularnie w Roblox Studio, gdy sesja się rozpoczyna.
Właściwości
AllTutorialsDisabled
CameraMode
ChatVisible
ComputerCameraMovementMode
Tryb przemieszczania kamery obecnie używany przez klienta na komputer stacjonarny.
ComputerMovementMode
Typ sterowania używany przez klienta na komputer stacjonarny.
Fullscreen
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
Typ kamery w użyciu przez klienta na urządzeniemobilnym.
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
Metody
GetOnboardingCompleted
Sprawdza, czy ukończono dane onboarding, które jest użyteczne, aby uniknąć ponownego pokazania animacji onboardingu.
Jeśli onboardingId nie jest jedną z akceptowanych ID, błąd jest rzucany.
Proces onboardingu jest jednokolorowy. Oznacza to, że jako rozwój, możesz zmusić go do ukończenia, ale nie możesz go zresetować.
Zobacz również:
- UserGameSettings:SetOnboardingCompleted() , ustawia onboarding jako zakończony
Parametry
ID onboardingu do zapytania.
Zwroty
Czy w szczególności onboarding został zakończony czy nie.
InFullScreen
Wróщает prawdę, jeśli okno Roblox'a użytkownika jest w trybie pełnoekranowym.
Zwroty
SetCameraYInvertVisible
Jeśli zostanie wywołany, Roblox przełącza opcję menu, aby znieść eksen o kamerze użytkownika.
Zwroty
SetGamepadCameraSensitivityVisible
Jeśli zostanie wywołany, Roblox przełącza opcję menu, aby kontrolować czułość kamery z użyciem gamepadów.
Zwroty
SetOnboardingCompleted
Ustawia onboarding ukończony, więc nie zostanie on ponownie pokazany użytkownikowi następnym razem, gdy grać.
Obecnie ta funkcja akceptuje tylko DynamicThumbstick , a jest używana do trwałego śledzenia, czy gracz zakończył samouczek dla sterowania Dynamic Thumbstick . Jeśli onboardingId nie jest jedną z akceptowanych ID, błąd jest rzucany.
Proces onboardingu jest jednokolorowy. Oznacza to, że jako rozwój, możesz zmusić go do ukończenia, ale nie możesz go zresetować.
Zobacz również:
- UserGameSettings:GetOnboardingCompleted() sprawdza, czy onboarding został zakończony
Parametry
ID onboardingu ustawiony jako ukończony.
Zwroty
Zdarzenia
FullscreenChanged
Wystrzeli, jeśli tryb pełnoekranowy użytkownika zostanie zmieniony. Wydarzenie będzie działać tylko na urządzeniach biurowych, które mogą włączyć tryb pełnoekranowy. gra zawsze będzie w trybie pełnoekranowym na urządzeniach mobilnych i konsolach.
Parametry
Przykłady kodu
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
Wystrzelony, gdy klient użytkownika przełącza się między trybem studio i trybem w grze. To jest wstrzelane regularnie w Roblox Studio, gdy sesja się rozpoczyna.