OrderedDataStore
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
A OrderedDataStore เป็นประจำ GlobalDataStore ด้วยข้อยกเว้นว่าค่าที่เก็บไว้ต้องเป็น ตัวเลขที่เป็นบวก เท่านั้น มันเปิดเผยวิธี
ร้านค้าข้อมูลไม่สนับสนุนการจัดเวอร์ชันและเมทาดันข้อมูล ดังนั้น DataStoreKeyInfo จึงเป็น nil สำหรับกุญแจใน OrderedDataStore หากคุณต้องการการจัดเวอ
ร้านค้าข้อมูลไม่สนับสนุนตัวแปร userIds ที่เป็นตัวแปรอpcional สำหรับ SetAsync() หรือ IncrementAsync()
ดู ห้างค้างข้อมูล สำหรับภาพรวมเกี่ยวกับการใช้ห้างค้างข้อมูล
ตัวอย่างโค้ด
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()
สรุป
วิธีการ
กลับไปที่ DataStorePages โอเบ็กต์
กลับค่าของกุญแจในคลังข้อมูลที่กำหนดและ DataStoreKeyInfo ริงค์
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
เพิ่มมูลค่าของกุญแจโดยจำนวนเงินที่กำหนด (ทั้งสองต้องเป็นตัวเลข)
ลบรหัสที่ระบุโดยให้รักษารุ่นที่เข้าถึงได้
ตั้งค่าค่าเก็บข้อมูลสำหรับกุญแจที่กำหนด
คีย์
คุณสมบัติ
วิธีการ
GetSortedAsync
กลับมาที่วัตถุ DataStorePages สิ่งที่เรียงลำดับโดย เลขมากขึ้น ความยาวของแต่ละหน้าโดย pageSize และ 1> minValue1> / 4> maxValue4> เป็นตัวแปรที่เลือกผลลัพธ์
ดู ห้องเก็บข้อมูล สำหรับขีดจำกัดคำขอและคำอธิบายของรหัสผิดพลาด
พารามิเตอร์
บูเลียนแสดงถึงว่าหน้าข้อมูลที่กลับมาอยู่ในลำดับเชิญชวนหรือไม่
ความยาวของแต่ละหน้า โดยปกติคือ 50 ค่าสูงสุดที่อนุญาตคือ 100
ตัวแปรอpcional หากตั้งค่าไว้ หน้าข้อมูลด้วยค่าน้อยกว่า minValue จะถูกสุ่มหมายเลข
ตัวแปรอpcional หากตั้งค่าไว้ หน้าข้อมูลที่มีค่ามากกว่า maxValue จะถูกสุ่มเสี่ยง
ส่งค่ากลับ
เป็นวัตถุ DataStorePages ที่เรียงลำดับตามอาร์กุมที่ให้ไว้