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

Pour en savoir plus sur les configurations avancées, consultez nos instructions.

Comment configurer l'authentification dans l'application via Launcher

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.

Avis

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 Shop Builder API pour interagir avec le magasin. Launcher utilise sa propre API. Le SDK ne permet donc pas d’interagir avec le magasin Launcher.

Pour configurer l’authentification utilisateur de bout en bout :
  1. Implémentez la logique d’autorisation de Launcher dans votre application.
  2. Créez un build d’application et téléchargez-le vers Launcher.
Note
Des informations détaillées sur les paramètres de Launcher et le téléchargement du build de l’application sont disponibles dans le guide d’intégration.

Implémenter la logique d'authentification via Launcher

Flux d’autorisation dans l’application via Launcher :

  1. L’utilisateur est autorisé dans Launcher.
  2. L’utilisateur installe et exécute l’application.
  3. 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.
  4. L’application traite les paramètres de la ligne de commande et obtient un jeton.
  5. L’application valide le jeton obtenu.
  6. 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 :

Copy
Full screen
Small screen
 1using UnityEngine;
 2using Xsolla.Auth;
 3using Xsolla.Core;
 4
 5namespace Xsolla.Samples.Authorization
 6{
 7	public class AuthorizationViaXsollaLauncher : MonoBehaviour
 8	{
 9		private void Start()
10		{
11			// Start authorization via Xsolla Launcher
12			// Pass callback functions for success and error cases
13			XsollaAuth.AuthViaXsollaLauncher(OnSuccess, OnError);
14		}
15
16		private void OnSuccess()
17		{
18			Debug.Log("Authorization successful");
19			// Add actions taken in case of success
20		}
21
22		private void OnError(Error error)
23		{
24			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
25			// Add actions taken in case of error
26		}
27	}
28}

Créer un build d'application

  1. Accédez au projet Unity.
  2. Assurez-vous que les paramètres du SDK indiquent l'ID du projet de Login spécifié dans le Compte éditeur dans les paramètres du lanceur (Distribution > Launcher > General settings > Authentication).

  1. Exécutez la scène d'autorisation utilisateur, où le jeton est traité.
  2. Cliquez sur File > Build settings dans le menu principal, puis sur Add Open Scenes. Assurez-vous que la scène d'autorisation est ajoutée en premier dans la liste.
  3. Cliquez sur Build.
  4. Dans la fenêtre contextuelle, spécifiez le chemin d'accès au répertoire où le build terminé sera placé.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Masquer

Comment configurer l'authentification native via Steam

L’authentification native permet aux joueurs d’accéder à votre application via l’application Steam installée.

Pour configurer l’authentification native :

  1. Configurez l’authentification silencieuse via Steam dans le Compte éditeur.
  2. Configurez le projet Unity.
  3. Initialisez Steamworks.NET.
  4. Implémentez la logique d’authentification via Steam.
  5. Vérifiez l’authentification via Steam.

Configurer le projet Unity

  1. Installez la bibliothèque Steamworks.NET dans votre projet Unity.
  2. Configurez les paramètres nécessaires dans le fichier steam_appid.txt. Pour ce faire :
    1. Ouvrez le fichier steam_appid.txt, qui se trouve dans le dossier racine du projet Unity. Si le fichier est manquant, créez-le.
    2. 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.
    3. Redémarrez l'éditeur Unity pour appliquer les modifications.

Initialisez Steamworks.NET

Avant d’appeler des méthodes de la bibliothèque Steamworks.NET, assurez-vous que la bibliothèque est initialisée.

Pour des raisons de commodité, il est recommandé d’utiliser la classe prête à l’emploi SteamManager. Elle gère l’initialisation de la bibliothèque Steamworks.NET, appelle automatiquement la méthodeSteamAPI.Shutdown() à la fermeture de l’application et fournit la propriété SteamManager.Initialized pour vérifier l’état de l’initialisation.

Si Steam n’est pas en cours d’exécution ou si l’initialisation de la bibliothèque Steamworks.NET échoue, SteamManager s’arrête proprement et fournit un moyen sécurisé de vérifier l’état :

Copy
Full screen
Small screen
1if (!SteamManager.Initialized)
2{
3    Debug.LogWarning("Steam is not initialized. Working with the API is not possible.");
4    return;
5}

Ajoutez la classe SteamManager à la scène initiale du jeu en tant que composant d’un objet de jeu distinct. Elle doit exister en tant que singleton et persister entre les scènes.

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. Passez steam comme valeur ;
  • appId — ID de votre application dans Steam. La valeur doit correspondre à la valeur spécifiée dans le fichier steam_appid.txt ;
  • sessionTicket — ticket de session Steam. Pour l'obtenir, appelez la méthode SteamUtils.GetSteamSessionTicket() ;
  • onSuccess — fonction de rappel d'authentification utilisateur réussie ;
  • onError — fonction de rappel d'erreur.

Exemple de script d’authentification via Steam :

Copy
Full screen
Small screen
 1using UnityEngine;
 2using Xsolla.Auth;
 3using Xsolla.Core;
 4
 5namespace Xsolla.Samples.Steam
 6{
 7	public class SteamNativeAuthorization : MonoBehaviour
 8	{
 9		private void Start()
10		{
11			// Ensure that the Steamworks API is initialized !!!
12
13			// Get the steam session ticket from `SteamUtils` class
14			var steamSessionTicket = SteamUtils.GetSteamSessionTicket();
15
16			// Start silent authentication
17			// Pass `steam` as `providerName` parameter
18			// Pass your `Steam App ID` as `appId` parameter. We use `480` as an example
19			// Pass `steamSessionTicket` variable as the `sessionTicket` parameter
20			// Pass callback functions for success and error cases
21			XsollaAuth.SilentAuth("steam", "480", steamSessionTicket, OnSuccess, OnError);
22		}
23
24		private void OnSuccess()
25		{
26			Debug.Log("Authorization successful");
27
28			// Add actions taken in case of success
29		}
30
31		private void OnError(Error error)
32		{
33			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
34
35			// Add actions taken in case of error
36		}
37	}
38}

Vérifier l'authentification via Steam

  1. 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.
  2. Créez le build de votre projet Unity pour une plateforme autonome et exécutez-le ou lancez une scène dans l'éditeur Unity. Si tout est bien configuré, vous serez automatiquement connecté à l'application.

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Masquer
Dernière mise à jour: 29 Août 2025

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !
Impossible d'envoyer votre commentaire
Réessayez plus tard ou contactez-nous à doc_feedback@xsolla.com.