PlayFab SDK 产品

PlayFab 统一 SDK (v2) 是新一代 PlayFab SDK。它将所有 PlayFab 客户端库整合到一个内聚的产品中。它提供了现代化、精简的开发体验，具备统一身份验证、自动令牌管理，以及所有组件间一致的 API。统一 SDK 是当前开发工作的核心重点——所有新功能、平台支持和改进均优先针对 v2。 对于新项目，如果当前支持的平台满足您的需求，我们推荐使用 PlayFab 统一 SDK (v2)。使用 v1 独立 SDK 的现有项目可以迁移到 v2，以享受统一架构带来的优势。 v1 独立 SDK 目前仍受支持，为需要 v2 尚不支持的平台的项目提供了更广泛的平台覆盖。

​

PlayFab 统一 SDK (v2)

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

​

包含内容

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

​

主要优势

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

​

开发者体验对比

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

​

PlayFab 独立 SDK (v1)

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

​

SDK 组件 (v1)

• PlayFab Services SDK：LiveOps、经济、匹配和数据分析
• PlayFab Party SDK：网络与语音/文本聊天通信
• PlayFab Lobby and Matchmaking SDK：大厅和匹配功能

​

支持的平台

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

​

另请参阅

• PlayFab 统一 SDK (v2)
• 独立 SDK 概述 (v1)
• 申请 SDK 与示例访问权限