跳至主要内容

从 S3 更新排行榜

作为使用阿哈利姆 API 调用的替代方法，您可以将游戏排行榜数据存储在 S3 兼容的存储桶中。 阿哈利姆提供了一个指定的存储桶，用于按照我们推荐的 Schema 上传文件。

File Schema

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

键名类型描述
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>：在阿哈利姆中 创建排行榜 对象时获得的唯一排行榜 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. 在 游戏枢纽 -> 排行榜 UI 部分创建排行榜或使用 Create Leaderboard API 调用。
  2. 按照上述要求准备排行榜文件，使用第 1 步返回的 ID 作为排行榜 ID。
  3. （可选）如果使用 ZIP 或 GZIP 格式，请压缩文件。
  4. 将准备好的文件上传到阿哈利姆提供的存储桶。

数据拉取频率

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

需要技术支持？
联系我们的集成技术团队： integration@aghanim.com

On this page