UserSettings

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

無法建立

UserSettings 是一個單一的對象，用於存儲基本用戶設定，並且在所有遊戲中保持一致。目前，它只存儲 UserGameSettings 物件。

您可以使用 UserSettings() 函數取回此對象的引用。

範例程式碼

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)

概要

屬性

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

方法

IsUserFeatureEnabled(name : string):bool
如果指定的用戶功能啟用，則返回 true。如果用戶功能不存在，則會發生錯誤。
Reset():void
清除使用者設定的已儲存狀態，並還原其預設值。

方法繼承自 ServiceProvider

FindService(className : string):Instance
平行寫入
如果已經創建，則返回指定的服務；如果沒有指定的名稱，則返回錯誤。
GetService(className : string):Instance
如果不存在，則返回服務並且建立新的類別名稱。

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

活動

活動繼承自 ServiceProvider

Close():RBXScriptSignal
當前位置已退出時發射。
ServiceAdded(service : Instance):RBXScriptSignal
服務創建時發射。
ServiceRemoving(service : Instance):RBXScriptSignal
發射時，服務即將被移除。

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

屬性

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

方法

IsUserFeatureEnabled

bool

如果指定的用戶功能啟用，則返回 true。如果用戶功能不存在，則會發生錯誤。

此函數檢查對一個列表的旗幟，其名稱由「User」開始。此功能是為 Roblox 創建的指令碼設計，並且與 GlobalSettings:GetFFlag() 相同。

參數

name: string

bool

範例程式碼

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

擦去UserSettings的儲存狀態，並將其值恢復為預設值。此功能在LocalScript中從錯誤執行，因為它沒有權限恢復UserGameSettings類中的所有屬性。

void

屬性繼承自 ServiceProvider

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

活動

屬性繼承自 ServiceProvider

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目