​

快速入门:设置和获取玩家数据

开始使用 PlayFab 玩家数据。本快速入门向你展示如何使用 Unity 中的 C# 以及使用 PlayFab CloudScript 设置和检索玩家数据。 玩家数据是适用于单个玩家或玩家群体(共享数据)的信息,由 PlayFab 存储为键值对 (KVP)。本文介绍了客户端 API 调用,可以从任何进程或上下文中安全调用。它还介绍了服务器 API 调用,这些调用仅应从你控制的专用服务器进程或经过精心保护的 CloudScript 调用中进行。服务器 API 需要你的开发密钥。该密钥不应提供给客户端或与客户端一起发布。

​

要求

• 一个 PlayFab 开发者帐户。
• 已安装的 Unity 编辑器副本。要通过 Unity Hub 安装个人使用的 Unity,或安装专业使用的 Unity+,请参阅下载 Unity。

• Unity 项目可以是:
  • 一个全新的项目。有关更多信息,请参阅首次启动 Unity。
  • 一个引导式教程项目。有关更多信息,请参阅Unity 入门。
  • 一个现有项目。
• PlayFab Unity3D SDK。

有关设置 PlayFab Unity3D SDK 的信息,请参阅快速入门:Unity 中 C# 的 PlayFab 客户端库一文。本文确保你拥有 PlayFab 帐户并正确配置了 Unity3D SDK。

​

关于代码示例

本文中的 C# 示例是为 Unity SDK 编写的。Unity SDK 使用事件驱动模型来处理非同步任务。若要使用 C# SDK 运行示例代码,必须修改代码以使用 async Task 模型。需要修改的方法在签名中的方法名末尾附加了 Async。例如,Unity SDK 中的 SetObject 在 C# SDK 中变为 SetObjectAsync。有关更多信息,请参阅使用 async 和 await 的异步编程。 尽管你可以使用现有的 Unity 项目,但本快速入门假设你使用的是完成快速入门:Unity 中 C# 的 PlayFab 客户端库时创建的示例。

​

Game Manager 中的玩家数据

你可以随时通过 Game Manager 执行以下步骤来获取和设置玩家数据。

• 打开 Game Manager。如果你不熟悉它,请参阅 Game Manager 快速入门。
• 选择 Players 选项卡。
• 选择玩家的名称以访问 Players Account 选项卡。
• 选择 Player Data 选项卡以查看其数据。

​

添加设置玩家数据和检索玩家数据的方法

1. 在 Unity 编辑器中,打开你的示例项目。
2. 在 Project 窗口中,打开 Assets > Scripts,然后打开 PlayFabLogin 脚本。
3. 在 Visual Studio 中,在 using 语句中添加以下内容: using System.Collections.Generic;
4. 若要设置玩家数据,请向 PlayFabLogin 类添加 SetUserData 方法。SetUserData 使用 UpdateUserData 方法为已登录的玩家创建或更新玩家数据。 该方法创建(或更新,如果键值对 (KVPS) 已存在)键为 Ancestor 值为 Arthur,以及键为 Successor 值为 Fred 的 KVP。
   void SetUserData() {
       PlayFabClientAPI.UpdateUserData(new UpdateUserDataRequest() {
           Data = new Dictionary<string, string>() {
               {"Ancestor", "Arthur"},
               {"Successor", "Fred"}
           }
       },
       result => Debug.Log("Successfully updated user data"),
       error => {
           Debug.Log("Got error setting user data Ancestor to Arthur");
           Debug.Log(error.GenerateErrorReport());
       });
   }
   
5. 若要获取玩家数据,请向 PlayFabLogin 类添加 GetUserData 方法。SetUserData 使用 GetUserData 方法检索指定玩家的玩家数据。
   void GetUserData(string myPlayFabId) {
       PlayFabClientAPI.GetUserData(new GetUserDataRequest() {
           PlayFabId = myPlayFabId,
           Keys = null
       }, result => {
           Debug.Log("Got user data:");
           if (result.Data == null || !result.Data.ContainsKey("Ancestor")) Debug.Log("No Ancestor");
           else Debug.Log("Ancestor: "+result.Data["Ancestor"].Value);
       }, (error) => {
           Debug.Log("Got error retrieving user data:");
           Debug.Log(error.GenerateErrorReport());
       });
   }
   
6. 在 OnLoginSuccess 方法中调用 SetUserData 和 GetUserData。
   private void OnLoginSuccess(LoginResult result) {
       Debug.Log("Congratulations, you made your first successful API call!");
       SetUserData();
       GetUserData(result.PlayFabId);
   }
   
7. 保存文件。

​

运行示例

在 Unity 编辑器中,选择播放按钮。成功后,调用结果将显示在控制台窗口中。

​

另请参阅

• 如何设置内部玩家数据
• 如何获取内部玩家数据
• 如何设置只读玩家数据
• 如何获取只读玩家数据
• 如何从 CloudScript 修改只读或内部玩家数据
• Title Data 快速入门
• 使用发布者数据
• CloudScript 快速入门