SDK pour Unreal Engine / Authentification via le dispositif de lancement d'applications
  Retour à la documentation

SDK pour Unreal Engine

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'autorisation 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 IGS 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'autorisation 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.

Un exemple d’implémentation de cette logique est disponible dans le blueprint W_LoginDemo du projet de démo.

Note
Le jeton obtenu est utilisé par les méthodes SDK pour ouvrir le magasin en jeu, effectuer un paiement, etc.

Créer un build d'application

  1. Accédez à votre projet Unreal Engine.
  2. 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 de Launcher (Launcher > General settings > Authentication).
  3. Dans Content Browser, ouvrez la carte d'autorisation utilisateur où le jeton est en cours de traitement.
  4. Accédez à Edit > Project Settings dans le menu principal.
  5. Accédez à Project > Maps & Modes et, dans le champ Game Default Map, sélectionnez la carte d'autorisation précédemment ouverte.

  1. Accédez à File > Package Project > Windows (64 bit) ou à File > Package Project > Mac dans le menu principal, en fonction de la plateforme pour laquelle vous créez le build.
  2. Dans la fenêtre contextuelle, spécifiez le chemin d'accès au répertoire dans lequel la compilation terminée sera placée.
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 le client Steam installé. Après avoir configuré l’authentification native via Steam, ajoutez le paiement via Steam à l’application si nécessaire.

Pour configurer l’authentification native :

  1. Configurez l’authentification silencieuse via Steam dans le Compte éditeur.
  2. Configurez votre projet Unreal Engine.
  3. Configurez le traitement des événements.
  4. Vérifiez l’authentification via Steam.

Configurer le projet Unreal Engine

  1. Accédez au catalogue Config de votre projet Unreal Engine.
  2. Ajoutez les lignes ci-dessous au fichier DefaultEngine.ini et spécifiez votre ID d'application dans Steam au paramètre SteamDevAppId.
Copy
Full screen
Small screen
    [/Script/Engine.GameEngine]
    +NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="OnlineSubsystemSteam.SteamNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")
    
    [OnlineSubsystem]
    DefaultPlatformService=Steam
    
    [OnlineSubsystemSteam]
    bEnabled=true
    SteamDevAppId=480
    
    [/Script/OnlineSubsystemSteam.SteamNetDriver]
    NetConnectionClassName="OnlineSubsystemSteam.SteamNetConnection"
    
    1. Ouvrez le projet dans l'éditeur Unreal.
    2. Accédez à Settings > Plugins > Online Platform.
    3. Dans le module Online Subsystem Steam, cochez la case Enabled et cliquez sur le bouton Restart Now pour enregistrer les paramètres et recharger l'éditeur Unreal.

    Configurer le traitement des événements

    1. L'image ci-dessous illustre comment ajouter des nœuds au projet :

      Pour authentifier les utilisateurs via Steam, commencez par obtenir un session ticket en utilisant la méthode GetSessionTicket. Ensuite, lors de l'appel à la méthode AuthenticateWithSessionTicket, passez la valeur obtenue afin d'obtenir le jeton à utiliser dans vos appels API.

    1. Pour une validation supplémentaire du jeton, ajoutez le rappel à la méthode ValidateToken (facultatif).

    Vérifier l'authentification via Steam

    1. Créez le build de votre projet Unreal Engine pour une plateforme standalone.
    2. Lancez Steam et connectez-vous.
    3. Lancez votre application. Si tout est bien configuré, la fenêtre contextuelle Steam s'affiche.
    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 !