DataStore
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Bakın Veri Depoları.
Özet
Özellikler
Yöntemler
Belirtilen anahtar sürümünü alır.
Belirli bir zamanda mevcut olan anahtar sürümünü alır.
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : boolean):DataStoreKeyPages
Veri depolarının mağazaaracılığıyla sayım yapmak için bir DataStoreKeyPages nesnesi döndürür.
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
Bir anahtarın tüm sürümlerini sayar.
Belirtilen bir anahtarın kalıcı olarak belirtilen sürümünü siler.
Yöntemler
Belirtilen veri depolamasındaki bir anahtarın değerini ve bir DataStoreKeyInfo durumdöndürür.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Verilen miktar ile bir anahtarın değerini artırır (her ikisi de tamsayı olmalıdır).
Belirtilen anahtarı kaldırırken erişilebilir bir sürüm de korur.
Verilen anahtar için veri depolama değerini ayarlar.
Bir anahtarın değerini belirtilen geri çağrı işlevinden yeni bir değerle günceller.
Özellikler
Yöntemler
GetVersionAsync
Parametreler
Dönüşler
GetVersionAtTimeAsync
Parametreler
Dönüşler
Kod Örnekleri
local DataStoreService = game:GetService("DataStoreService")
local dataStore = DataStoreService:GetDataStore("DataStore")
local key = "key-123"
function setData(data)
local success, result = pcall(function()
dataStore:SetAsync(key, data)
end)
if not success then
warn(result)
end
end
function getVersionAtTime(timestamp)
local success, result, keyInfo = pcall(function()
return dataStore:GetVersionAtTimeAsync(key, timestamp.UnixTimestampMillis)
end)
if success then
if result == nil then
print("No version found at time")
else
print(result, keyInfo.Version)
end
else
warn(result)
end
end
-- Daha önce 2024/12/02 6:00 UTC'de çalıştı
setData("version 1")
-- Daha önce 2024/12/02 9:00 UTC'de çalıştı
setData("version 2")
-- Baskı "Zaman içinde bulunan hiçbir sürüm bulunamadı"
local time1 = DateTime.fromUniversalTime(2024, 12, 02, 05, 00)
getVersionAtTime(time1)
-- Basar "versiyon 1 <versiyon>"
local time2 = DateTime.fromUniversalTime(2024, 12, 02, 07, 00)
getVersionAtTime(time2)
-- Basar "versiyon 2 <version>"
local time3 = DateTime.fromUniversalTime(2024, 12, 02, 10, 00)
getVersionAtTime(time3)ListKeysAsync
Parametreler
Dönüşler
ListVersionsAsync
Parametreler
Dönüşler
Kod Örnekleri
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