> ## 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 v1 独立 SDK 与 v2 统一 SDK 产品线，为新项目或现有游戏项目选择合适的客户端库。

**PlayFab 统一 SDK (v2)** 是新一代 PlayFab SDK。它将所有 PlayFab 客户端库整合到一个内聚的产品中。它提供了现代化、精简的开发体验，具备统一身份验证、自动令牌管理，以及所有组件间一致的 API。统一 SDK 是当前开发工作的核心重点——所有新功能、平台支持和改进均优先针对 v2。

**对于新项目**，如果当前支持的平台满足您的需求，我们推荐使用 **PlayFab 统一 SDK (v2)**。**使用 v1 独立 SDK 的现有项目**可以[迁移到 v2](/services/playfab/sdks/unified-sdk/migrating-from-v1)，以享受统一架构带来的优势。

**v1 独立 SDK** 目前仍受支持，为需要 v2 尚不支持的平台的项目提供了更广泛的平台覆盖。

<Info>
  v1 和 v2 SDK 不能在同一项目中一起使用。如果您需要 v2 尚不支持的平台，请对所有组件使用 v1。
</Info>

## PlayFab 统一 SDK (v2)

[PlayFab 统一 SDK](/services/playfab/sdks/unified-sdk/overview) 用一个涵盖所有 PlayFab 功能的内聚产品，取代了原本各自独立的 v1 SDK 包集合。您不再需要独立下载、安装和更新多个 SDK，而是使用一个包含所需全部功能的 SDK。

### 包含内容

统一 SDK 将以下组件打包为单一安装：

| 组件                      | 描述                                  |
| ----------------------- | ----------------------------------- |
| **PlayFab Core**        | 身份验证、实体管理、遥测和日志记录                   |
| **PlayFab Services**    | LiveOps、经济、进阶和数据分析                  |
| **PlayFab GameSave**    | 云存档存储和同步                            |
| **PlayFab Multiplayer** | 大厅创建、匹配和会话管理                        |
| **PlayFab Party**       | 实时网络、语音聊天和文本通信，集成 Azure AI Services |

### 主要优势

* **单一 SDK**：所有 PlayFab 功能只需一次安装和更新过程——不再需要单独管理 Services、Party 和 Multiplayer 的独立包
* **统一身份验证**：一次身份验证即可获取一个可在所有组件中使用的 `PFEntityHandle`。不再需要在服务之间手动获取和传递实体令牌
* **自动令牌管理**：后台令牌刷新可自动处理实体令牌续期，避免长时间游戏过程中会话过期，且无需编写任何变通代码
* **一致的编程模型**：所有组件都遵循标准化的初始化、API 调用、错误处理和异步操作模式——学会一种模式即可到处使用
* **自定义内存管理**：通过 `PFMemoryHooks` 接入自己的内存分配器，在资源受限或高性能环境中实现精细控制
* **高级线程控制**：`XTaskQueue` 集成提供了灵活的调度模式（Manual、ThreadPool、SerializedThreadPool、Immediate），让您能精确控制异步工作的执行方式和位置
* **内置调试跟踪**：可扩展的跟踪系统，可从单一调试输出监控所有组件的 API 请求、响应和错误
* **面向未来**：所有新的 PlayFab 功能、平台扩展和性能改进均仅针对 v2

<Tip>
  已在使用 v1？请参阅[从 v1 迁移到 v2](/services/playfab/sdks/unified-sdk/migrating-from-v1) 获取分步指南。迁移通常会通过移除手动令牌管理和统一各组件间的初始化逻辑来简化您的代码库。
</Tip>

### 开发者体验对比

以下示例说明了 v2 如何相较于 v1 简化常见任务：

| 任务       | v1（独立 SDK）               | v2（统一 SDK）                       |
| -------- | ------------------------ | -------------------------------- |
| **设置**   | 分别下载和配置每个 SDK            | 只需安装一个包含所有组件的 SDK                |
| **身份验证** | 手动获取实体令牌、在服务之间传递，并在过期前刷新 | 一次登录，获取 `PFEntityHandle`，传递给任何组件 |
| **令牌刷新** | 编写自定义刷新逻辑以避免会话过期         | 在后台自动处理                          |
| **错误处理** | 每个 SDK 使用不同的错误模式         | 所有组件采用一致的错误报告                    |

## PlayFab 独立 SDK (v1)

[v1 独立 SDK](/services/playfab/sdks/sdk-overview) 由针对不同 PlayFab 功能的独立 SDK 包组成。虽然它们仍然完全受支持，但需要管理多个 SDK 安装并在组件之间手动协调。v1 SDK 会继续收到关键修复，但新功能和平台支持仅面向 v2 开发。

### SDK 组件 (v1)

* [**PlayFab Services SDK**](/services/playfab/sdks/playfab-sdk-intro)：LiveOps、经济、匹配和数据分析
* [**PlayFab Party SDK**](/services/playfab/multiplayer/networking/party-sdks/overview)：网络与语音/文本聊天通信
* [**PlayFab Lobby and Matchmaking SDK**](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)：大厅和匹配功能

## 支持的平台

下表对比了 v2 统一 SDK 与 v1 独立 SDK 之间的平台支持情况：

| 平台                         | v2（统一 SDK） | v1（独立 SDK） |
| -------------------------- | :--------: | :--------: |
| Windows（PC 和掌机）            |    ✅ 支持    |    ✅ 支持    |
| XBOX（One、Series S/X、Cloud） |    ✅ 支持    |    ✅ 支持    |
| Steam Deck                 |    ✅ 支持    |   ❌ 当前不支持  |
| PlayStation 4 ¹            |    ✅ 支持    |    ✅ 支持    |
| PlayStation 5 ¹            |    ✅ 支持    |    ✅ 支持    |
| Nintendo Switch ¹          |    ✅ 支持    |    ✅ 支持    |
| Nintendo Switch 2 ¹        |    ✅ 支持    |    ✅ 支持    |
| Linux                      |   ❌ 当前不支持  |    ✅ 支持    |
| iOS                        |   ❌ 当前不支持  |    ✅ 支持    |
| Android                    |   ❌ 当前不支持  |    ✅ 支持    |
| macOS                      |   ❌ 当前不支持  |    ✅ 支持    |

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

## 另请参阅

* [PlayFab 统一 SDK (v2)](/services/playfab/sdks/unified-sdk/overview)
* [独立 SDK 概述 (v1)](/services/playfab/sdks/sdk-overview)
* [申请 SDK 与示例访问权限](/services/playfab/sdks/request-access-for-sdks-samples)


## Related topics

- [PlayFab 统一 SDK](/zh-CN/services/playfab/sdks/unified-sdk/overview.md)
- [PlayFab Services SDK 2026 发行说明](/zh-CN/services/playfab/release-notes/index.md)
- [PlayFab Services SDK 2025 年发行说明](/zh-CN/services/playfab/release-notes/2025.md)
- [PlayFab Services SDK 2023 版本发布说明](/zh-CN/services/playfab/release-notes/2023.md)
- [PlayFab Services SDK 2024 版本发布说明](/zh-CN/services/playfab/release-notes/2024.md)