> ## 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 for Unity (v2 统一版)

> 开始使用 PlayFab for Unity (v2 统一版),这是替代 v1 Services、Multiplayer 和 Party 插件的单一 UPM 包。

PlayFab for Unity (v2 统一版) 是基于 [PlayFab 统一 SDK](/services/playfab/sdks/unified-sdk/overview) 构建的新一代 Unity 集成。它以单个 Unity Package Manager (UPM) 包的形式分发。

此包取代了三个独立的 v1 Unity 包:[PlayFab Unity SDK](/services/playfab/sdks/unity3d) (Services REST 封装)、[v1 PlayFab Multiplayer for Unity 插件](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview) 和 [v1 PlayFab Party for Unity 插件](/services/playfab/multiplayer/networking/party-unity-overview)。

<Info>
  所有新项目都应使用 PlayFab for Unity (v2 统一版)。你不能在同一项目中同时使用 v1 和 v2。
</Info>

## 主要优势

PlayFab for Unity 将统一 SDK 的现代架构带给了 Unity:

* **单一包**:一次 UPM 安装即可获得 PlayFab Core、Services、Multiplayer(大厅和匹配)以及 Party。你不再需要单独的 Services、Multiplayer 和 Party 包。

* **统一身份验证**:当你使用 `PFAuthentication` 登录时,它会生成一个统一的实体句柄,供 Services 和 Multiplayer 重用。不再需要为每个组件调用 `SetEntityToken` 或为每次调用跟踪 `PlayFabAuthenticationContext`。

* **自动令牌管理**:后台进程会刷新实体令牌。你不再需要手动重新登录。

* **一致的异步模型**:Services 和 Multiplayer 调用使用统一 SDK 的异步模式,取代了 v1 的 `(request, onSuccess, onError)` 回调对。

* **原生 HTTP 和序列化**:与跨引擎为统一 SDK 提供支持的相同原生 `libHttpClient` 处理 HTTP 流量。由 `PFHttpConfig` 进行配置。不再需要 v1 的可插拔传输 (`ITransportPlugin`) 和 JSON 序列化器 (`ISerializerPlugin`)。

* **感知 GDK 的编辑器工具**:你已安装的 Microsoft Gaming Development Kit (GDK) 会自动解析原生二进制文件。可通过 **PlayFab → Change GDK** 菜单在已安装的 GDK 版本之间切换。

## 支持的平台

PlayFab for Unity 官方支持:

* **Windows**(XBOX 商店及其他 PC 商店)
* **XBOX**(One、Series S|X、Cloud)

对其他平台的支持即将推出。

## 入门

有关设置、安装、前提条件、示例场景和故障排除的信息可在 GitHub 仓库中找到:

**[GitHub 上的 PlayFab Unity SDK](https://github.com/PlayFab/PlayFabSDK_Unity)**

## 相关资源

* [PlayFab 统一 SDK 概述](/services/playfab/sdks/unified-sdk/overview)
* [v1 PlayFab Unity3D SDK](/services/playfab/sdks/unity3d)
* [v1 PlayFab Multiplayer for Unity 插件](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview)
* [v1 PlayFab Party for Unity 插件](/services/playfab/multiplayer/networking/party-unity-overview)


## Related topics

- [PlayFab for Unreal Engine 概述](/zh-CN/services/playfab/sdks/unified-unreal/overview.md)
- [PlayFab 统一 SDK](/zh-CN/services/playfab/sdks/unified-sdk/overview.md)
- [PlayFab Economy 旧版、Unity IAP、Android 入门](/zh-CN/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android.md)
- [从 PlayFab 独立 SDK v1 迁移到统一 SDK v2](/zh-CN/services/playfab/sdks/unified-sdk/migrating-from-v1.md)
- [PlayFab 统一 SDK 快速入门设置](/zh-CN/services/playfab/sdks/unified-sdk/quickstart-setup.md)