使用 Kongregate 和 Unity 设置 PlayFab 身份验证 - XBOX Game Development Documentation

本教程向你展示使用 Kongregate 和 Unity 在 PlayFab 中对玩家进行身份验证所需的最小设置。

要求

已注册的 Kongregate 账户。
熟悉 Kongregate 开发者指南。
已注册的 PlayFab title。
为你的 title 配置了 PlayFab 的 Unity 项目。
已安装 Unity WebGL 支持。
熟悉登录基础和最佳实践。

设置 Kongregate 应用

Kongregate 要求你上传应用的预览版本，然后才能访问必要的应用信息。我们的第一步是准备一个包含以下内容的 index.html 文件。

<!doctype html>
<html lang="en-us">
<head></head>
<body>
 <h1>Placeholder</h1>
</body>
</html>

导航到 Kongregate 网站。

选择 Games 选项卡。
然后选择 Upload your game 按钮。

设置新应用的页面将打开。

请务必输入应用程序名称。
输入游戏描述。
然后选择一个类别。
通过选择 Continue 按钮提交新应用。

你将被转移到 Application Upload 页面。首先——最重要的是——请务必将 Web Address Bar 中的 URL 保存在安全且易于访问的位置。这将节省你在关闭页面后恢复对应用程序访问的大量时间。

完成后，选择准备好的 index.html 文件作为你的 Game File。
然后设置屏幕大小。
请务必接受所有必需的许可证。
最后，通过选择 Upload 按钮上传你的应用。

预览打开后，忽略内容并打开 api information 链接。当 API Information 页面打开时，找到 API Key 并将其保存在易于访问的安全位置以供以后使用。

配置 PlayFab title

在你的 PlayFab title Game Manager 中：

从左侧菜单中选择 Add-ons。
找到并选择 Kongregate 图标。

一个新页面将打开，允许你设置 Kongregate 集成：

输入你在上一节中获取的 API Key。
选择 Install Kongregate 按钮。

此时，如果你没有收到错误消息，则表示你已正确配置 PlayFab title 与你的 Kongregate 应用的集成。

设置 Unity 项目

使用此 Unity 设置清单：

[可选] 安装 PlayFab Editor Extensions。
- 在 PlayFabSharedSettings Scriptable Object 中设置你的 TitleId。
对于 Unity 5.6+，下载 Kongregate Preloader WebGL Template，并将其放置在 Assets/WebGLTemplates 文件夹 (2) 中。
对于 Unity < 5.6，下载 Kongregate Preloader WebGL Template 5.5 and below，并将其放置在 Assets/WebGLTemplates 文件夹 (2) 中。

现在让我们创建你的工作场景。

出于测试目的，使用具有几个文本标签的屏幕缩放画布。

我们只需要一个文本标签来显示调试消息。

创建一个空的 GameObject，并将其重命名为 Kongregate。

此 GameObject 将包含一个 KongregateHandler 组件，并与调试消息的文本标签连接。 KongregateHandler 组件的代码如下所示。

// We are specifically interested in importing PlayFab related namespaces
using PlayFab;
using PlayFab.ClientModels;
using UnityEngine;
using UnityEngine.UI;

public class KongregateHandler : MonoBehaviour
{
  
    // Standard unity callback, executed once for the script to start
    public void Start()
    {
        // Utility: show feedback
        SetMessage("Loading kongregate api...");

        /*
         * Important: execute Javascript in the external context to initialize
         * Kongregate API, Unity Support and set up callback GameObject and Method.
         * In this case, callback is set to a GameObject called Kongregate and a
         * method called OnKongregateAPILoaded, which we define later in this class.
         * Once Kongregate API is initialized, Unity will locate this object by name
         * ("Kongregate") and execute a method "OnKongregateAPILoaded" passing in user
         * info string as an argument.
         */
        Application.ExternalEval(
          "if(typeof(kongregateUnitySupport) != 'undefined'){" +
          " kongregateUnitySupport.initAPI('Kongregate', 'OnKongregateAPILoaded');" +
          "} else {" +
          " console.error('No unity support!');" +
          "};"
        );
    }

    /*
     * Executed once Kongregate API is ready. This method is invoked by KongregateAPI
     * and receives a structured text with multiple pieces of data you must parse manually.
     * The userInfo string parameter has the following structure: 'user_identifier|user_name|auth_token'
     */
    public void OnKongregateAPILoaded(string userInfo)
    {
        SetMessage("Received user info! Logging though playfab...");

        // We split userInfo string using '|' character to acquire auth token and Kongregate ID.
        var userInfoArray = userInfo.Split('|');
        var authTicket = userInfoArray[2];
        var kongregateId = userInfoArray[0];

        LogToBrowser("Auth Token: " + authTicket);
        LogToBrowser("Kongregate Id: " + kongregateId);

        /*
         * We then execute PlayFab API call called LoginWithKongregate.
         * LoginWithKongregate requires KongregateID and AuthTicket.
         * We also pass CreateAccount flag, to automatically create player account.
         */
        PlayFabClientAPI.LoginWithKongregate(new LoginWithKongregateRequest
        {
            KongregateId = kongregateId,
            AuthTicket = authTicket,
            CreateAccount = true
        }, OnLoggedIn, OnFailed);
    }

    /*
     * The rest of the code serves as a utility to process results, log debug statements
     * and display them using Text message label.
     */

    private void OnLoggedIn(LoginResult obj)
    {
        SetMessage("Logged in through PlayFab!");
    }
    private void OnFailed(PlayFabError error)
    {
        SetMessage("Failed to login in with PlayFab: " + error.GenerateErrorReport());
    }

    private void SetMessage(string message)
    {
        InfoLabel.text = message;
    }

    private void LogToBrowser(string message)
    {
        Application.ExternalEval(string.Format("console.log('{0}')", message));
    }

    public Text InfoLabel;
}

测试

真正测试集成的唯一方法是将你的原型上传到 Kongregate。

打开 Build 窗口并确保从你的菜单中选择了 WebGL。
然后通过选择按钮打开 Player Settings。

在 Player Settings 屏幕中，找到 Settings for WebGL 构建：

验证你已正确设置大小。
然后选择 Kongregate Preloader Template。

构建应用程序并打开 Build 文件夹。

你最终会得到 index.html 和一堆其他文件（取决于 Unity 版本）。
将除 index.html 之外的所有文件放入 zip 存档中，如下例所示。

使用你之前保存的 URL 访问你的 Application Upload 页面。

选择 index.html 作为你的 Game File。
然后选择 zip 存档作为 Additional files。
- 接受许可证并上传。

预览打开后，你应该能够看到你的游戏实时运行，消息也在变化。完成时，消息应指示通过 PlayFab 成功登录。至此，你已成功集成 PlayFab 和 Kongregate。

​要求

​设置 Kongregate 应用

​配置 PlayFab title

​设置 Unity 项目

​测试

要求

设置 Kongregate 应用

配置 PlayFab title

设置 Unity 项目

测试