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.
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.
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 ruchu kamery obecnie używany przez klienta na pulpicie komputer stacjonarny.
Typ kontroli używanych przez klienta na pulpicie komputer stacjonarny.
Przełącza, czy klient może korzystać z trybu blokady myszy, czy nie.
Opisuje, jak czuła jest kamera podczas używania gamepada.
Pływ pomiędzy 0 a 1 reprezentujący objętość klienta gra
Pływ między 0 a 4 reprezentujący czułość wrażliwości kamery klienta.
Kontroluje, w jaki sposób obrócony jest charakter klienta.
Poziom jakości grafiki ustawiony przez klienta.
Typ kamery używany przez klienta podczas korzystania z urządzeniemobilnego.
Typ kontroli używanych przez klienta na urządzeniemobilnym.
Metody
Zwraca wartość Y-invert kamery.
Sprawdza, czy wdrożenie zostało zakończone.
Wyświetla prawdę, jeśli okno Roblox użytkownika jest w trybie pełnego ekranu.
Zwraca prawdę, jeśli sesja gry klienta jest w Roblox Studio.
Jeśli zostanie wezwany, Roblox przełącza opcję menu, aby odwrócić osi kamery użytkownika.
Jeśli zostanie wezwany, Roblox przełącza opcję menu, aby kontrolować czułość kamery za pomocą gamepadów.
Ustawia wdrożenie jako zakończone.
Zdarzenia
Wypala, jeśli zmieniony zostanie pełnoekranowy tryb użytkownika.
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.
Właściwości
AllTutorialsDisabled
CameraMode
ChatVisible
ComputerCameraMovementMode
Tryb ruchu kamery obecnie używany przez klienta na pulpicie komputer stacjonarny.
ComputerMovementMode
Typ kontroli używanych przez klienta na pulpicie komputer stacjonarny.
Fullscreen
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
Typ kamery używany przez klienta podczas korzystania z urządzeniemobilnego.
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
Metody
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:
- UserGameSettings:SetOnboardingCompleted() , ustawia wdrożenie jako zakończone
Parametry
ID wdrożenia do zapytania.
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
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:
- UserGameSettings:GetOnboardingCompleted() , sprawdza, czy wdrożenie zostało zakończone
Parametry
ID wdrożenia do ustawienia jako zakończone.
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
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
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.