SDK pour Unity (PC, Web) / Authentification via le dispositif de lancement d'applications
  Retour à la documentation

SDK pour Unity (PC, Web)

Authentification via le dispositif de lancement d’applications

If you use Xsolla Launcher or Steam to deliver your application to users, you can automatically authenticate the user using the launcher’s credentials.

Instructions

Learn about advanced setups from our how-tos.

Comment configurer l'authentification dans l'application via Launcher

You can use Xsolla Launcher to deliver your application to users and update it. The Launcher contains a built-in authorization tool. To avoid the need to re-enter username and password, set up authorization in your application via the Launcher.

Avis
To use the Launcher, you need to configure Login. Using a different authorization system is not supported.

Configurer le SDK et Launcher pour qu'ils fonctionnent ensemble

  1. Set up Launcher in your Publisher Account.
Note
In the config.json file, it is enough to change the values for the following objects:
  • launcher_project_id — specify Launcher ID found in Publisher Account > Launcher > General settings > General info
  • login_project_id — specify Login ID found in Publisher Account > Launcher > General settings > Authentication
  1. Customize the launcher UI.
Avis
SDKs integration with Xsolla servers uses IGS & BB API calls, so the Launcher store is not supported.
  1. Implement the Launcher authorization logic in your application.
  2. Generate a launcher installation file and a build archive.
  3. Create an application build.
  4. Upload the application build to the Xsolla update server.

Implémenter la logique d'authentification via Launcher

The flow for authorization in the application via Launcher is as follows:

  1. The user is authorized in Launcher.
  2. The user installs and runs the application.
  3. Launcher runs the application and passes user parameters via the command line. The authorization token is passed in the xsolla-login-token parameter.
  4. The application processes command line parameters and obtains a token. An example of a token processing script can be viewed in the demo project.
  5. The application validates the received token. An example of a token validation script can be viewed in the demo project.
  6. The application automatically authorizes the user without displaying an authorization page. An example of a user authorization script can be viewed in the demo project.

Note
The obtained token is used by SDK methods to open an in-game store, make a payment, etc. Pass the token to the Token.Instance property.

Créer un build d'application

  1. Go to your Unity project.
  2. Click Window > Xsolla > Edit Settings in the main menu. In the Inspector panel:
    1. In the Project ID field, specify the Project ID found in Publisher Account > Project settings > Project ID.
    2. In the Login ID field, specify the Login ID found in Publisher Account > Launcher > General settings > Authentication.
  1. Run the user authorization scene, where the token is processed.
  2. Click File > Build settings in the main menu and then click Add Open Scenes. Make sure the authorization scene is added first in the list.
  3. Click Build.
  4. In the pop-up window, specify the path to the directory where the finished build will be placed.
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

Avis
Use this how-to guide if you included the demo project in your Unity project.

Native authentication allows players to enter your application via the installed Steam application.

To set up native authentication:

  1. Set up silent authentication via Steam in Publisher Account.
  2. Configure your Unity project.
  3. Configure processing of events.
  4. Ensure authentication via Steam.

Configurer le projet Unity

  1. Create a steam_appid.txt file and enter your application ID in Steam there. Then, place this file in the Assets/Plugins/Steamworks.NET/redist/ catalog of your project.
Note
If you downloaded the SDK from GitHub, you can find the steam_appid.txt file in the Assets/Plugins/Steamworks.NET/redist/ catalog. This file includes the application ID in Steam for a demo project.
  1. Open your Unity project.
  2. In the main menu, go to Window > Xsolla > Demo Settings.
  3. In the Inspector panel:
    1. Check the Use Steam authorization box.
    2. In the Steam App ID field, specify your application ID in Steam. The value should be the same as the value in the steam_appid.txt file.

Configurer le traitement des événements

To authenticate users via Steam, you should pass a session ticket to the SilentAuth method. For an example, see the SteamAuth.cs class of the demo project.

Vérifier l'authentification via Steam

  1. Create the build of your Unity project for a stand-alone platform or start a scene.
  2. Launch Steam and log in.
  3. Launch your application. If everything is correct, you will be logged into the applictaion automatically.
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: 10 Octobre 2023

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Enté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 !