先决条件
在开始之前,请完成快速入门设置中的设置步骤,以配置您的开发环境和项目。您将完成的内容
在本快速入门结束时,您将:- 在 Windows 项目中设置了 PlayFab 统一 SDK
- 使用您的 Title ID 初始化了 SDK
- 使用 XBOX 或 Steam 对玩家进行了身份验证
- 获取了用于进行 API 调用的实体句柄
- 正确清理了资源
本快速入门内容
步骤 1:初始化 SDK
包含所需的头文件
首先在项目中包含必要的 PlayFab 和 XBOX Game Runtime 头文件:初始化 XBOX Gaming Runtime Services
PlayFab 统一 SDK 需要 XBOX Game Runtime。首先初始化它:初始化 PlayFab Core
初始化 PlayFab SDK 并创建服务配置句柄。将ABCDEF 替换为您实际的 PlayFab 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 调用
- 调用 PlayFab 服务 - 学习如何调用 PlayFab API 来管理玩家数据和使用游戏服务
核心概念
高级身份验证
- 多平台身份验证 - 支持多种身份验证提供商
- 自定义 ID 身份验证 - 使用您自己的身份验证系统
- 账户链接 - 将多种身份验证方式链接到一个账户
