DataStore
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Lihat Toko Data .
Rangkuman
Metode
Mengambil versi kunci yang ditentukan.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
Mengembalikan objek DataStoreKeyPages untuk diuraikan melalui kunci dari data toko.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Menghitung semua versi dari unit.
Secara permanen menghapus versi kunci yang ditentukan.
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
GetVersionAsync
Fungsi ini mengambil versi kunci yang ditentukan serta sebuah instansi DataStoreKeyInfo . Sebuah identifikator versi dapat ditemukan melalui DataStore:ListVersionsAsync() atau alternatifnya mengambil identifikator yang dikembalikan oleh GlobalDataStore:SetAsync().
Parameter
Nama kunci untuk versi informasi yang diminta. Jika DataStoreOptions.AllScopes dibatalkan ketika mengakses data store melalui DataStoreService:GetDataStore(), nama kunci ini harus dipanggil dengan skala asli seperti " scope / key".
Nomor versi kunci untuk versi mana informasi versi diinta minta.
Memberikan nilai
Nilai kunci di versi yang ditentukan dan sebuah instansi DataStoreKeyInfo yang mencakup nomor versi, tanggal dan waktu pembuatan versi, dan fungsi untuk mengambil UserIds dan metadata.
ListKeysAsync
Fungsi ini mengembalikan objek DataStoreKeyPages untuk mengumpulkan melalui kunci dari penyimpanan data. Ini menerima parameter prefix opsional untuk menemukan hanya kunci-kunci yang bernama dengan premis yang disediakan.
Jika DataStoreOptions.AllScopes di set ke benar saat mengakses data store melalui DataStoreService:GetDataStore(), kunci akan dikembalikan dengan semua skala sebagai prasetel.
Parameter
(Opsional) Prefix untuk digunakan untuk menemukan kunci.
(Opsional) Jumlah maksimum item yang dapat dikembalikan.
(Opsional) Cursor untuk melanjutkan iterasi.
(Opsional) Tinggalkan kunci yang dihapus dari diembalikan.
Ketika diaktifkan, ListKeys akan memeriksa hingga 512 kunci. Jika semua kunci yang diaktifkan dihapus, maka akan mengembalikan daftar kosong dengan cursor untuk melanjutkan iterasi.
Memberikan nilai
Sebuah instansi DataStoreKeyPages yang menguraikan kunci sebagai DataStoreKey instansi.
ListVersionsAsync
Fungsi ini menghitung versi kunci yang ditentukan dalam urutan naik atau turun yang ditentukan oleh parameter Enum.SortDirection . Ini dapat secara opional menyaring versi yang dikembalikan berdasarkan minimal dan maksimum waktu戳.
Parameter
Nama kunci untuk versi yang akan di daftarkan. Jika DataStoreOptions.AllScopes ditetapkan ke benar saat mengakses data store melalui DataStoreService:GetDataStore(), nama kunci ini harus disertakan dengan scope asli seperti yang ada di " scope / key".
Daftar spesifikasi menentukan urutan sort yang naik atau turun.
Tanggal saat ini Unix dalam milidetik setelah itu versi harus di daftarkan.
Waktu UTC di milidetik ke atas sampai versi harus di daftarkan.
Jumlah item yang akan dikembalikan di setiap halaman.
Memberikan nilai
Sebuah DataStoreVersionPages instansi yang menguraikan semua versi kunci sebagai DataStoreObjectVersionInfo instansi.
Contoh Kode
local DataStoreService = game:GetService("DataStoreService")
local experienceStore = DataStoreService:GetDataStore("PlayerExperience")
local time = DateTime.fromUniversalTime(2020, 10, 09, 01, 42)
local listSuccess, pages = pcall(function()
return experienceStore:ListVersionsAsync("User_1234", nil, time.UnixTimestampMillis)
end)
if listSuccess then
local items = pages:GetCurrentPage()
for key, info in pairs(items) do
print("Key:", key, "; Version:", info.Version, "; Created:", info.CreatedTime, "; Deleted:", info.IsDeleted)
end
end
RemoveVersionAsync
Fungsi ini secara permanen menghapus versi yang ditentukan dari unit. ID versi dapat ditemukan melalui DataStore:ListVersionsAsync() .
Tidak seperti GlobalDataStore:RemoveAsync(), fungsi ini tidak membuat versi "tombstone" baru dan nilai yang dihapus tidak dapat dipulihkan nanti.
Parameter
Nama kunci untuk versi yang akan dihapus. Jika DataStoreOptions.AllScopes ditetapkan sebagai benar saat mengakses data store melalui DataStoreService:GetDataStore(), nama kunci ini harus disertakan dengan scope asli seperti dalam "scope/key".
Nomor versi kunci untuk dihapus.