> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 適用於原生與 Android Studio 的 Java 快速入門
> 下載 PlayFab Java 用戶端 SDK JAR 檔案、設定類別路徑，並在原生 Java 或 Android 中進行您的第一次 LoginWithCustomID API 呼叫。
本快速入門可讓您開始使用 PlayFab JavaSDK 和簡單的 Java 程式。
您必須先擁有 [PlayFab 開發人員帳戶](https://developer.playfab.com)，才能呼叫任何 PlayFab API。
本教學課程的目標如下：
* 取得必要的 JAR 檔案。
* 將 JAR 檔案新增至類別路徑。
* 建立最精簡的 Java 主控台應用程式，以執行[自訂識別碼登入 API 呼叫](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid)。
## 取得必要的 JAR 檔案
若要使用 PlayFab JavaSDK，我們需要 PlayFab Client JavaSDK 及其相依性 Google GSON。
請在[這裡](https://github.com/PlayFab/JavaSDK/tree/versioned/builds)下載 PlayFab Client JavaSDK JAR 程式庫。尋找 **client-sdk-\*.jar** 以及對應的 Java Doc (選擇性，但很實用)。
您可以在[這裡](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.0/)下載最新的 Google GSON。尋找 **gson-\*.jar**。
## 使用 Intellij Idea 設定專案
初始化簡單的 Intellij Idea Java 專案後，請務必依照下列範例所示放置必要的 JAR 檔案。
下一步是將 JAR 檔案新增至類別路徑。如下列範例所示，瀏覽至 **File** -> **,**。
瀏覽至 **Libraries**，然後如下方圖片所示新增 Java 程式庫。
選取您新增至 libs 資料夾的 JAR 檔案，然後選取 **OK**，如下所示。
如果系統要求您選擇 **Module**，請選取清單中的第一個。確定所有 JAR 檔案都已新增至程式庫清單。
## 使用任何 IDE 設定專案
主要需求是將 JAR 檔案新增至類別路徑。請參閱您 IDE 的指南，了解如何將 JAR 檔案新增至類別路徑。
## 設定您的第一次 API 呼叫
使用下方所示的程式碼作為您的主要類別程式碼。
```java theme={null}
import java.util.concurrent.*;
import java.util.*;
import com.playfab.PlayFabErrors.*;
import com.playfab.PlayFabSettings;
import com.playfab.PlayFabClientModels;
import com.playfab.PlayFabClientAPI;
public class Main
{
private static boolean _running = true;
public static void main(String[] args) {
PlayFabSettings.TitleId = "144";
PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
request.CustomId = "GettingStartedGuide";
request.CreateAccount = true;
FutureTask> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
loginTask.run();
while (_running) {
if (loginTask.isDone()) { // You would probably want a more sophisticated way of tracking pending async API calls in a real game
OnLoginComplete(loginTask);
}
// Presumably this would be your main game loop, doing other things
try {
Thread.sleep(1);
} catch(Exception e) {
System.out.println("Critical error in the example main loop: " + e);
}
}
}
private static void OnLoginComplete(FutureTask> loginTask) {
PlayFabResult result = null;
try {
result = loginTask.get(); // Wait for the result from the async call
} catch(Exception e) {
System.out.println("Exception in PlayFab api call: " + e); // Did you assign your PlayFabSettings.TitleId correctly?
}
if (result != null && result.Result != null) {
System.out.println("Congratulations, you made your first successful API call!");
} else if (result != null && result.Error != null) {
System.out.println("Something went wrong with your first API call.");
System.out.println("Here's some debug information:");
System.out.println(CompileErrorsFromResult(result));
}
_running = false; // Because this is just an example, successful login triggers the end of the program
}
// This is a utility function we haven't put into the core SDK yet. Feel free to use it.
private static