跳到主要内容

更新排行榜自S3

作为使用Aghanim API调用的替代方案，您可以将游戏排行榜存储在S3兼容的存储桶中。 Aghanim提供了一个指定的存储桶用于根据我们的推荐方案上传文件。

文件方案​

您的排行榜文件应具有以下结构：

键类型描述
member_idstring由游戏开发者分配的唯一排行榜成员ID。
member_datastring成员数据，如他们的姓名。
member_subdataOptional<string>附加的成员数据，例如他们所属的氏族、团队或公会。
image_urlstring成员头像图片的URL。
scoreinteger反映该成员在其他排行榜成员中成就的数值。

示例：

[
  {
    "member_id": "12345",
    "member_data": "John Doe",
    "member_subdata": "Team Alpha",
    "image_url": "http://example.com/avatar1.png",
    "score": 1500
  },
  {
    "member_id": "67890",
    "member_data": "Jane Smith",
    "member_subdata": "Guild Beta",
    "image_url": "http://example.com/avatar2.png",
    "score": 1200
  }
]

文件命名约定​

为了保持文件整齐，请使用包含时间戳的命名约定，如下所示。 这有助于管理不同版本的排行榜文件。

<LEADERBOARD_ID>-<TIMESTAMP>.<EXTENSION>
  • <LEADERBOARD_ID>：在Aghanim系统中创建排行榜对象时获得的唯一排行榜ID。
  • <TIMESTAMP>：文件创建日期的Unix纪元时间格式。
  • <EXTENSION>：文件扩展名（例如，csv，json，zip，gz）。

示例文件名：

  • CSV: lbrd_eAQiRnTwFaa-1626073200.csv
  • JSON: lbrd_eAQiRnTwFaa-1626073200.json
  • ZIP: lbrd_eAQiRnTwFaa-1626073200.zip
  • GZIP: lbrd_eAQiRnTwFaa-1626073200.gz

上传文件​

支持的文件类型：

  • 原始CSV或JSON文件
  • 包含CSV或JSON文件的压缩（ZIP）或压缩（GZIP）文件

将文件上传到存储桶：

  1. 在Game Hub -> Leaderboards UI部分中创建排行榜或使用Create Leaderboard API调用。
  2. 根据上述要求准备排行榜文件，使用第1步返回的ID作为排行榜ID。
  3. （可选）如果使用ZIP或GZIP格式，压缩文件。
  4. 将准备好的文件上传到Aghanim提供的存储桶。

数据提取频率​

排行榜服务根据上传的文件自动更新排行榜成员。 数据提取的频率由游戏开发者确定，可以设置为每小时、每天、每周或每月。

需要帮助吗？
联系我们的集成团队 integration@aghanim.com