- 获取所需的 JAR 文件。
- 将 JAR 文件添加到类路径中。
- 创建一个最简单的 Java 控制台应用程序,用于执行自定义 ID 登录 API 调用。
获取所需的 JAR 文件
为了使用 PlayFab JavaSDK,我们需要 PlayFab 客户端 JavaSDK 及其依赖项 Google GSON。 在此处下载 PlayFab 客户端 JavaSDK JAR 库。查找 client-sdk-*.jar 以及相应的 Java Doc [可选但很有用]。 你可以在此处下载最新的 Google GSON。查找 gson-*.jar。使用 Intellij Idea 进行项目设置
初始化一个简单的 Intellij Idea Java 项目后,请确保按以下示例所示放置所需的 JAR 文件。 下一步是将 JAR 文件添加到类路径中。导航到 File -> ,,如下例所示。 导航到 Libraries,然后按下图所示添加一个新的 Java 库。 选择你添加到 libs 文件夹中的 JAR 文件,然后如下所示选择 OK。 如果系统要求选择 Module,请选择列表中的第一个。确保所有 JAR 文件都已添加到库列表中。使用任意 IDE 进行项目设置
主要要求是将 JAR 文件添加到类路径中。请查阅你所用 IDE 的指南,了解如何将 JAR 文件添加到类路径中。设置你的第一个 API 调用
使用下面所示的代码作为你的主类代码。完成并执行
要运行应用程序:- 选择右上角的播放箭头 >。这将启动程序执行,并显示输出面板。
- 找到调试消息。这表明 API 调用成功。
代码解析
这个可选的最后一节详细介绍GettingStarted.java 中的每一行。
-
导入
- 这是用于进行 PlayFab API 调用的最小导入集。
-
public static void
main(String[] args) {- 只是一个基本的循环,用于启动 API 调用并等待其完成。
-
PlayFabSettings.TitleId = "xxxx";- 每个 PlayFab 开发者都会在 Game Manager 中创建一个 title。发布游戏时,你必须将该 titleId 编入游戏代码中。这可让客户端知道如何访问 PlayFab 中的正确数据。对于大多数用户来说,只需将其视为使 PlayFab 正常工作的必备步骤即可。
-
PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();- 大多数 PlayFab API 方法都需要输入参数,这些输入参数被打包到一个请求对象中。
-
每个 API 方法都需要一个唯一的请求对象,其中包含可选参数和必需参数的组合。
- 对于
LoginWithCustomIDRequest,有一个必需参数CustomId(唯一标识一个玩家)和CreateAccount(允许通过此调用创建新帐户)。
- 对于
-
对于登录,大多数开发者会希望使用更合适的登录方法。
- 有关所有登录方法及输入参数的列表,请参阅 PlayFab 登录文档。常用选项包括:
LoginWithAndroidDeviceIDLoginWithIOSDeviceIDLoginWithEmailAddress
- 有关所有登录方法及输入参数的列表,请参阅 PlayFab 登录文档。常用选项包括:
-
FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);- 这将使用 Java FutureTask 框架启动对
LoginWithCustomID的异步请求。
- 这将使用 Java FutureTask 框架启动对
-
While (running)
{ if (loginTask.isDone()) { OnLoginComplete(loginTask); } }- 运行一个简单的主循环,并异步等待 loginTask 完成。
- 完成后调用
OnLoginComplete。
-
OnLoginComplete (loginTask)-
result = loginTask.get();- 获取异步结果(这不会导致阻塞,因为我们已确认 FutureTask 已完成)。
-
如果 (
result.Result != null),则 API 调用成功。-
成功时,许多 API 回调的
result.Result对象将包含所请求的信息。 -
LoginResult具体包含有关玩家的一些基本信息。但对大多数用户来说,登录只是调用其他 API 之前的必备步骤。
-
成功时,许多 API 回调的
-
如果 (
result.Error != null),则 API 调用失败。- API 调用可能因多种原因失败,你应始终尝试处理失败情况。
- API 调用失败的原因(按可能性顺序排列)
- 未设置
PlayFabSettings.TitleId。如果你忘记为你的 title 设置TitleId,则任何操作都不会成功。 - 请求参数。如果你没有为特定 API 调用提供正确或必需的信息,则调用将失败。详情请参阅
error.errorMessage、error.errorDetails或error.GenerateErrorReport()。 - 设备连接问题。手机会不断丢失/恢复连接,因此任何时候的任何 API 调用都可能随机失败,然后立即恢复正常。进入隧道可能会使你完全断开连接。
- PlayFab 服务器问题。与所有软件一样,可能会出现问题。请参阅我们的发行说明了解更新信息。
- 互联网并非 100% 可靠。有时消息会损坏或无法到达 PlayFab 服务器。
- 未设置
- 如果你在调试问题时遇到困难,且错误信息中的内容不够详尽,请访问我们的论坛。
-
