批量导入器和导出器工具

一种帮助管理统计数据和成就的工具

你可以使用 批量导入器/导出器工具(Bulk Importer/Exporter Tool)开发者门户界面之外管理产品的统计数据成就。此工具使用包含CSV格式数据的.zip存档,因此你可以在各种现有程序或自己的工具中查看和编辑你的统计数据和成就。

批量导入工具仅影响你的统计数据和成就的 定义。它不会以任何方式添加、删除或更改用户的进度。如果你删除并重新创建你的统计数据或成就定义,你的用户统计数据和成就进度将保持不变。

你可以在 开发者门户(Developer Portal)游戏服务(Games Services) > 成就(Achievements) 下找到此工具。批量导入/导出(Bulk Import/Export) 按钮位于靠近顶部的 玩家查找(Player Lookup)新建(Create New) 按钮之间。

导出(步骤1)

导出流程会创建一个zip存档以供下载。此存档将包含产品的所有现有统计数据和成就的.csv和.png图像文件。

这些文件遵循标准的.csv格式,所以大多数电子表格软件包都可以轻松导出和导入此格式。导出前,你的图像文件应是标准的.png格式。

要开始导出,只需选择 导出当前成就(Export Current Achievements)。下载会自动开始,并在通常存放下载内容的路径下创建一个.zip文件夹。

如果仅是想要导出数据,可以选择 导出当前成就(Export Current Achievements),并在这一步点击取消或X可退出此模式。

也可选择 下一步(Next) 跳过导出。如果当前成就没有备份, 建议跳过这一步。

导入(步骤2和3)

导入成就和统计数据会删除和覆盖当前的成就和统计数据。确保你的成就和统计数据有备份,以防需要恢复你的更改。

导入流程与导出流程遵循同一文件格式。.zip导入文件应包含以下文件:

文件名

内容

stats.csv

定义各个统计数据的"名称和类型"组合的列表

achievementDefinitions.csv

成就名称列表,以及引用的统计数据

achievementLocalizations.csv

成就本地化区域设置键及其图标的文件名

一个或多个.png文件

achievementDefinitions.csv 中引用的图标

为了准备导入.zip文件,你可以从开发者门户(上传zip的地方)下载我们的zip模板(选择 下载EOS成就Zip模板)或点击此处。上述任一方法都会自动下载我们的 BulkTemplate.zip 示例文件夹,内含整理有序的内容。

EOS成就批量导入模板示例

开始导入流程之前,查看你的CSV图像文件的要求。

一旦准备好导入文件,在批量导入流程的第2步中选择 选择要上传的文件(Choose File to Upload)。查看通知,即导入操作会删除所有现有成就并清除产品的所有统计数据。

选择 下一步(Next),将发起对导入内容的验证检查。完成后,后端服务会删除你的所有现有统计数据和成就,然后替换为在.zip文件中找到的统计数据和成就。这包括在后端服务上缓存新成就使用的任何图标。

导入程序的最后一步会显示你的成就和统计资料导入成功。

在实时部署中导入时,统计数据和成就定义可能处于不完整状态。结果,用户可能无法记录统计数据或解锁成就。为了最大程度减少对用户的干扰和意外行为,我们建议在实时部署的维护窗口期间导入数据。

CSV格式要求

为了确保上传的.csv文件通过验证检查,请遵守各个文件的数据格式,并避免留下空白行。所有CSV文件必须采用UTF-8编码。

stats.csv格式

Stats.csv 文件包含两个统计数据列:统计数据名称列及其聚合类型列。聚合类型的支持值是 SUMMINMAXLATESTstats.csv 示例文件如下:

name,aggregationType
numTreesChopped,SUM
lastTreesChopped,LATEST
maxTreesChopped,MAX
minTreesChopped,MIN
numAxesUsed,SUM

统计数据名称采用驼峰式命名法,聚合类型全部大写,并且每个整行中没有空格。

详见统计数据界面

achievementDefinitions.csv格式

