OrderedDataStore는 일반적으로 GlobalDataStore 와 같지만, 저장된 값이 음수 정수 여야 합니다. 이는 1> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()1> 메서드를 사용하여 정렬된 항목을 검사하는
주문된 데이터 저장소는 버전 관리 및 메타데이터를 지원하지 않으므로 DataStoreKeyInfo 는 항상 nil 이 키에 대해 OrderedDataStore 입니다. 버전 관리 및 메타데이터 지원이 필요한 경우 1> Class.DataStore1> 를 사용하십시오.
주문된 데이터 저장소는 userIds 또는 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()
요약
메서드
Class.DataStorePages 개체를 반환합니다.
지정된 데이터 저장소의 키 값과 DataStoreKeyInfo 인스턴스를 반환합니다.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
지정된 값으로 키의 값을 증가시킵니다(둘 다 정수여야 함).
액세스 가능한 버전을 유지하면서 지정된 키를 제거합니다.
지정된 키에 대한 데이터 저장소의 값을 설정합니다.
지정된 콜백 함수에서 새로운 값을 사용하여 키의 값을 업데이트합니다.
속성
메서드
GetSortedAsync
Class.DataStorePages 개체를 반환합니다. 정렬 순서는 오름차순, 각 페이지의 길이는 페이지 크기 및 1>최소값1> / 4>최대값4> 이상 필터링 하는 옵션 매개 변수입니다.
오류 코드의 요청 제한 및 설명은 데이터 저장소를 참조하십시오.
매개 변수
반환된 데이터 페이지가 오름차순으로 있는지 여부를 나타내는 부울입니다.
각 페이지의 길이. 기본적으로 50입니다. 허용되는 최대 값은 100입니다.
선택적 매개 변수. 설정하면 minValue 미만의 데이터 페이지가 제외됩니다.
선택적 매개 변수. 설정하면 maxValue 보다 큰 값이 있는 데이터 페이지가 제외됩니다.
반환
제공된 인수에 따라 정렬된 DataStorePages 개체.