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

# PlayFab 统一 SDK 快速入门设置

> 针对随 2025 年 10 月 GDK 发布的 PlayFab 统一 SDK 的 Windows 先决条件和 Visual Studio 项目设置，包括 include、lib 和 DLL 步骤。

## 要求

* [PlayFab 开发者账户](https://developer.playfab.com)
  * 完成[快速入门：Game Manager](/services/playfab/live-service-management/gamemanager/quickstart)以设置您的 PlayFab 账户。
* [Visual Studio 2019 或 2022](https://visualstudio.microsoft.com/)
  * 对于 GDK 开发，请参阅 [SDK 和工具要求](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/getstarted/overviews/sdk-and-tools#install-visual-studio)

## 项目设置

下载并安装 2025 年 10 月（或更高版本）的 Microsoft Game Development Kit (GDK)，其中包含 PlayFab 统一 SDK。

### 配置项目编译和链接

1. **附加包含目录**
   * 右键单击您的 Visual Studio 项目并选择**属性**。
   * 转到 **C/C++ > 常规**。
   * 将 SDK 的 `include` 文件夹（例如 `$(GameDKLatest)\windows\include`）添加到**附加包含目录**。
2. **附加库目录**
   * 转到**链接器 > 常规**。
   * 将 SDK 的 `lib` 文件夹（例如 `$(GameDKLatest)\windows\lib\x64`）添加到**附加库目录**。
3. **附加依赖项**
   * 转到**链接器 > 输入**。
   * 将 SDK 的 `lib` 文件夹中所需的 SDK `.lib` 文件添加到**附加依赖项**（例如 `xgameruntime.lib`、`PlayFabCore.lib`、`PlayFabServices.lib`、`PlayFabMultiplayer.lib`、`Party.lib` 等）。
4. **运行时依赖项**
   * 将 SDK 的 `bin` 文件夹中所需的 SDK `.dll` 文件（例如 `$(GameDKLatest)\windows\bin\x64`）复制到项目的输出目录（例如 `libHttpClient.dll`、`PlayFabCore.dll`、`PlayFabServices.dll`、`PlayFabMultiplayer.dll`、`Party.dll` 等）。

### 故障排除设置问题

如果遇到链接问题，请确保已安装 Visual Studio 生成工具和库（版本 17.5 或更高）。在 Visual Studio Installer 中，为 VS2022 选择**修改**并添加所需的组件。

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/c/win32_1.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=dc25ef683659f85a70a09b93b2ec6c94" alt="Install 17.5 Build Tools" width="635" height="279" data-path="images/playfab/sdks/c/win32_1.png" />


## Related topics

- [Unity 快速入门](/zh-CN/services/playfab/sdks/unity3d/quickstart.md)
- [快速入门 (Windows) - 调用 PlayFab 服务](/zh-CN/services/playfab/sdks/unified-sdk/quickstart-services.md)
- [PlayFab Online Subsystem (OSS) 快速入门](/zh-CN/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart.md)
- [快速入门 (Windows) - Core SDK 设置](/zh-CN/services/playfab/sdks/unified-sdk/quickstart-core.md)
- [快速入门 (Windows) - Party 和 Multiplayer](/zh-CN/services/playfab/sdks/unified-sdk/quickstart-windows-party.md)