UserSettings

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável

UserSettings é um objeto único que é usado para armazenar configurações básicas do usuário, que persistem em todos os jogos. Atualmente, ele só armazena o ObjetoUserGameSettings.

Você pode recuperar uma referência a este objeto via a função UserSettings(), que o retorna.

Amostras de código

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)

Resumo

Métodos

  • Retorna verdadeiro se a função de usuário especificada estiver ativada. Isso ocorrerá um erro se a função de usuário não existir.

  • Reset():void

    Subtrai o estado salvo das Configurações do Usuário e restaura seus valores padrão.

Métodos herdados de ServiceProvider
  • Escrever Parallel

    Devuelve el servicio especificado por el nombre dado si ya se ha creado, errores por un nombre inválido.

  • Devuelve el servicio con el nombre de clase solicitado, creándolo si no existe.

Eventos

Eventos herdados de ServiceProvider

Propriedades

Métodos

IsUserFeatureEnabled

Retorna verdadeiro se a função de usuário especificada estiver ativada. Isso ocorrerá um erro se a função de usuário não existir.

Essa função verifica uma lista de Bandeiras, cujo nome começa com "Usuário". A função é destinada a ser usada por scripts criados pela Roblox e funções semelhantes a GlobalSettings:GetFFlag() .

Parâmetros

name: string

Devolução

Amostras de código

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

Sobrescreve o estado salvo das Configurações do Usuário e restaura seus valores ao padrão. Essa função não funcionará corretamente a partir de um LocalScript, pois não tem permissão para restaurar todas as propriedades na classe UserGameSettings.


Devolução

void

Eventos