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
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.
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.
- Implemente la Lógica de autorización de Launcher en su aplicación.
- Cree una compilación de la aplicación y súbala a Launcher.
Implementar la lógica para la autenticación mediante Launcher
El flujo de autorización en la aplicación mediante Launcher es el siguiente:
- El usuario se autoriza en Launcher.
- El usuario instala y ejecuta la aplicación.
- 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
. - La aplicación procesa los parámetros de la línea de comandos y obtiene un token.
- La aplicación valida el token recibido.
- 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:
- C#
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
- Vaya a su proyecto de Unity.
- 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).
- Ejecuta la escena de autorización de usuario, en la que se procesa el token.
- Haga clic en
File > Build settings en el menú principal y, a continuación, haga clic enAdd Open Scenes . Asegúrese de que la escena de autorización se añade en el primer lugar en la lista. - Haga clic en
Build . - En la ventana emergente, especifique la ruta al directorio en el que se colocará la compilación finalizada.
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:
- Establezca la autenticación silenciosa a través de Steam en Cuenta del editor.
- Configure su proyecto de Unity.
- Implemente la lógica para la autenticación a través de Steam.
- Garantice la autenticación a través de Steam.
Configurar su proyecto de Unity
Assets/Xsolla/ThirdParty/Steamworks.NET
.- Abra el archivo
steam_appid.txt
, que está ubicado en la carpeta raíz del proyecto de Unity. - 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. - 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. Transmitasteam
como valor.appId
- el ID de su aplicación en Steam. El valor debe coincidir con el valor especificado en el archivosteam_appid.txt
.sessionTicket
- ticket de sesión de Steam. Para obtenerlo, llame al métodoSteamUtils.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:
- C#
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
- 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
. - 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.
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.