OrderedDataStore
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Sebuah TokoData yangDipesan adalah pada dasarnya adalah GlobalDataStore dengan pengecualian bahwa nilai yang disimpan harus menjadi angka positif . Ini mengekspos metode 1> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()1> yang mem
Toko data yang dipesan tidak mendukung versi dan metadata, jadi DataStoreKeyInfo selalu nil untuk kunci di dalam Class.OrderedDataStore . Jika Anda memerlukan dukungan versi dan metadata, gunakan OrderedDataStore.
Toko data yang dipesan tidak mendukung parameter SetAsync() opsional untuk IncrementAsync() atau 1> Class.OrderedDataStore:IncrementAsync()|IncrementAsync()1> .
Lihat Toko Data untuk panduan tentang cara menggunakan toko data yang diurutkan.
Contoh Kode
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
Mengembalikan objek DataStorePages .
Mengembalikan nilai kunci dalam penyimpanan data yang ditentukan dan instansi DataStoreKeyInfo.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Meningkatkan nilai kunci oleh jumlah yang diberikan (keduanya harus menjadi angka).
Menghapus kunci yang ditentukan sambil juga menyimpan versi yang dapat diakses.
Tetapkan nilai penyimpanan data untuk unityang diberikan.
Mengubah nilai unitdengan nilai baru dari fungsi panggilan yang ditentukan.
Properti
Metode
GetSortedAsync
Mengembalikan objek DataStorePages. Ordo sort ditentukan oleh naik , panjang setiap halaman oleh ukuran halaman dan 1> minValue1> / 4> maxValue4> adalah parameter yang 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 naik.
Panjang setiap halaman. Secara default adalah 50.Nilai maksimum yang diizinkan adalah 100.
Parameter opcional. Jika diatur, halaman data dengan nilai kurang dari minValue akan dikecualikan.
Parameter opcional. Jika diatur, halaman data dengan nilai lebih besar dari nilai maksimal akan dikecualikan.
Memberikan nilai
Objek DataStorePages yang diurutkan berdasarkan argument yang disediakan.