DataStore
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
สรุป
วิธีการ
ดึงรุ่นกุญแจที่กำหนด
- ListKeysAsync(prefix : string,pageSize : number,cursor : string,excludeDeleted : bool):DataStoreKeyPages
กลับมาเป็น DataStoreKeyPages ร้านค้า
- ListVersionsAsync(key : string,sortDirection : Enum.SortDirection,minDate : number,maxDate : number,pageSize : number):DataStoreVersionPages
นับเวอร์ชันทั้งหมดของกุญแจ
ลบรุ่นที่กำหนดไว้ถาวรของกุญแจ
กลับค่าของกุญแจในคลังข้อมูลที่กำหนดและ DataStoreKeyInfo ริงค์
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
เพิ่มมูลค่าของกุญแจโดยจำนวนเงินที่กำหนด (ทั้งสองต้องเป็นตัวเลข)
ลบรหัสที่ระบุโดยให้รักษารุ่นที่เข้าถึงได้
ตั้งค่าค่าเก็บข้อมูลสำหรับกุญแจที่กำหนด
คีย์
คุณสมบัติ
วิธีการ
GetVersionAsync
ฟังก์ชันนี้สามารถดึงรุ่นกุญแจที่กำหนดไว้รวมถึงรุ่น DataStoreKeyInfo อินสแตนซ์ ตัวระบุเวอร์ชันสามารถพบได้ผ่าน DataStore:ListVersionsAsync() หรืออาจเป็นตัวระบุเวอร์ชั
พารามิเตอร์
ชื่อกุญแจสำหรับรุ่นที่มีข้อมูลเกี่ยวกับเวอร์ชัน หาก DataStoreOptions.AllScopes ถูกตั้งค่าเป็น true เมื่อเข้าถึงรุ่นข้อมูลผ่าน DataStoreService:GetDataStore() นี้ควรมีชื่อกุญแจด้วยสกุ
รหัสเวอร์ชันของกุญแจสำหรับข้อมูลเวอร์ชัน
ส่งค่ากลับ
มีค่าของกุญแจที่มีในเวอร์ชันที่กำหนดและ DataStoreKeyInfo ริงค์ที่รวมเลขเวอร์ชันที่สร้างขึ้นและเวลาที่สร้างขึ้นและระบบที่จะดึง UserIds และเมทาดาตา.
ListKeysAsync
ฟังก์ชันนี้กลับมาเป็น DataStoreKeyPages ตัวเองสำหรับการนับผ่านคีย์ของสโตร์ข้อมูล มันยอมรับตัวประกาย prefix ตัวอักษรเพียงเพื่อค้นหารายการที่มีชื่อเริ่มต้นด้วยคีย์ที่ให้ไว้
หาก DataStoreOptions.AllScopes ถูกตั้งค่าให้เป็นจริงเมื่อเข้าถึงสโตร์ข้อมูลผ่าน DataStoreService:GetDataStore() กุญแจจะถูกส่งคืนด้วยทุกสโตร์เป็นรหัสอ้างอิง
พารามิเตอร์
(ไม่บังคับ) รหัสชื่อโดเมนที่ใช้สำหรับการตรวจค้นกุญแจ
(ไม่บังคับ) จำนวนสูงสุดของรายการที่สามารถกลับมาได้
(อpcional) ตัวเลือกเพื่อดำเนินการต่อ
(อpcional) ปิดการส่งกุญแจที่ลบออก
เมื่อเปิดใช้งาน ListKeys จะตรวจสอบได้ถึง 512 กุญแจ หากทุกคนที่ได้รับการตรวจสอบถูกลบออกจะสร้างรายการที่ว่างเปล่าด้วยตัวเลือกเพื่อดำเนินการต่อ
ส่งค่ากลับ
ตัวอย่าง DataStoreKeyPages ที่รวบรวมกุญแจเป็น DataStoreKey ตัวอย่าง
ListVersionsAsync
ฟังก์ชันนี้รวบรวมเวอร์ชันของคีย์ที่ระบุในแบบอันเชิญหรือแบบลดลงในลำดับที่กำหนดโดย Enum.SortDirection ตัวประกาศ
พารามิเตอร์
ชื่อกุญแจสำหรับเวอร์ชันที่ระบุ หาก DataStoreOptions.AllScopes ถูกตั้งค่าให้เป็นจริงเมื่อเข้าถึงร้านค้าข้อมูลผ่าน DataStoreService:GetDataStore() คุณต้องใส่ชื่อกุญแจด้วยสเก็ต/คีย์เ
รายการเรียงลำดับจากมากไปหน้าหรือจากน้อยไปหน้า
เวลาที่แน่นอนใน milliseconds หลังจากนั้นจึงควรระบุเวอร์ชัน
เวลาที่แน่นอนใน milliseconds จนกว่าจะมีรายการเวอร์ชัน
จำนวนรายการที่จะถูกส่งกลับในแต่ละหน้า
ส่งค่ากลับ
ตัวอย่าง DataStoreVersionPages ที่รวบรวมเวอร์ชันของกุญแจทั้งหมดเป็น DataStoreObjectVersionInfo ตัวอย่าง
ตัวอย่างโค้ด
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
ฟังก์ชันนี้ลบรุ่นที่ระบุไว้ถาวรของกุญแจ ตัวระบุเวอร์ชันสามารถพบได้ผ่าน DataStore:ListVersionsAsync()
ในขณะที่ GlobalDataStore:RemoveAsync() ไม่สร้างรุ่น "tombstone" ใหม่และค่าที่ลบออกจะไม่สามารถกู้คืนได้ในภายหลัง
พารามิเตอร์
ชื่อเวอร์ชันที่จะถูกลบออก หาก DataStoreOptions.AllScopes ถูกตั้งค่าให้เป็นจริงเมื่อเข้าถึงร้านค้าข้อมูลผ่าน DataStoreService:GetDataStore() คุณต้องใส่ชื่อเวอร์ชันนี้ด้วยสโคปเดิม
หมายเลขเวอร์ชันของกุญแจที่จะลบ