Klasa silnika
MemoryStoreSortedMap
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Podsumowanie
Metody
GetRangeAsync(direction: Enum.SortDirection,count: number,exclusiveLowerBound: Variant,exclusiveUpperBound: Variant):{any} |
RemoveAsync(key: string):() |
UpdateAsync(key: string,transformFunction: function,expiration: number):Tuple |
Materiały referencyjne dotyczące interfejsów API
Metody
GetRangeAsync
MemoryStoreSortedMap:GetRangeAsync(
direction:Enum.SortDirection, count:number, exclusiveLowerBound:Variant, exclusiveUpperBound:Variant
Parametry
exclusiveLowerBound:Variant |
exclusiveUpperBound:Variant |
Zwroty
Przykłady kodu
Pobieranie kluczy MemoryStore
local MemoryStoreService = game:GetService("MemoryStoreService")
local myMap = MemoryStoreService:GetSortedMap("MySortedMap")
function printAllKeys(map)
-- początkowy dolny limit to nil, co oznacza, że zaczynamy od pierwszego elementu
local exclusiveLowerBound = nil
-- ta pętla trwa, aż osiągnięty zostanie koniec mapy
while true do
-- pobiera do stu elementów, zaczynając od aktualnego dolnego limitu
local items = map:GetRangeAsync(Enum.SortDirection.Ascending, 100, exclusiveLowerBound)
for _, item in ipairs(items) do
print(item.key)
print(item.sortKey)
end
-- jeśli zwrócono mniej niż sto elementów, oznacza to, że osiągnęliśmy koniec mapy
if #items < 100 then
break
end
-- ostatnio pobrany klucz jest wyłącznym dolnym limitem dla następnej iteracji
exclusiveLowerBound = {}
exclusiveLowerBound["key"] = items[#items].key
exclusiveLowerBound["sortKey"] = items[#items].sortKey
end
end
printAllKeys(myMap)SetAsync
UpdateAsync
Zwroty
Przykłady kodu
Aktualizacja posortowanej mapy MemoryStore
local MemoryStoreService = game:GetService("MemoryStoreService")
local map = MemoryStoreService:GetSortedMap("Leaderboard")
local Players = game:GetService("Players")
function updateLeaderboard(itemKey, killsToAdd, deathsToAdd)
local success, newStats, newScore = pcall(function()
return map:UpdateAsync(itemKey, function(playerStats, playerScore)
playerStats = playerStats or { kills = 0, deaths = 0 }
playerStats.kills += killsToAdd
playerStats.deaths += deathsToAdd
if playerStats then
-- `playerScore` to klucz sortowania używany do sortowania elementów w mapie
playerScore = playerStats.kills / math.max(playerStats.deaths, 1)
return playerStats, playerScore
end
return nil
end, 30)
end)
end
-- Dodaj jedno zabicie dla wszystkich graczy
for i, player in pairs(Players:GetPlayers()) do
updateLeaderboard(player.UserId, 1, 0)
end
-- Dodaj 5 zabitych i 1 zgon dla gracza z userId 12345
updateLeaderboard(12345, 5, 1)