> ## 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.
# Configuración de la autenticación de PlayFab con Kongregate y Unity
> Tutorial paso a paso para agregar la autenticación de Kongregate a un título de PlayFab en Unity con WebGL, que abarca la carga de la aplicación de Kongregate y el código de inicio de sesión del jugador.
Este tutorial muestra la configuración mínima necesaria para autenticar a los jugadores en PlayFab mediante Kongregate y Unity.
## Requisitos
* Una cuenta registrada de [Kongregate](https://www.kongregate.com/).
* Familiaridad con la [Guía para desarrolladores de Kongregate](https://www.kongregate.com/developer_center/docs/en/kongregate-api).
* Un título de PlayFab registrado.
* Un proyecto de Unity con PlayFab configurado para el título.
* Compatibilidad con Unity WebGL instalada.
* Familiaridad con [Conceptos básicos de inicio de sesión y procedimientos recomendados](/services/playfab/identity/player-identity/login/login-basics-best-practices).
## Configuración de una aplicación de Kongregate
Kongregate requiere que cargue una versión preliminar de la aplicación antes de obtener acceso a la información necesaria de la aplicación. Nuestro primer paso es preparar un archivo **index.html** con el contenido que se muestra a continuación.
```html theme={null}
Placeholder
```
Vaya al [sitio web de Kongregate](https://www.kongregate.com/).
1. Seleccione la pestaña **Games**.
2. Después, seleccione el botón **Upload your game**.
Se abrirá una página para configurar una nueva aplicación.
1. Asegúrese de escribir el **Application Name**.
2. Escriba una **Game Description**.
3. Después, seleccione una **Category**.
4. Envíe la nueva aplicación seleccionando el botón **Continue**.
Se le transferirá a la página **Application Upload**.
En primer lugar (*y esto es lo más importante*), asegúrese de guardar la dirección URL de la **barra de direcciones web** en un lugar seguro y de fácil acceso. *Esto le ahorrará mucho tiempo al restaurar el acceso a la aplicación una vez que cierre la página*.
1. Una vez hecho esto, seleccione el archivo **index.html** preparado como **Game File**.
2. Después, configure el tamaño de la pantalla.
3. Asegúrese de aceptar todas las licencias necesarias.
4. Por último, cargue la aplicación seleccionando el botón **Upload**.
Cuando se abra la vista previa, ignore el contenido y abra el vínculo **api information**.
Cuando se abra la página **API Information**, busque la **API Key** y guárdela en un lugar seguro y de fácil acceso para su uso posterior.
## Configuración del título de PlayFab
En Game Manager del título de PlayFab:
1. Seleccione **Add-ons** en el menú de la izquierda.
2. Busque y seleccione el icono de **Kongregate**.
Se abrirá una nueva página que le permitirá configurar la integración con **Kongregate**:
1. Escriba la **API Key** que adquirió en la sección anterior.
2. Seleccione el botón **Install Kongregate**.
En este momento, si no recibe ningún mensaje de error, habrá configurado correctamente la integración del título de PlayFab con la aplicación de Kongregate.
## Configuración de un proyecto de Unity
Use esta lista de comprobación de configuración de Unity:
* \[OPCIONAL] Instale las [extensiones del editor de PlayFab](https://aka.ms/playfabunityextension).
* Configure `TitleId` en el objeto Scriptable Object `PlayFabSharedSettings`.
* Para Unity 5.6+, descargue la [plantilla WebGL de Kongregate Preloader](https://github.com/kongregate/webgl-preloader) y colóquela dentro de la carpeta `Assets/WebGLTemplates` **(2)**.
* Para Unity \< 5.6, descargue la [plantilla WebGL de Kongregate Preloader para 5.5 e inferiores](https://github.com/kongregate/webgl-preloader/tree/unity-5.5-and-below) y colóquela dentro de la carpeta `Assets/WebGLTemplates` **(2)**.
Ahora vamos a crear la escena de trabajo.
1. Con fines de prueba, use un lienzo con escalado de pantalla con un par de etiquetas de texto.
Solo necesitaremos *una* etiqueta de texto para mostrar mensajes de depuración.
2. Cree un **GameObject** vacío y cámbiele el nombre a **Kongregate**.
Este `GameObject` contendrá un componente `KongregateHandler` con una etiqueta de texto conectada para los mensajes de depuración.
El código del componente `KongregateHandler` se proporciona a continuación.
```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;
}
```
## Pruebas
La única manera de probar realmente la integración es cargar el prototipo en Kongregate.
1. Abra la ventana **Build** y asegúrese de que **WebGL** esté seleccionado en el menú.
2. Después, abra **Player Settings** seleccionando el botón.
Dentro de la pantalla **Player Settings**, busque la compilación **Settings for WebGL**:
1. Compruebe que el tamaño esté configurado correctamente.
2. Después, seleccione **Kongregate Preloader Template**.
Compile la aplicación y abra la carpeta **Build**.
* Obtendrá un archivo **index.html** y un conjunto de otros archivos (según la versión de Unity).
* Tome todos los archivos excepto **index.html** y colóquelos dentro de un archivo zip, como se muestra en el ejemplo que se proporciona a continuación.
Use la dirección URL que guardó anteriormente para acceder a la página **Application Upload**.
1. Seleccione **index.html** como **Game File**.
2. Después, seleccione el archivo zip como **Additional files**.
* Acepte las licencias y cargue.
Cuando se abra la vista previa, debería poder ver el juego en directo a medida que cambia el mensaje.
Al finalizar, el mensaje debería indicar que el inicio de sesión a través de PlayFab se realizó correctamente.
En este momento, habrá integrado correctamente PlayFab y Kongregate.
## Related topics
- [Autenticación específica de la plataforma](/es/services/playfab/identity/player-identity/platform-specific-authentication/index.md)
- [Configuración de la autenticación de PlayFab con Kongregate y HTML5](/es/services/playfab/identity/player-identity/platform-specific-authentication/kongregate-html5.md)
- [Configuración de la autenticación de PlayFab con Facebook y Unity](/es/services/playfab/identity/player-identity/platform-specific-authentication/facebook-unity.md)
- [Configuración de la autenticación de PlayFab con Steam y Unity](/es/services/playfab/identity/player-identity/platform-specific-authentication/steam-unity.md)
- [Autenticación de PlayFab con el inicio de sesión de Google Play Games en Unity](/es/services/playfab/identity/player-identity/platform-specific-authentication/google-sign-in-unity.md)