UserGameSettings

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Opzioni Utente
Non Replicato

The UserGameSettings è una classe singola trovata all'interno del singolo UserSettings singolo.Contiene varie impostazioni persistenti relative a come l'utente vuole controllare la sua Telecamerae il suo personaggio.

Puoi accedere a questo oggetto da un LocalScript via:


UserSettings():GetService("UserGameSettings")

Questo oggetto è destinato ad essere utilizzato solo sul client, poiché non serve a nessun scopo sul Server.Rifletterà anche le tue impostazioni quando si testa in Roblox Studio.

Campioni di codice

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)

Sommario

Proprietà

Metodi

Eventi

Proprietà

AllTutorialsDisabled

Sicurezza Script Roblox
Lettura Parallela
Sicurezza Script Roblox
Lettura Parallela

ChatVisible

Sicurezza Script Roblox
Lettura Parallela

ComputerCameraMovementMode

Lettura Parallela

La modalità di movimento della fotocamera attualmente in uso dal client sul Desktop.

ComputerMovementMode

Lettura Parallela

Il tipo di controlli utilizzati dal client sul Desktop.

ControlMode

Lettura Parallela

Attiva/disattiva se il client può o meno utilizzare la modalità Mouse Lock Switch.

Fullscreen

Sicurezza Script Roblox
Lettura Parallela

GamepadCameraSensitivity

Lettura Parallela

Descrive quanto la fotocamera sia sensibile quando si utilizza un gamepad.

GraphicsOptimizationMode

Sicurezza Script Roblox
Lettura Parallela

GraphicsQualityLevel

Sicurezza Script Roblox
Lettura Parallela

HasEverUsedVR

Sicurezza Script Roblox
Lettura Parallela

MasterVolume

Sicurezza Script Roblox
Lettura Parallela

Un float tra 0 e 1 che rappresenta il volume del client del Gioco.

MasterVolumeStudio

Sicurezza Script Roblox
Lettura Parallela

MaxQualityEnabled

Sicurezza Script Roblox
Lettura Parallela

MouseSensitivity

Lettura Parallela

Un float tra 0 e 4 che rappresenta la sensibilità della sensibilità della fotocamera del client.

OnboardingsCompleted

Sicurezza Script Roblox
Lettura Parallela

PartyVoiceVolume

Sicurezza Script Roblox
Lettura Parallela

RCCProfilerRecordFrameRate

Lettura Parallela

RCCProfilerRecordTimeFrame

Lettura Parallela

RotationType

Lettura Parallela

Controlla come viene ruotato il personaggio del client.

SavedQualityLevel

Lettura Parallela

Il livello di qualità grafica impostato dal client.

StartMaximized

Non Replicato
Non programmabile
Sicurezza Script Roblox
Lettura Parallela

StartScreenPosition

Non Replicato
Non programmabile
Sicurezza Script Roblox
Lettura Parallela

StartScreenSize

Non Replicato
Non programmabile
Sicurezza Script Roblox
Lettura Parallela

TouchCameraMovementMode

Lettura Parallela

Il tipo di fotocamera in uso dal client mentre su un Dispositivomobile.

TouchMovementMode

Lettura Parallela

Il tipo di controlli utilizzati dal client su un Dispositivomobile.

UsedCoreGuiIsVisibleToggle

Sicurezza Script Roblox
Lettura Parallela

UsedCustomGuiIsVisibleToggle

Sicurezza Script Roblox
Lettura Parallela

UsedHideHudShortcut

Sicurezza Script Roblox
Lettura Parallela

VREnabled

Sicurezza Script Roblox
Lettura Parallela

VRRotationIntensity

Sicurezza Script Roblox
Lettura Parallela

VRSmoothRotationEnabled

Sicurezza Script Roblox
Lettura Parallela

VignetteEnabled

Sicurezza Script Roblox
Lettura Parallela

Metodi

GetCameraYInvertValue

Restituisce il valore Y-invert della Telecamera.


Restituzioni

GetOnboardingCompleted

Verifica se l'onboarding fornito è stato completato o meno, il che è utile per evitare di mostrare nuovamente l'animazione di onboarding.

Se onboardingId non è uno degli ID accettati, viene generato un errore.

Il processo di onboarding è unidirezionale. Ciò significa che, come sviluppatore, puoi forzare il processo di onboarding a completamento ma non puoi ripristinarlo.

Vedi anche:

Parametri

onboardingId: string

L'ID di onboarding da interrogare.

Valore predefinito: ""

Restituzioni

Se o meno l'onboarding in particolare è stato ancora completato.

InFullScreen

Restituisce vero se la finestra Roblox dell'utente è in modalità a schermo pieno.


Restituzioni

InStudioMode

Restituisce vero se la sessione di gioco del client è in Roblox Studio.


Restituzioni

SetCameraYInvertVisible

()

Se chiamato, Roblox attiva l'opzione menu per invertire l'asse della fotocamera dell'utente.


Restituzioni

()

SetGamepadCameraSensitivityVisible

()

Se chiamato, Roblox attiva l'opzione menu per controllare la sensibilità della fotocamera con i gamepad.


Restituzioni

()

SetOnboardingCompleted

()

Imposta l'onboarding fornito come completato, quindi non verrà mostrato nuovamente all'utente la prossima volta che Giocare.

Attualmente, questa funzione accetta solo DynamicThumbstick, e viene utilizzata per tracciare persistentemente se il giocatore abbia o meno finito il tutorial per lo schema di controllo Dynamic Thumbstick.Se onboardingId non è uno degli ID accettati, viene generato un errore.

Il processo di onboarding è unidirezionale. Ciò significa che, come sviluppatore, puoi forzare il processo di onboarding a completamento ma non puoi ripristinarlo.

Vedi anche:

Parametri

onboardingId: string

L'ID di onboarding da impostare come completato.

Valore predefinito: ""

Restituzioni

()

Eventi

FullscreenChanged

Si accende se la modalità a schermo completo dell'utente viene cambiata.L'evento verrà attivato solo su dispositivi desktop che possono attivare la modalità a schermo pieno.Il gioco sarà sempre in pieno schermo su dispositivi mobili e console.

Parametri

isFullscreen: boolean

Campioni di codice

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

Spedito quando il client dell'utente passa tra la modalità Studio e la modalità in gioco. Questo viene spedito periodicamente in Roblox Studio quando inizia una sessione.

Parametri

isStudioMode: boolean