MAJACLOUD 文档
为你的游戏打造的自托管后端:玩家账号、排行榜、带签名的远程配置、云存档和奖励,并提供 Unity、Godot 和 Web SDK。
代码注释和 API 名称保留英文,以便与 SDK 保持一致。
选择你的引擎#
Unity 是主要 SDK,并附带可直接运行的示例场景。Godot 和网页游戏使用相同的项目、密钥和服务。
Unity SDK 推荐适用于 Unity 2021.3+ 的 C# SDK,提供 async 和协程 API,并附带 Starter 场景。 Godot SDK适用于 Godot 4.2+ 的 GDScript 插件,提供自动加载(autoload)和编辑器内设置。 Web SDK单个 JavaScript 文件,适用于 HTML5 游戏、网站和 Node.js 服务器。 REST API纯 HTTPS 和 JSON,适用于任何其他引擎、工具或服务器。
服务#
玩家游客登录在重启后依然有效,之后可升级为邮箱或 Google 账号。 排行榜最佳或最新分数,从每日到每月的重置,以及防作弊分数范围。 远程配置实时修改配置值;每个响应都经过签名和验证。 云存档按玩家存储的 JSON 文档,带修订号和冲突检测。 奖励由服务器判定的每日、每周或一次性奖励。
工作原理#
- 在控制台中创建项目。你会获得项目 ID、公开的客户端密钥和私密密钥。
- 在游戏中添加 SDK,并粘贴基础 URL、项目 ID 和客户端密钥。
- 让玩家登录。首次调用会创建一个游客;会话会被保存,并在下次启动时恢复。
- 调用服务。每个请求都会连同请求 ID 显示在项目的日志页面上。