工坊手册

主题

DataStoreGetVersionOptions ​

DataStore:GetVersionAsync / GetVersionAtTimeAsync 的可选参数类型，可通过 DataStoreGetVersionOptions.New() 创建。

概览 ​

DataStore:GetVersionAsync / GetVersionAtTimeAsync 的可选参数类型，可通过 DataStoreGetVersionOptions.New() 创建。

可通过 DataStoreGetVersionOptions.New() 构造

代码示例 ​

读取指定版本并返回 KeyInfo

lua
-- @runtime server
local DataStoreService = game:GetService('DataStoreService')
local Task = game:GetService('Task')
local dataStore = DataStoreService:GetDataStore('PlayerData')
local key = 'player_1001'
local options = DataStoreGetVersionOptions.New()
options.WithKeyInfo = true

Task:Spawn(function()
    local pages = dataStore:ListVersionsAsync(key, false, 0, 0, 10)
    local versionInfo = pages:GetCurrentPage()[1]
    if versionInfo == nil then
        print('当前键没有可读取的历史版本')
        return
    end
    local value, keyInfo = dataStore:GetVersionAsync(key, versionInfo.Version, options)
    print('版本值:', value, '版本号:', keyInfo and keyInfo.Version)
end)

属性 ​

名称类型默认值说明
WithKeyInfoBool-是否在返回结果中附带键信息（version, created/modified time, UserIds, Metas 等键元数据）。