Archive

存档系统

 对玩家存档进行处理

---

枚举列表

Archive.TYPE

• 描述: 存档类型

成员名称	成员说明
Bool	布尔类型
Number	数值类型
String	字符串类型

---

函数列表

SetPlayerData

• 描述: 存储玩家的存档支持布尔值存档，数值存档，字符串存档。值的类型与存档类型相对应。注意:数据永久存在，可在下一局重复游玩的游戏中读取。

• 范围: 服务端

• 警告: 仅在地图发布后生效，需要在【地图设置】-【存档设置】-【存档方式】中选择支持存档的存档方式才可生效

参数列表:

参数	类型	说明
PlayerID	number	玩家ID
Type	Archive.TYPE	存档类型
Key	string	存档Key
Data	any	存档数据

local score = 0 --玩家已有分数
local addScore = 20 --新增分数
local Key = "score" --存档key，可由开发者自定义
local Type = Archive.TYPE.Number 存档内容数据类型，可由开发者自定义
if Archive:HasPlayerData(playerId, Type, Key) then --查询是否已有存档数据
    score = Archive:GetPlayerData(playerId, Type, Key) --若已有则获取并更新数据
end
score = score + addScore --注意数据类型
Archive:SetPlayerData(playerId, Type, Key, score) --将新增后的分数更新入存档

---

HasPlayerData

• 描述: 判断是否存在玩家的存档数据，是返回true，否返回false。（仅在地图发布后生效）

• 范围: 服务端

• 警告: 仅在地图发布后生效，需要在【地图设置】-【存档设置】-【存档方式】中选择支持存档的存档方式才可生效

参数列表:

参数	类型	说明
PlayerID	number	玩家ID
Type	Archive.TYPE	存档类型
Key	string	存档Key

返回字段:

返回字段	字段类型	说明
bHave	boolean	是否存在玩家的存档数据

local bHave = Archive:HasPlayerData(playerId, Archive.TYPE.Number, "score")

---

GetPlayerData

• 描述: 获取玩家数据并返回。

• 范围: 服务端

• 警告: 仅在地图发布后生效，需要在【地图设置】-【存档设置】-【存档方式】中选择支持存档的存档方式才可生效

参数列表:

参数	类型	说明
PlayerID	number	玩家ID
Type	Archive.TYPE	存档类型
Key	string	存档Key

返回字段:

返回字段	字段类型	说明
data	any	存档数据

Archive:GetPlayerData(playerId, Archive.TYPE.Number, "score")

---