> ## 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.

# Multiplayer 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. 在与 libs 文件夹位于同一目录的应用级别 build.gradle 文件中,将以下几行添加到 dependencies 部分。第二行作为 libHttpClient 的依赖项是必需的。

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


## Related topics

- [PlayFab Multiplayer C++ SDK 发行说明](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Android 快速入门](/zh-CN/services/playfab/sdks/c/quickstart-android.md)
- [PlayFab Economy 旧版、Unity IAP、Android 入门](/zh-CN/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android.md)
- [Android 推送通知](/zh-CN/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notifications-for-android.md)
- [使用 Economy v2、Unity IAP 和 Android 快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android.md)