gamejolt 中文文档 下载 App

Game API:把成就与分数接进你的游戏

想让你的游戏出现在玩家的主页成就墙上、让玩家之间冲榜对抗,需要接入平台的 Game API。这页给开发者讲机制,给玩家讲判断标准。

验证机制:token 而非密码

官方 API 文档的核心设计(转述):游戏不会拿玩家的用户名密码做验证,而是用「用户名 + 令牌(token)」的组合。平台会尽量自动把这对凭证传给你的游戏:

对开发者来说,这意味着不需要自己做账号系统——身份验证由平台层完成,游戏内直接调用成就与分数接口。

能接入什么

能力说明
奖杯(Trophies)在游戏内达成条件后向平台上报,按青铜到白金分档
分数(Scores)上传分数形成公开排行榜
会话/用户信息获取当前玩家身份用于游戏内展示

玩家侧的体验见游戏内奖杯——那是这套 API 的另一面。

接入建议

  1. 成就设计分层:常规进度给低档杯,隐藏彩蛋给白金杯,兼顾收集控与休闲玩家;
  2. 分数榜要防作弊:只信服务端结算的数据,客户端上报要有合理性校验;
  3. 失败静默:网络不通时成就上报失败不应阻塞游戏,排队重试即可;
  4. 文档以官方为准:API 参数与端点细节随版本演进,接入时以官方 Game API 文档当前版本为准(官方帮助与开发者页都有入口)。

与整体上架流程的位置关系

接入 API 是游戏上架流程里的增强项,不是前置条件——先按建游戏页建页、上传体系传文件,让游戏先能玩;成就与分数随后补上,照样能带动回访。

一句给玩家的话

看到游戏页挂着「奖杯/分数」板块,就说明开发者接入了 API——这通常也意味着开发者对作品的长线运营有投入,是个隐性质量信号(读页指南见读游戏页)。