Authentification via le dispositif de lancement d’applications
Si vous utilisez Xsolla Launcher ou Steam pour distribuer votre application aux utilisateurs, vous pouvez automatiquement authentifier l’utilisateur à l’aide des informations d’identification du dispositif de lancement d’applications.
Instructions
Vous pouvez utiliser Xsolla Launcher pour distribuer votre application aux utilisateurs et la mettre à jour. Launcher contient un outil d’autorisation intégré. Pour éviter aux utilisateurs de saisir chaque fois leur nom d’utilisateur et leur mot de passe, configurez l’autorisation dans votre application via Launcher.
Pour utiliser Launcher, vous devez d’abord configurer Login. L’utilisation d’un autre système d’autorisation n’est pas prise en charge.
Le SDK utilise IGS API pour interagir avec le magasin. Launcher utilise sa propre API. Le SDK ne permet donc pas d’interagir avec le magasin Launcher.
- Implémentez la logique d’autorisation de Launcher dans votre application.
- Créez un build d’application et téléchargez-le vers Launcher.
Implémenter la logique d'authentification via Launcher
Flux d’autorisation dans l’application via Launcher :
- L’utilisateur est autorisé dans Launcher.
- L’utilisateur installe et exécute l’application.
- Launcher exécute l’application et passe les paramètres utilisateur par le biais de la ligne de commande. Le jeton d’autorisation est passé dans le paramètre
xsolla-login-token
. - L’application traite les paramètres de la ligne de commande et obtient un jeton.
- L’application valide le jeton obtenu.
- L’application autorise automatiquement l’utilisateur sans afficher de page d’autorisation.
Pour implémenter la logique décrite, utilisez la méthode SDK AuthViaXsollaLauncher
.
Exemple de script d’authentification via Launcher :
- 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
}
}
}
Créer un build d'application
- Accédez à votre projet Unity.
- Assurez-vous que les paramètres du SDK indiquent l'ID du projet de connexion spécifié dans votre Compte éditeur dans les paramètres ded Launcher (Launcher > General settings > Authentication).
- Exécutez la scène d'autorisation utilisateur, où le jeton est traité.
- Cliquez sur
File > Build settings dans le menu principal, puis surAdd Open Scenes . Assurez-vous que la scène d'autorisation est ajoutée en premier dans la liste. - Cliquez sur
Build . - Dans la fenêtre contextuelle, spécifiez le chemin d'accès au répertoire où le build terminé sera placé.
L’authentification native permet aux joueurs d’accéder à votre application via l’application Steam installée.
Pour configurer l’authentification native :
- Configurez l’authentification silencieuse via Steam dans le Compte éditeur.
- Configurez votre projet Unity.
- Implémentez la logique d’authentification via Steam.
- Vérifiez l’authentification via Steam.
Configurer le projet Unity
Assets/Xsolla/ThirdParty/Steamworks.NET
.- Ouvrez le fichier
steam_appid.txt
, qui se trouve dans le dossier racine du projet Unity. - Spécifiez l'ID de votre application dans Steam dans le fichier et enregistrez les modifications. La valeur par défaut du fichier est
480
, qui correspond à l'ID Steam du projet de test. - Redémarrez l'éditeur Unity pour que les modifications prennent effet.
Implémenter la logique d'authentification via Steam
Pour démarrer l’authentification, utilisez la méthode SDK SilentAuth
et passez-lui les paramètres suivants :
providerName
— plateforme de publication de l'application. Passezsteam
comme valeur ;appId
— ID de votre application dans Steam. La valeur doit correspondre à la valeur spécifiée dans le fichiersteam_appid.txt
;sessionTicket
— ticket de session Steam. Pour l'obtenir, appelez la méthodeSteamUtils.GetSteamSessionTicket()
;onSuccess
— fonction de rappel d'authentification utilisateur réussie ;onError
— fonction de rappel d'erreur.
Exemple de script d’authentification via 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
}
}
}
Vérifier l'authentification via Steam
- Lancez Steam et connectez-vous. Sinon, la fonction de rappel est appelée avec l'erreur
Requested steam session ticket is null. Please check your Steam settings
. - Créez le build de votre projet Unity pour une plateforme standalone et exécutez-le ou lancez une scène dans l'éditeur Unity. Si tout est bien configuré, vous serez automatiquement connecté à l'application.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.