UserSettings

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Création impossible

UserSettings est un objet unique qui est utilisé pour héberge les paramètres d'utilisateur de base, qui persistent dans tous les jeux. Actuellement, il ne stocke que l'objet UserGameSettings.

Vous pouvez récupérer une référence à cet objet via la fonction UserSettings(), qui le renvoie.

Échantillons de code

IsUserFeatureEnabled Sample
if UserSettings():IsUserFeatureEnabled("UserNoCameraClickToMove") then

	print("'ClickToMove' should no longer be loaded from the CameraScript!")

else

	print("'ClickToMove' is still loaded from the CameraScript!")

end
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)
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)

Résumé

Méthodes

  • IsUserFeatureEnabled(name : string):bool

    Retourne vrai si la fonctionnalité utilisateur spécifiée est activée. Ceci lancera une erreur si la fonctionnalité utilisateur n'existe pas.

  • Reset():void

    Efface l'état sauvegardé des paramètres de l'utilisateur et restaure ses valeurs par défaut.

Méthodes hérités de ServiceProvider
  • FindService(className : string):Instance
    Écrire en parallèle

    Renvoie le service spécifié par le nom donné s'il est déjà créé, des erreurs pour un nom invalide.

  • GetService(className : string):Instance

    Retourne le service avec le nom de classe demandé, le créant s'il n'existe pas.

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Évènements

Évènements hérités de ServiceProvider
Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Propriétés

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Méthodes

IsUserFeatureEnabled

bool

Retourne vrai si la fonctionnalité utilisateur spécifiée est activée. Ceci lancera une erreur si la fonctionnalité utilisateur n'existe pas.

Cette fonction vérifie une liste de Fonds, dont le nom commence par utilisateur. La fonction est destinée à être utilisée par les scripts créés par Roblox, et les fonctions similaires à GlobalSettings:GetFFlag() .

Paramètres

name: string

Retours

bool

Échantillons de code

IsUserFeatureEnabled Sample
if UserSettings():IsUserFeatureEnabled("UserNoCameraClickToMove") then

	print("'ClickToMove' should no longer be loaded from the CameraScript!")

else

	print("'ClickToMove' is still loaded from the CameraScript!")

end

Reset

void

Efface l'état sauvegardé des utilisateurSettings et restaure ses valeurs par défaut. Cette fonction ne fonctionnera pas correctement à partir d'un LocalScript, car il n'a pas la permission de restaurer toutes les propriétés dans la classe UserGameSettings.


Retours

void
Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Évènements

Afficher tous les hérités de Instance
Afficher tous les hérités de Object