OrderedDataStore
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
OrderedDataStore は、GlobalDataStore の除外、ストレージされた値が 正数 でなければなりません。これには、1> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()1> メソッドが使用されます。これにより、4>
オーダーされたデータストアはバージョン管理とメタデータをサポートしていませんので、DataStoreKeyInfo は常に nil でキーが OrderedDataStore にあります。2>バージョン管理とメタデータをサポートする場合は、5> Class.DataStore5> を使用して
オーダーされたデータストアは、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> minValue1> / 4> maxValue4> はオプションパラメーターであり、結果をフィルターにかけます。
エラーコードのリクエスト限度と説明については、データストア を参照してください。
パラメータ
返されたデータページがアセンダンスで表示されているかを示すブールーン。
各ページの長さ。デフォルトは 50 です。最大許可値は 100 です。
オプションパラメーター。設定すると、値が minValue 以下のデータページは含まれなくなります。
オプションパラメーター。設定すると、データページの値が 最大値 より大きい場合、その値を持つページは含まれません。
戻り値
提供された引数に基づく DataStorePages オブジェクト。