SDK de nivel empresarial para Unity / Autenticación a través del lanzador de aplicaciones
  Volver a Documentos

SDK de nivel empresarial para Unity

Autenticación a través del lanzador de aplicaciones

Si utiliza Xsolla Launcher o Steam para suministrar su aplicación a los usuarios, puede autenticar automáticamente al usuario mediante las credenciales del lanzador.

Instrucciones

Conozca más sobre las configuraciones avanzadas en nuestros procedimientos.

Cómo establecer la autenticación en la aplicación mediante Launcher

Puede utilizar Xsolla Launcher para suministrar su aplicación a los usuarios y actualizarla. Launcher contiene una herramienta de autorización integrada. Para no tener que reintroducir el nombre de usuario y la contraseña, establezca la autorización en su aplicación mediante Launcher.

Aviso

Para utilizar Launcher, debe configurar Login. No se admite el uso de un sistema de autorización diferente.

El SDK utiliza la IGS API para trabajar con la tienda. Launcher utiliza su propia API, por lo que el SDK no admite el funcionamiento con la tienda de Launcher.

Para establecer la autenticación de usuario descentralizada:
  1. Implemente la Lógica de autorización de Launcher en su aplicación.
  2. Cree una compilación de la aplicación y súbala a Launcher.
Nota
En la guía de integración se ofrece información detallada sobre la configuración de Launcher y la carga de la compilación de la aplicación.

Implementar la lógica para la autenticación mediante Launcher

El flujo de autorización en la aplicación mediante Launcher es el siguiente:

  1. El usuario se autoriza en Launcher.
  2. El usuario instala y ejecuta la aplicación.
  3. Launcher ejecuta la aplicación y transmite parámetros de usuario a través de la línea de comandos. El token de autorización se transmite en el parámetro xsolla-login-token.
  4. La aplicación procesa los parámetros de la línea de comandos y obtiene un token.
  5. La aplicación valida el token recibido.
  6. La aplicación autoriza automáticamente al usuario sin mostrar una página de autorización.

Para implementar la lógica descrita, utilice el método del SDK AuthViaXsollaLauncher.

Ejemplo de script para la autenticación mediante el Lanzador:

Copy
Full screen
Small screen
using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Authorization
{
	public class AuthorizationViaXsollaLauncher : MonoBehaviour
	{
		private void Start()
		{
			// Start authorization via Xsolla Launcher
			// Pass callback functions for success and error cases
			XsollaAuth.AuthViaXsollaLauncher(OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Crear una compilación de la aplicación

  1. Vaya a su proyecto de Unity.
  2. Asegúrese de que los Ajustes del SDK indican el ID de proyecto de Login especificado en su Cuenta del editor en los ajustes de Launcher (Launcher > General settings > Authentication).

  1. Ejecuta la escena de autorización de usuario, en la que se procesa el token.
  2. Haga clic en File > Build settings en el menú principal y, a continuación, haga clic en Add Open Scenes. Asegúrese de que la escena de autorización se añade en el primer lugar en la lista.
  3. Haga clic en Build.
  4. En la ventana emergente, especifique la ruta al directorio en el que se colocará la compilación finalizada.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Ocultar

Cómo configurar la autenticación nativa a través de Steam

La autenticación nativa permite a los jugadores acceder a su aplicación a través de la aplicación de Steam instalada.

Para establecer la autenticación nativa:

  1. Establezca la autenticación silenciosa a través de Steam en Cuenta del editor.
  2. Configure su proyecto de Unity.
  3. Implemente la lógica para la autenticación a través de Steam.
  4. Garantice la autenticación a través de Steam.

Configurar su proyecto de Unity

Nota
El SDK utiliza la biblioteca de Steamworks.NET para interactuar con Steam, que incorpora el SDK y está ubicado en el directorio Assets/Xsolla/ThirdParty/Steamworks.NET.
  1. Abra el archivo steam_appid.txt, que está ubicado en la carpeta raíz del proyecto de Unity.
  2. Especifique el ID de su aplicación en Steam en el archivo y guarde los cambios. El valor predeterminado en el archivo es 480, el cual es el ID del proyecto de prueba de Steam.
  3. Reinicie el editor de Unity para que los cambios surtan efecto.

Implementar la lógica para la autenticación mediante el Steam

Para iniciar la autenticación, utilice el método del SDK SilentAuth y transmítale los siguientes parámetros:

  • providerName - la plataforma de publicación de la aplicación. Transmita steam como valor.
  • appId - el ID de su aplicación en Steam. El valor debe coincidir con el valor especificado en el archivo steam_appid.txt.
  • sessionTicket - ticket de sesión de Steam. Para obtenerlo, llame al método SteamUtils.GetSteamSessionTicket().
  • onSuccess - devolución de llamada de autenticación de usuario realizada correctamente.
  • onError - devolución de llamada de error.

Ejemplo de script para la autenticación mediante Steam:

Copy
Full screen
Small screen
using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Steam
{
	public class SteamNativeAuthorization : MonoBehaviour
	{
		private void Start()
		{
			// Get the steam session ticket from `SteamUtils` class
			var steamSessionTicket = SteamUtils.GetSteamSessionTicket();

			// Start silent authentication
			// Pass `steam` as `providerName` parameter
			// Pass your `Steam App ID` as `appId` parameter. We use `480` as an example
			// Pass `steamSessionTicket` variable as the `sessionTicket` parameter
			// Pass callback functions for success and error cases
			XsollaAuth.SilentAuth("steam", "480", steamSessionTicket, OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Garantizar la autenticación a través de Steam

  1. Lance Steam e inicie sesión. De lo contrario, se llama a la función de devolución de llamada con el error Requested steam session ticket is null. Please check your Steam settings.
  2. Cree la compilación de su proyecto de Unity para una plataforma independiente y ejecútala o inicie una escena en el editor de Unity. Si todo es correcto, se le iniciará sesión automáticamente en la aplicación.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Ocultar
Última actualización: 10 de Octubre de 2023

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!