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

> PlayFab 统一 SDK v2 概述，它整合了 Core、Services、Multiplayer、Party 和 GameSave，具备统一身份验证和令牌刷新。

PlayFab 统一 SDK 是下一代开发平台，它将所有 PlayFab 客户端库整合到一个内聚产品中。它在所有 PlayFab 组件上提供一致、精简的集成体验，提高了互操作性并简化了客户端开发。

## 概述

独立的 [PlayFab Services C/C++ SDK](/services/playfab/sdks/c)（2023 年发布）引入了现代开发实践，例如自动令牌刷新、改进的内存管理和增强的线程控制。然而，其他独立 SDK（例如 PlayFab Party 和 PlayFab Multiplayer）并未采用这些改进。统一 SDK 将这些组件整合到一个内聚、现代化的 SDK 中。

<Note>
  现有的 PlayFab 独立 SDK (v1) 仍受支持，但我们建议新项目使用 PlayFab 统一 SDK (v2)。
</Note>

## 主要优势

统一 SDK 相较于独立 SDK 提供了重大改进：

* **简化的集成**：单个 SDK 安装和更新过程，无需管理多个 SDK 下载和版本。在 XBOX/Windows 上，SDK 与 GDK 捆绑发布（从 2025 年 10 月 GDK 版本 2510 开始）。

* **统一的身份验证**：通过 `PFAuthentication` API 执行一次身份验证，生成的 `PFEntityHandle` 可跨所有组件使用。组件会内部自动向 Core 服务查询令牌，从而消除手动令牌传递并减少集成错误。

* **自动令牌管理**：集中式令牌刷新逻辑会在后台自动处理实体令牌续期，避免长时间游戏会话期间会话过期。

* **一致的编程模型**：所有组件都遵循初始化、API 调用、错误处理、异步操作和统一日志记录的标准化模式，显著降低学习曲线。

* **高级线程控制和内存管理**：所有组件均支持自定义内存分配器和通过 `XTaskQueue` 集成的高级线程控制，从而实现对资源分配和线程行为的精细控制。

## 支持的平台和游戏引擎

下表显示了 PlayFab 统一 SDK 的平台和游戏引擎支持情况：

| 平台                             | C/C++ SDK                                                    | C/C++ NuGet                                                                                   | Unreal Engine                                          | Unity                                                 |
| ------------------------------ | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------- |
| **Windows（PC 和掌机）**            | GDK 2510+                                                    | —                                                                                             | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **XBOX（One、Series S/X、Cloud）** | GDK 2510+                                                    | —                                                                                             | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **Steam Deck**                 | GDK 2510+                                                    | —                                                                                             | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **PlayStation®5** ¹            | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5)     | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5/_artifacts/feed/PS5GeneralV2)         | ¹                                                      | ¹                                                     |
| **PlayStation®4** ¹            | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4)     | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4/_artifacts/feed/PS4GeneralV2)         | ¹                                                      | ¹                                                     |
| **Nintendo Switch 2** ¹        | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2/_artifacts/feed/Switch2GeneralV2) | ¹                                                      | ¹                                                     |
| **Nintendo Switch** ¹          | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch)  | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch/_artifacts/feed/SwitchGeneralV2)   | ¹                                                      | ¹                                                     |

<Note>
  访问 PlayStation® 和 Nintendo 平台 SDK 需要与相应平台方签订 NDA。有关详细信息，请参阅[申请 SDK 与示例访问权限](/services/playfab/sdks/request-access-for-sdks-samples)。
</Note>

*"PlayStation" 是 Sony Interactive Entertainment Inc. 的商标。*

## 功能可用性

统一 SDK 组件一起发布，但某些功能在当前版本中可能在特定平台上仅有有限或临时可用性。下表总结了本次预览的功能就绪情况。

| 平台                             | Core | Services | GameSave | Multiplayer（Lobby / Matchmaking） | Party Data | Party Voice |
| ------------------------------ | ---- | -------- | -------- | -------------------------------- | ---------- | ----------- |
| **Windows（PC 和掌机）**            | 支持   | 支持       | 支持       | 支持                               | 支持         | 支持          |
| **XBOX（One、Series S/X、Cloud）** | 支持   | 支持       | 支持       | 支持                               | 支持         | 支持          |
| **Steam Deck**                 | 支持   | 支持       | 支持       | 支持                               | 支持         | 支持          |
| **PlayStation®5**              | 支持   | 支持       | 支持（预览）   | 支持                               | 支持         | 支持          |
| **PlayStation®4**              | 支持   | 支持       | —        | 支持                               | 支持         | 支持          |
| **Nintendo Switch 2**          | 支持   | 支持       | —        | 支持                               | 支持         | 支持          |
| **Nintendo Switch**            | 支持   | 支持       | —        | 支持                               | 支持         | 支持          |

破折号 (—) 表示该功能当前在该平台上不受支持。

如果您发现此表与观察到的行为存在不一致，请通过 PlayFab 支持渠道提交问题，以便产品团队更新文档并解决差距。

## SDK 组件

PlayFab 统一 SDK 采用模块化架构，允许您只集成项目所需的组件。在 XBOX/Windows 上，SDK 已包含在 Microsoft GDK 安装中。SDK 为以下组件提供头文件和二进制文件：

* **[libHttpClient](https://github.com/microsoft/libHttpClient)**：XBOX 和 PlayFab SDK 使用的跨平台 HTTP/WebSocket 抽象。提供异步 API、内存管理和重试逻辑。所有 SDK 组件都需要它。可选地与 [XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members) 集成以进行线程管理。
* **[PlayFab Core](/services/playfab/sdks/playfab-sdk-intro)**：所有 PlayFab 组件的基础功能。处理身份验证、实体管理、配置、遥测、日志记录和错误处理。
* **[PlayFab Services](/services/playfab/sdks/playfab-sdk-intro)**：面向 LiveOps、经济和进阶的共享服务。
* **[PlayFab Multiplayer](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)**：大厅创建和匹配服务。
* **[PlayFab Party](/services/playfab/multiplayer/networking/party-sdks/overview)**：低延迟、跨平台的语音、文本聊天和数据通信，可选集成 Azure Cognitive Services 用于语音转文本、文本转语音、翻译等功能。
* **[PlayFab GameSave](/services/playfab/player-progression/game-saves/overview)**：基于云的游戏存档存储和同步，可在设备和会话之间保留玩家进度。

## 开发实践

统一 SDK 将 2023 年 [PlayFab Services C/C++ SDK](/services/playfab/sdks/c) 引入的现代开发实践扩展到所有组件：

* [异步操作](/services/playfab/sdks/unified-sdk/async-model)
* [内存管理](/services/playfab/sdks/unified-sdk/memory-management)
* [跟踪与诊断](/services/playfab/sdks/unified-sdk/debug-trace)

## 版本控制

PlayFab 统一 SDK 遵循[语义化版本控制](https://semver.org/)原则，从 2.0.0 版开始，确保可预测且一致的发布管理。


## Related topics

- [PlayFab for Unity (v2 统一版)](/zh-CN/services/playfab/sdks/unified-unity/overview.md)
- [PlayFab 统一 SDK 快速入门设置](/zh-CN/services/playfab/sdks/unified-sdk/quickstart-setup.md)
- [PlayFab 统一 SDK 中的内存管理](/zh-CN/services/playfab/sdks/unified-sdk/memory-management.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/async-model.md)