概述
独立的 PlayFab Services C/C++ SDK（2023 年发布）引入了现代开发实践，例如自动令牌刷新、改进的内存管理和增强的线程控制。然而，其他独立 SDK（例如 PlayFab Party 和 PlayFab Multiplayer）并未采用这些改进。统一 SDK 将这些组件整合到一个内聚、现代化的 SDK 中。现有的 PlayFab 独立 SDK (v1) 仍受支持，但我们建议新项目使用 PlayFab 统一 SDK (v2)。
主要优势
统一 SDK 相较于独立 SDK 提供了重大改进：- 简化的集成：单个 SDK 安装和更新过程，无需管理多个 SDK 下载和版本。在 XBOX/Windows 上，SDK 与 GDK 捆绑发布（从 2025 年 10 月 GDK 版本 2510 开始）。
-
统一的身份验证：通过
PFAuthenticationAPI 执行一次身份验证，生成的PFEntityHandle可跨所有组件使用。组件会内部自动向 Core 服务查询令牌，从而消除手动令牌传递并减少集成错误。 - 自动令牌管理：集中式令牌刷新逻辑会在后台自动处理实体令牌续期，避免长时间游戏会话期间会话过期。
- 一致的编程模型：所有组件都遵循初始化、API 调用、错误处理、异步操作和统一日志记录的标准化模式，显著降低学习曲线。
-
高级线程控制和内存管理：所有组件均支持自定义内存分配器和通过
XTaskQueue集成的高级线程控制，从而实现对资源分配和线程行为的精细控制。
支持的平台和游戏引擎
下表显示了 PlayFab 统一 SDK 的平台和游戏引擎支持情况：访问 PlayStation® 和 Nintendo 平台 SDK 需要与相应平台方签订 NDA。有关详细信息，请参阅申请 SDK 与示例访问权限。
功能可用性
统一 SDK 组件一起发布，但某些功能在当前版本中可能在特定平台上仅有有限或临时可用性。下表总结了本次预览的功能就绪情况。
破折号 (—) 表示该功能当前在该平台上不受支持。
如果您发现此表与观察到的行为存在不一致，请通过 PlayFab 支持渠道提交问题，以便产品团队更新文档并解决差距。
SDK 组件
PlayFab 统一 SDK 采用模块化架构，允许您只集成项目所需的组件。在 XBOX/Windows 上，SDK 已包含在 Microsoft GDK 安装中。SDK 为以下组件提供头文件和二进制文件：- libHttpClient：XBOX 和 PlayFab SDK 使用的跨平台 HTTP/WebSocket 抽象。提供异步 API、内存管理和重试逻辑。所有 SDK 组件都需要它。可选地与 XTaskQueue 集成以进行线程管理。
- PlayFab Core：所有 PlayFab 组件的基础功能。处理身份验证、实体管理、配置、遥测、日志记录和错误处理。
- PlayFab Services：面向 LiveOps、经济和进阶的共享服务。
- PlayFab Multiplayer：大厅创建和匹配服务。
- PlayFab Party：低延迟、跨平台的语音、文本聊天和数据通信，可选集成 Azure Cognitive Services 用于语音转文本、文本转语音、翻译等功能。
- PlayFab GameSave：基于云的游戏存档存储和同步，可在设备和会话之间保留玩家进度。