> ## 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 入門

> 在 Android 上整合 PlayFab Lobby 和 Matchmaking C++ SDK 所需的 Android 建置設定、NDK、JNI 初始化和資訊清單權限。

# PlayFab Multiplayer Android C++ SDK 入門

本文件列出將 PlayFab Multiplayer 整合至您的 Android 應用程式的基本必要條件和步驟。

## 必要條件

* [PlayFab 開發人員帳戶](https://developer.playfab.com)。
* 已安裝 [Android Studio](https://developer.android.com/studio)。

## 專案設定

從 [PlayFab Multiplayer 版本頁面](https://github.com/PlayFab/PlayFabMultiplayer/releases)將 PlayFab Multiplayer 下載至您的專案。

### 將 PlayFab Multiplayer 整合至您自己的專案

接下來的步驟假設您已使用 Android Studio 建立新專案。

#### 將二進位檔新增至您的遊戲

您需要將二進位檔的兩個部分整合至專案中：共用物件檔案 (.so) 和 Android 封存檔案 (.aar)。您可以自行建置二進位檔，也可以從版本頁面下載。

#### 新增 .so 檔案

這些檔案使用 CMake 整合至您的專案中。

1. 將 Android 版本的 PlayFab Multiplayer Android zip 檔案解壓縮，並將其內容放在您想要的目錄中。

2. 使用 `TARGET_INCLUDE_DIRECTORIES` 或其他對等函式，新增 PlayFab Multiplayer 版本中 "Include" 下的標頭：

```cmake theme={null}
TARGET_INCLUDE_DIRECTORIES(
    ${PROJECT_NAME}
    "Include"
)
```

3. 使用 `TARGET_LINK_LIBRARIES` 或其他對等函式，將 .so 檔案的位置連結至您的專案。

   例如：

```cmake theme={null}
set(PLAYFAB_MULTIPLAYER_PATH "[LOCATION OF YOUR FILE]/libPlayFabMultiplayer.so")

TARGET_LINK_LIBRARIES(
    [YOUR PROJECT NAME]
    ${PLAYFAB_MULTIPLAYER_PATH}
)
```

#### 新增 .aar 檔案

這些檔案使用 Gradle 整合至您的專案中。

1. 在應用程式層級的 Android 專案目錄中建立 libs 資料夾。
2. 將 .aar 檔案複製到 libs 資料夾中。
   > **注意：**如果您的專案已包含 `libHttpClient` 作為相依性，請確保只連結**一個** `libHttpClient.Android-release.aar` 執行個體，以避免重複符號錯誤。
3. 在應用程式層級的 build.gradle 檔案 (與 libs 資料夾位於相同目錄的檔案) 中，將這些行新增至 dependencies 區段。第二行是 libHttpClient 所需的相依性。

```gradle theme={null}
implementation fileTree(dir: 'libs', include: ['*.aar'])
implementation 'com.squareup.okhttp3:okhttp:4.9.1'
```


## Related topics

- [多人遊戲伺服器快速入門 (MpsAllocator 範例)](/zh-TW/services/playfab/multiplayer/servers/mps-allocator-sample.md)
- [PlayFab 多人遊戲文件](/zh-TW/services/playfab/multiplayer/index.md)
- [多人遊戲活動的範例程式碼](/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [多人遊戲](/zh-TW/services/xbox-services/multiplayer/index.md)
- [跨平台多人遊戲設計指引](/zh-TW/services/xbox-services/multiplayer/overviews/multiplayer-design-guidance-cross-platform.md)