Skip to main content
本指南向您展示如何将 PlayFab 统一 SDK 集成到 Windows 项目中、初始化 SDK 并对玩家进行身份验证。这是进行 PlayFab API 调用的基础。

先决条件

在开始之前,请完成快速入门设置中的设置步骤,以配置您的开发环境和项目。

您将完成的内容

在本快速入门结束时,您将:
  • 在 Windows 项目中设置了 PlayFab 统一 SDK
  • 使用您的 Title ID 初始化了 SDK
  • 使用 XBOX 或 Steam 对玩家进行了身份验证
  • 获取了用于进行 API 调用的实体句柄
  • 正确清理了资源

本快速入门内容

  1. 初始化 SDK
  2. 对玩家进行身份验证
  3. 清理资源

步骤 1:初始化 SDK

包含所需的头文件

首先在项目中包含必要的 PlayFab 和 XBOX Game Runtime 头文件:

初始化 XBOX Gaming Runtime Services

PlayFab 统一 SDK 需要 XBOX Game Runtime。首先初始化它:

初始化 PlayFab Core

初始化 PlayFab SDK 并创建服务配置句柄。将 ABCDEF 替换为您实际的 PlayFab Title ID:
您可以在 Game Manager 控制面板的游戏设置中找到您的 Title ID。

步骤 2:对玩家进行身份验证

PlayFab 要求在进行 API 调用之前完成玩家身份验证。SDK 提供了多种身份验证方法,取决于您的平台和需求。

选择身份验证方法

选项 A:使用 XBOX 登录(推荐用于 Windows/XBOX)

使用 PFAuthenticationLoginWithXUserAsync 通过 XBOX 用户账户登录。这是 Windows 和 XBOX 应用程序推荐的方法。

选项 B:使用 Steam 登录

对于集成 Steam 的游戏,使用 PFAuthenticationLoginWithSteamAsync 并附带 Steam 身份验证票据。
从登录返回的 PFEntityHandle 是所有后续 PlayFab API 调用所必需的。请在应用程序的整个生命周期内保留此句柄。

步骤 3:清理资源

当应用程序关闭时,正确清理所有资源以防止内存泄漏并确保正常终止:
始终按照初始化的相反顺序清理资源,以确保正确关闭。

后续步骤

现在您已初始化 SDK 并对玩家进行了身份验证,可以开始调用 PlayFab 服务:

进行第一次 API 调用

核心概念

高级身份验证

  • 多平台身份验证 - 支持多种身份验证提供商
  • 自定义 ID 身份验证 - 使用您自己的身份验证系统
  • 账户链接 - 将多种身份验证方式链接到一个账户

故障排除

常见问题及解决方案:

参考文档

最后修改于 2026年8月25日