OrderedDataStore
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
A OrderedDataStore pada dasarnya adalah GlobalDataStore dengan pengecualian bahwa nilai yang disimpan harus menjadi bilangan positif .Ini mengekspos metode GetSortedAsync() yang memungkinkan pemeriksaan entri dalam urutan terurut menggunakan objek DataStorePages.
Toko data yang diurutkan tidak mendukung versi dan metadata, jadi DataStoreKeyInfo selalu nil untuk kunci di dalam OrderedDataStore .Jika Anda membutuhkan dukungan versi dan metadata, gunakan DataStore .
Toko data yang diurutkan tidak mendukung parameter opsional userIds untuk SetAsync() atau IncrementAsync() .
Lihat Toko Data untuk panduan umum tentang menggunakan toko data terurut.
Contoh Kode
This code sample demonstrates usage of an OrderedDataStore and pages.
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()
Rangkuman
Metode
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Kembalikan objek DataStorePages .
Kembalikan nilai kunci di penyimpanan data tertentu dan kejadianDataStoreKeyInfo .
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Meningkatkan nilai kunci dengan jumlah yang disediakan (keduanya harus menjadi bilangan bulat).
Menghapus kunci yang ditentukan sambil juga menyimpan versi yang dapat diakses.
Tetapkan nilai penyimpanan data untuk unityang diberikan.
Memperbarui nilai unitdengan nilai baru dari fungsi panggilan balasan yang ditentukan.
Properti
Metode
GetSortedAsync
Kembalikan objek DataStorePages .Urutan sortir ditentukan oleh naik , panjang setiap halaman oleh ukuran halaman , dan minValue / maxValue adalah parameter opsional yang menyaring hasil.
Lihat Toko Data untuk batas permintaan dan deskripsi kode kesalahan.
Parameter
Boolean yang menunjukkan apakah halaman data yang dikembalikan berada dalam urutan menaik.
Panjang setiap halaman. Nilai maksimum yang diizinkan adalah 50. Nilai maksimum yang diizinkan adalah 100.
Parameter opsional. Jika diatur, halaman data dengan nilai kurang dari minValue akan dikecualikan.
Parameter opsional. Jika diatur, halaman data dengan nilai lebih besar dari maxValue akan dikecualikan.
Memberikan nilai
Sebuah objek terurut DataStorePages berdasarkan argumen yang disediakan.