DataStoreService

Ustawia, czy funkcje przechowywania danych powinny automatycznie ponownie spróbować, czy nie.

DataStoreService nie respektuje tej właściwości, ponieważ automatyczne ponowne próby zostały wyłączone z powodów technicznych.Dlatego musisz wdrożyć systemy do odnowienia operacji samodzielnie.Możliwe jest ponowne włączenie automatycznego ponownego próbowania w przyszłości.

Funkcja ta tworzy instancję DataStore z podaną nazwą i zakresem.Następne wezwania do tej metody z tym samym nazwiskiem/zakresem zwrócą ten sam obiekt.

Użycie parametru scope ograniczy operacje do tego zakresu poprzez automatyczne dodawanie zakresu do kluczy we wszystkich wykonywanych na sklepdanych operacjach.Funkcja ta akceptuje również opcjonalną instancję DataStoreOptions, która zawiera opcje umożliwiające włączenie AllScopes.Zobacz Magazyny danych dla szczegółów na temat zakresu.

Parametry

Zwroty

Funkcja ta zwraca domyślną GlobalDataStore .Jeśli chcesz uzyskać dostęp do określonego nazwanego magazynu danych, powinieneś użyć funkcji GetDataStore().

Zauważ, że DataStore zwrócone przez tę funkcję zawsze używa zakresu u . Zobacz przechowywanie danych na szczegóły dotyczące zakresu.

Zwroty

local DataStoreService = game:GetService("DataStoreService")

local GlobalDataStore = DataStoreService:GetGlobalDataStore()

print(GlobalDataStore.Name)

Ta metoda zwraca OrderedDataStore , podobnie jak sposób, w jaki GetDataStore() robi z GlobalDataStores .Następne wezwania do tej metody z tym samym nazwiskiem/zakresem zwrócą ten sam obiekt.

Parametry

Zwroty

local DataStoreService = game:GetService("DataStoreService")
local pointsStore = DataStoreService:GetOrderedDataStore("Points")

local function printTopTenPlayers()
	local isAscending = false
	local pageSize = 10
	local pages = pointsStore:GetSortedAsync(isAscending, pageSize)
	local topTen = pages:GetCurrentPage()

	-- The data in 'topTen' is stored with the index being the index on the page
	-- For each item, 'data.key' is the key in the OrderedDataStore and 'data.value' is the value
	for rank, data in ipairs(topTen) do
		local name = data.key
		local points = data.value
		print(name .. " is ranked #" .. rank .. " with " .. points .. "points")
	end

	-- Potentially load the next page...
	--pages:AdvanceToNextPageAsync()
end

-- Create some data
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)

-- Display the top ten players
printTopTenPlayers()

Funkcja ta zwraca liczbę żądań przechowywania danych, które obecne miejsce może wykonać w oparciu o podany Enum.DataStoreRequestType .Wszelkie żądania przekraczające ten budżet podlegają ograniczeniu.Zaleca się monitorowanie i dostosowywanie częstotliwości żądań przechowywania danych za pomocą tej funkcji.

Parametry

Zwroty

local DataStoreService = game:GetService("DataStoreService")

local globalStore = DataStoreService:GetGlobalDataStore()

local function printBudget()
	local budget = DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.SetIncrementAsync)
	print("Current set/increment budget:", budget)
end

for i = 1, 5 do
	local key = "key" .. i
	local success, err = pcall(function()
		globalStore:SetAsync(key, true)
	end)
	if success then
		printBudget()
	else
		print(err)
	end
end

Zwraca obiekt DataStoreListingPages do wyszukiwania przez wszystkie magazyny danych doświadczenia.Akceptuje opcjonalny parametr prefix opcjonalny, aby znaleźć tylko magazyny danych, których nazwy zaczynają się od podanego prefiksu.

Tylko sklepy danych zawierające co najmniej jeden obiekt zostaną wymienione za pomocą tej funkcji.

Parametry

Zwroty