- 取得必要的 JAR 檔案。
- 將 JAR 檔案新增至類別路徑。
- 建立最精簡的 Java 主控台應用程式,以執行自訂識別碼登入 API 呼叫。
取得必要的 JAR 檔案
若要使用 PlayFab JavaSDK,我們需要 PlayFab Client JavaSDK 及其相依性 Google GSON。 請在這裡下載 PlayFab Client JavaSDK JAR 程式庫。尋找 client-sdk-*.jar 以及對應的 Java Doc (選擇性,但很實用)。 您可以在這裡下載最新的 Google GSON。尋找 gson-*.jar。使用 Intellij Idea 設定專案
初始化簡單的 Intellij Idea Java 專案後,請務必依照下列範例所示放置必要的 JAR 檔案。




使用任何 IDE 設定專案
主要需求是將 JAR 檔案新增至類別路徑。請參閱您 IDE 的指南,了解如何將 JAR 檔案新增至類別路徑。設定您的第一次 API 呼叫
使用下方所示的程式碼作為您的主要類別程式碼。完成並執行
若要執行應用程式:- 選取右上角的 play arrow >。這會開始執行程式,並顯示輸出面板。
- 找到偵錯訊息。這表示 API 呼叫已成功。

解構程式碼
這個選擇性的最後一節會詳細說明GettingStarted.java 中的每一行。
-
Imports
- 這是進行 PlayFab API 呼叫所使用的最精簡 import 集合。
-
public static void
main(String[] args) {- 只是一個基本迴圈,會啟動 API 呼叫並等候其完成。
-
PlayFabSettings.TitleId = "xxxx";- 每位 PlayFab 開發人員都會在 Game Manager 中建立遊戲。當您發佈遊戲時,必須將該 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。如果您忘記將TitleId設定為您的遊戲,則一切都無法運作。 - 要求參數。如果您沒有為特定 API 呼叫提供正確或必要的資訊,呼叫就會失敗。如需詳細資訊,請參閱
error.errorMessage、error.errorDetails或error.GenerateErrorReport()。 - 裝置連線問題。行動電話會不斷失去/恢復連線,因此任何 API 呼叫都可能隨時隨機失敗,然後又立即恢復正常。進入隧道可能會讓您完全中斷連線。
- PlayFab 伺服器問題。就像所有軟體一樣,可能會發生問題。如需更新資訊,請參閱我們的版本資訊。
- 網際網路並非 100% 可靠。有時訊息會損毀或無法送達 PlayFab 伺服器。
- 未設定
- 如果您在偵錯問題時遇到困難,而錯誤資訊中的內容又不足夠,請造訪我們的論壇。
-
