Skip to main content
本指南向您展示如何使用统一 SDK 进行 PlayFab 服务 API 调用。您将学习如何调用各种 PlayFab 服务来管理玩家数据、检索文件以及与其他 PlayFab 功能进行交互。

先决条件

在开始之前,请确保您已:
本指南假设您已按照 Core 快速入门指南初始化了 PlayFab SDK 并对玩家进行了身份验证。如果尚未完成,请先完成该指南。

您将完成的内容

在本快速入门结束时,您将:
  • 检索了已通过身份验证的玩家的实体键
  • 进行了第一次 PlayFab 服务 API 调用
  • 处理了 PlayFab 服务的响应

进行第一次服务 API 调用

身份验证成功后,可使用登录期间获取的 PFEntityHandle 进行 PlayFab API 调用。此示例展示了如何检索存储的当前玩家文件。

步骤 1:获取实体键

首先,从已通过身份验证的实体句柄中检索实体键:

步骤 2:调用 GetFiles API

现在进行第一次 PlayFab 服务调用,以获取与玩家关联的文件:
🎉 **恭喜!**您已成功使用统一 SDK 进行了第一次 PlayFab 服务 API 调用。

理解 API 调用模式

所有 PlayFab 服务 API 调用都遵循相似的模式:
  1. 准备请求 - 创建并填充请求结构体
  2. 发起异步调用 - 调用 *Async 函数
  3. 等待完成 - 使用 XAsyncGetStatus 等待操作完成
  4. 获取结果大小 - 调用 *GetResultSize 以确定缓冲区需求
  5. 检索结果 - 调用 *GetResult 以获取实际数据
一旦理解了基础,此模式适用于所有 PlayFab 服务 API,从而可以方便地使用不同的服务。

后续步骤

现在您已成功调用了 PlayFab 服务,可以探索这些附加功能:

常见服务 API

  • 玩家数据管理 - 存储和检索自定义玩家数据
  • 玩家统计 - 跟踪玩家统计数据和成就
  • Title Data - 访问游戏配置数据
  • Cloud Script - 执行服务器端逻辑

高级功能

  • 排行榜 - 通过排名实现竞争性功能
  • 经济和货币化 - 添加虚拟货币和物品
  • 多人游戏 - 集成匹配和大厅服务
  • 分析 - 跟踪玩家行为和游戏指标

最佳实践

故障排除

常见问题及解决方案: 有关更详细的错误信息,请在应用程序中启用跟踪与诊断

参考文档

最后修改于 2026年8月25日