Engine Class
DataStore
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
สรุป
วิธีการ
GetVersionAsync(key: string,version: string):Tuple |
GetVersionAtTimeAsync(key: string,timestamp: number):Tuple |
ListKeysAsync(prefix: string,pageSize: number,cursor: string,excludeDeleted: boolean):DataStoreKeyPages |
ListVersionsAsync(key: string,sortDirection: Enum.SortDirection,minDate: number,maxDate: number,pageSize: number):DataStoreVersionPages |
RemoveVersionAsync(key: string,version: string):() |
สมาชิกที่ได้รับทอด
สมาชิก 6 คนที่รับทอดมาจาก GlobalDataStore
สมาชิก 57 คนที่รับทอดมาจาก Instance
สมาชิก 6 คนที่รับทอดมาจาก Object
เอกสารอ้างอิงเกี่ยวกับ API
วิธีการ
GetVersionAsync
GetVersionAtTimeAsync
ส่งค่ากลับ
ตัวอย่างโค้ด
การเรียกข้อมูลเวอร์ชัน DataStore ตามเวลา
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("ไม่พบเวอร์ชันที่เวลานี้")
else
print(result, keyInfo.Version)
end
else
warn(result)
end
end
-- ทำงานเมื่อ 2024/12/02 6:00 UTC
setData("เวอร์ชัน 1")
-- ทำงานเมื่อ 2024/12/02 9:00 UTC
setData("เวอร์ชัน 2")
-- พิมพ์ "ไม่พบเวอร์ชันที่เวลานี้"
local time1 = DateTime.fromUniversalTime(2024, 12, 02, 05, 00)
getVersionAtTime(time1)
-- พิมพ์ "เวอร์ชัน 1 <version>"
local time2 = DateTime.fromUniversalTime(2024, 12, 02, 07, 00)
getVersionAtTime(time2)
-- พิมพ์ "เวอร์ชัน 2 <version>"
local time3 = DateTime.fromUniversalTime(2024, 12, 02, 10, 00)
getVersionAtTime(time3)ListKeysAsync
DataStore:ListKeysAsync(
ส่งค่ากลับ
ListVersionsAsync
DataStore:ListVersionsAsync(
พารามิเตอร์
| ค่าเริ่มต้น: "Ascending" |
| ค่าเริ่มต้น: 0 |
| ค่าเริ่มต้น: 0 |
| ค่าเริ่มต้น: 0 |
ส่งค่ากลับ
ตัวอย่างโค้ด
ดึงข้อมูลเวอร์ชัน DataStore ด้วยตัวกรองวันที่
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, "; เวอร์ชัน:", info.Version, "; สร้างเมื่อ:", info.CreatedTime, "; ลบ:", info.IsDeleted)
end
endRemoveVersionAsync