> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 使用 Kongregate 和 Unity 设置 PlayFab 身份验证
> 使用 WebGL 将 Kongregate 身份验证添加到 Unity 中 PlayFab title 的分步教程，涵盖 Kongregate 应用上传和玩家登录代码。
本教程向你展示使用 Kongregate 和 Unity 在 PlayFab 中对玩家进行身份验证所需的最小设置。
## 要求
* 已注册的 [Kongregate](https://www.kongregate.com/) 账户。
* 熟悉 [Kongregate 开发者指南](https://www.kongregate.com/developer_center/docs/en/kongregate-api)。
* 已注册的 PlayFab title。
* 为你的 title 配置了 PlayFab 的 Unity 项目。
* 已安装 Unity WebGL 支持。
* 熟悉[登录基础和最佳实践](/services/playfab/identity/player-identity/login/login-basics-best-practices)。
## 设置 Kongregate 应用
Kongregate 要求你上传应用的预览版本，然后才能访问必要的应用信息。我们的第一步是准备一个包含以下内容的 **index.html** 文件。
```html theme={null}
Placeholder
```
导航到 [Kongregate 网站](https://www.kongregate.com/)。
1. 选择 **Games** 选项卡。
2. 然后选择 **Upload your game** 按钮。
设置新应用的页面将打开。
1. 请务必输入**应用程序名称**。
2. 输入**游戏描述**。
3. 然后选择一个**类别**。
4. 通过选择 **Continue** 按钮提交新应用。
你将被转移到 **Application Upload** 页面。
首先——*最重要的是*——请务必将 **Web Address Bar** 中的 URL 保存在安全且易于访问的位置。*这将节省你在关闭页面后恢复对应用程序访问的大量时间。*
1. 完成后，选择准备好的 **index.html** 文件作为你的 **Game File**。
2. 然后设置屏幕大小。
3. 请务必接受所有必需的许可证。
4. 最后，通过选择 **Upload** 按钮上传你的应用。
预览打开后，忽略内容并打开 **api information** 链接。
当 **API Information** 页面打开时，找到 **API Key** 并将其保存在易于访问的安全位置以供以后使用。
## 配置 PlayFab title
在你的 PlayFab title Game Manager 中：
1. 从左侧菜单中选择 **Add-ons**。
2. 找到并选择 **Kongregate** 图标。
一个新页面将打开，允许你设置 **Kongregate** 集成：
1. 输入你在上一节中获取的 **API Key**。
2. 选择 **Install Kongregate** 按钮。
此时，如果你没有收到错误消息，则表示你已正确配置 PlayFab title 与你的 Kongregate 应用的集成。
## 设置 Unity 项目
使用此 Unity 设置清单：
* \[可选] 安装 [PlayFab Editor Extensions](https://aka.ms/playfabunityextension)。
* 在 `PlayFabSharedSettings` Scriptable Object 中设置你的 `TitleId`。
* 对于 Unity 5.6+，下载 [Kongregate Preloader WebGL Template](https://github.com/kongregate/webgl-preloader)，并将其放置在 `Assets/WebGLTemplates` 文件夹 **(2)** 中。
* 对于 Unity \< 5.6，下载 [Kongregate Preloader WebGL Template 5.5 and below](https://github.com/kongregate/webgl-preloader/tree/unity-5.5-and-below)，并将其放置在 `Assets/WebGLTemplates` 文件夹 **(2)** 中。
现在让我们创建你的工作场景。
1. 出于测试目的，使用具有几个文本标签的屏幕缩放画布。
我们只需要*一个*文本标签来显示调试消息。
2. 创建一个空的 **GameObject**，并将其重命名为 **Kongregate**。
此 `GameObject` 将包含一个 `KongregateHandler` 组件，并与调试消息的文本标签连接。
`KongregateHandler` 组件的代码如下所示。
```csharp theme={null}
// 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。
1. 打开 **Build** 窗口并确保从你的菜单中选择了 **WebGL**。
2. 然后通过选择按钮打开 **Player Settings**。
在 **Player Settings** 屏幕中，找到 **Settings for WebGL** 构建：
1. 验证你已正确设置大小。
2. 然后选择 **Kongregate Preloader Template**。
构建应用程序并打开 **Build** 文件夹。
* 你最终会得到 **index.html** 和一堆其他文件（取决于 Unity 版本）。
* 将除 **index.html** 之外的所有文件放入 zip 存档中，如下例所示。
使用你之前保存的 URL 访问你的 **Application Upload** 页面。
1. 选择 **index.html** 作为你的 **Game File**。
2. 然后选择 zip 存档作为 **Additional files**。
* 接受许可证并上传。
预览打开后，你应该能够看到你的游戏实时运行，消息也在变化。
完成时，消息应指示通过 PlayFab 成功登录。
至此，你已成功集成 PlayFab 和 Kongregate。
## Related topics
- [特定平台的身份验证](/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/index.md)
- [使用 Kongregate 和 HTML5 设置 PlayFab 身份验证](/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/kongregate-html5.md)
- [使用 Steam 和 Unity 设置 PlayFab 身份验证](/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/steam-unity.md)
- [使用 Facebook 和 Unity 设置 PlayFab 身份验证](/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/facebook-unity.md)
- [使用 Google 和 HTML5 设置 PlayFab 身份验证](/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/google-html5.md)