achievementsDefinitions.csv 使用三列来定义每个成就以及解锁成就的要求。前两列保存成就的内部名称和布尔值,该值指示成就是否隐藏。

第三列是可选的;如果为空,成就只能通过EOS SDK的显式命令解锁。如果第三列存在,则是一个统计数据名称和阈值的列表,格式为 Stat1:Threshold1;Stat2:Threshold2;StatN:ThresholdN,如以下 Achievements.csv 示例文件:

name,hidden,statThresholds
achvTutorial,FALSE,
achvLumberjack,FALSE,numTreesChopped:3
achvWoodsman,TRUE,numTreesChopped:100;numAxesUsed:5

内部名称采用驼峰式命名法,第二列是TRUE或FALSE,可选的第三列使用驼峰式统计数据,带冒号(:)和阈值条件。每个整行中没有空格。

详见成就界面

achievementLocalizations.csv格式

所有有关成就的用户可见信息都要本地化。

achievementLocalizations.csv 负责设置向不同地区用户描述各个成就所需的所有数据。这包括成就和区域设置的内部名称,之后是其锁定时的标题和描述、解锁时的标题和描述、风格文本、其锁定和解锁图标。以下 achievementLocalizations.csv 示例文件展示同一组成就的默认版本(第二列为空)和德语版本(第二列为"de")。

name,locale,lockedTitle,lockedDescription,unlockedTitle,unlockedDescription,flavorText,lockedIcon,unlockedIcon
achvTutorial,,Intro,Complete the Tutorial,Intro,Completed the Tutorial,Onwards!,locked.png,tutorial.png
achvTutorial,de,Einführung,Schließe die Einführung ab,Einführung,Die Einführung abgeschlossen,Weiter!,locked.png,tutorial.png
achvLumberjack,,Lumberjack,Chop 3 trees,Lumberjack,Chopped 3 trees,Timber!,locked.png,lumberjack.png
achvLumberjack,de,Holzfäller,Fälle drei Bäume,Holzfäller,Drei Bäume gefällt,Holz!,locked.png,lumberjack_de.png
achvWoodsman,,Woodsman,Roam the woods,Woodsman,Travelled the woods and chopped some trees,,lockedSecret.png,woodsman.png
achvWoodsman,de,Waldmensch,Durschtreife die Wälder,Waldmensch,Die Wälder bereist und Bäume gefällt,,lockedSecret.png,woodsman.png

确保值开头和末尾无空格。类似锁定描述和解锁描述这样的值可能包含空格。

csv文件的区域设置列(第二列)中输入的文本必须与下面"标签"列中的格式匹配:

区域设置

标签

阿拉伯语

ar

丹麦语

da

荷兰语

nl

英语(美国)

en-US

英语(英国)

en-GB

芬兰语

fi

法语

fr

德语

de

意大利语

it

日语

ja

韩语

ko

挪威语

no

波兰语

pl

葡萄牙语(巴西)

pt-BR

俄语

ru

简体中文

zh-Hans

西班牙语(墨西哥)

es-MX

西班牙语(西班牙)

es-ES

瑞典语

sv

泰语

th

繁体中文

zh-Hant

土耳其语

tr

2021年2月23日更新了英语(英国)、瑞典语、繁体中文和简体中文的区域设置代码。请勿导入此日期之前的任何.zip文件。要么更新这些文件以匹配新的区域设置代码,要么重新导出数据。

图标要求

你在 achievementDefinitions.csv 中引用的图标必须存在于导入的当前zip存档中,因为在进行新的导入时,所有之前的内容都将被删除。所有图标都必须采用.png格式,并存在于存档的根级别。你的.zip文件中不可有任何子文件夹。

图标文件名不可包含以下字符,否则会产生开发者门户错误: \ { \^ } % ` ] > [ \~ < # | & $ \@ = ; : + , \? 或空格 ' '

为了消除用户的冗余下载,若引用相同图标,则成就可以共享图标。当多个成就使用同一图像时,可以使用此功能,比如隐藏的成就的"锁定"图标。