Comment intégrer Launcher à Epic Games Store

Comment ça marche

Vous pouvez intégrer votre jeu avec Launcher sur Epic Games Store (EGS). Cela vous permet de promouvoir vos autres jeux EGS via Xsolla Launcher.

Prérequis

Pour configurer l’intégration EGS, vous aurez besoin de :

• un ID d’application Epic (Artifact ID) ;
• un compte avec le rôle d’administrateur et une application de jeu sur Epic Games Developer Portal ;
• un build de jeu à publier sur EGS ;
• un lanceur prêt à l’emploi configuré dans le Compte éditeur ;
• la dernière version de BuildPatch Tool.

Obtenir l'ID d'application Epic (Artifact ID)

Pour trouver votre ID d’application Epic :

1. Connectez-vous à Epic Games Developer Portal.
2. Accédez à vos jeux.
3. Dans la carte de jeu, sélectionnez l’option Epic Games Store.

4. Dans le menu latéral, cliquez sur Artifacts and Binaries et choisissez le bac à sable et l'artéfact.

5. Cliquez sur le nom de l'artéfact pour voir l'ID d'application Epic.

Étapes d'intégration

Configurer l'autorisation

1. Si vous n'avez pas de politique client, créez-en une :
   1. Connectez-vous à Epic Games Developer Portal ;
   2. Dans les paramètres de votre produit (jeu), accédez à la section Product Settings > Clients > Add new client policy ;
   3. Ajoutez un nom de politique dans le champ Client policy ;
   4. Sélectionnez la politique GameClient dans la liste déroulante Client policy type ;
   5. Cliquez sur Add new policy.

2. Créez un client de connexion :
   1. Dans les paramètres de votre produit, accédez à la sectionProduct Settings > Clients > Add new client ;
   2. Ajoutez un nom de client dans le champ Client name ;
   3. Sélectionnez la politique client nouvellement créée dans le menu déroulant Client policy.

3. Cliquez sur Create Application.

4. Attribuez le client créé :
   1. Cliquez sur Linked Clients en haut à droite ;
   2. Sélectionnez le client précédemment créé dans la liste déroulante Select Clients.

5. Vérifiez que les autorisations sont configurées en cliquant sur la barre de navigation Permissions. Si celle-ci est marquée comme Not configured, activez ou désactivez l'une des options, puis enregistrez les modifications.

6. Dans votre projet, dans le Compte éditeur, accédez à la section Login.
7. Sélectionnez une option de connexion et accédez à la section Authentification > Plateformes d'édition > Epic Games.
8. Remplissez les champs ID d'application et Clé secrète de l'application. Vous pouvez copier les valeurs des champs à partir d'Epic Games Developer Portal (la section Product Settings > Clients > Edit client).
9. Cliquez sur Enregistrer les modifications.

Configurer la plateforme EGS et télécharger les fichiers

1. Dans votre projet, dans le Compte éditeur, accédez à la section Launcher.
2. Trouvez le lanceur sur le dashboard, et cliquez sur Éditer lanceur.
3. Accédez à la section Paramètres et cliquez sur Configurer à droite du logo de la plateforme Epic Games.

4. Entrez l'ID d'application Epic de votre jeu.
5. Pour vous assurer que les droits des utilisateurs fonctionnent correctement, spécifiez l'Audience Item ID. Effectuez les étapes suivantes pour récupérer l'ID :
   1. Dans les paramètres de votre produit, accédez à la section Epic Games Store > Offers ;
   2. Choisissez les offres que les lanceurs utiliseront pour vérifier les droits de l'utilisateur. Si l'utilisateur possède l'une des offres sélectionnées, le lanceur confirmera que l'utilisateur détient le jeu ;
   Cliquez sur Edit offer pour voir l'Audience Item ID.

7. Cliquez sur Télécharger l'hôte pour télécharger l'archive LauncherHost.zip pour Windows ou macOS.
8. Cliquez sur Télécharger la configuration pour télécharger le fichier de configuration hostArgs.json pour Windows ou macOS.

Générer et télécharger l'installeur de Launcher

Préparer le build de jeu pour EGS

1. Décompressez l'archive LauncherHost.zip (téléchargée à l'étape précédente) dans le dossier de votre choix. Cette archive contient le répertoire GameBuild qui sera utilisé pour préparer les builds du jeu qui seront téléchargés vers Epic Dev Portal.

• LauncherHost.exe — fichier exécutable pour l’utilitaire LauncherHost ;
• Qt5Core.dll vcruntime140-140_1.dll, msvcp140-140_1.dll — librairies de service pour l’utilitaire LauncherHost.exe ;
• installer — répertoire contenant l’installeur du lanceur.

Structure de répertoire pour macOS :

• LauncherHost — fichier exécutable pour l’utilitaire LauncherHost ;
• Frameworks — dossier système pour les librairies de l’utilitaire LauncherHost ;
• installer — dossier contenant l’installeur du lanceur.

2. Créez un nouveau dossier dans le dossier GameBuild.
3. Copiez et collez votre build de jeu dans ce dossier.
4. Définissez le nom du fichier exécutable du jeu (Windows/macOS) dans la section Game > Build > Executable files et indiquez le chemin relatif vers le fichier exécutable du jeu.

5. Copiez l'installeur du lanceur et le fichier hostArgs.json dans le répertoireGameBuild. En conséquence, le répertoire GameBuild devrait avoir la structure suivante :
   • Pour Windows :

\---GameBuild
    |   hostArgs.json
    |   LauncherHost.exe
    |   msvcp140.dll
    |   msvcp140_1.dll
    |   Qt5Core.dll
    |   vcruntime140.dll
    |   vcruntime140_1.dll
    |
    \---installer
            installer.exe

2. • Pour macOS :

\---GameBuild
    |   hostArgs.json
    |   LauncherHost
    |
    +---Frameworks
    |   \---QtCore.framework
    |       \---Versions
    |           \---5
    |               |   QtCore
    |               |
    |               \---Resources
    |                       Info.plist
    |                       QtCore.prl
    |
    \---installer
            Launcher.pkg

Télécharger les builds de jeu vers EGS

1. Décompressez le fichier BuildPatch Tool téléchargé précédemment.
2. Créez un répertoire pour BuildPatch Tool pour servir de cache aux builds du jeu.
3. Accédez au répertoire décompressé BuildPatchTool_x.y.z/Engine/Binaries/Win64 (le chemin peut varier selon la version de BuildPatch Tool et le système d'exploitation).
4. Ouvrez un terminal dans ce répertoire, puis exécutez la commande suivante pour télécharger les binaires du jeu. Référez-vous à la documentation pour des instructions plus détaillées.

.\BuildPatchTool.exe
  -ClientId="<YourClientId>"
  -ClientSecret="<secret>"
  -mode=UploadBinary
  -OrganizationId="<YourOrg>"
  -ProductId="<YourProduct>"
  -ArtifactId="<YourArtifact>"
  -BuildRoot="<absolute-path-to-GameBuild-directory>"
  -CloudDir="<absolute-path-to-cache-directory>"
  -BuildVersion="1.0.2-launcher-win"
  -AppLaunch="LauncherHost.exe"
  -AppArgs=""

Les paramètres de la commande :

• ClientId et ClientSecret sont disponibles sur le portail Epic Dev dans la section Product Settings > BPT Credentials.

• OrganizationId est disponible dans la section General Settings sur l'ongletOrganization > Settings.

• ProductId est disponible dans la section EOS SDK Credentials sur l'onglet Product Settings > SDK Download & Credentials.

• Pour connaître les valeurs des paramètres ArtifactId et BuildVersion, reportez-vous aux instructions. La valeur du paramètre BuildVersion est également disponible dans le menu action de la carte de jeu dans le lanceur Epic Games.

• AppLaunch — chemin d'accès au fichier exécutable principal relatif à BuildRoot dans le format suivant :
  • LauncherHost.exe — pour Windows ;LauncherHost — pour macOS.

• AppArgs — arguments de lancement supplémentaires. Il peut s'agir d'une chaîne vide.

Attribuer des plateformes à l'artéfact

1. Accédez à la page de l'artéfact.
2. Sur le côté droit, faites défiler la page jusqu'à la section Inactive binaries. Cliquez sur le bouton du menu des actions (…), puis sur Assign platforms. Sélectionnez les plateformes appropriées.

Obtenir un accès développeur au jeu dans le lanceur EGS

1. Ajoutez un nouvel utilisateur aux groupes :
   1. Accédez à la section Product Settings > Player Groups ;
   2. Cliquez sur le bouton du menu d'actions (…) sur un groupe de joueurs particulier, puis cliquez sur Edit Group ;
   3. Accédez à l'onglet Add accounts, choisissez Epic Games comme fournisseur d'identité et spécifiez l'ID de compte.

2. Générez des clés d'accès :
   1. Accédez à la section Epic Games Store > Access keys des paramètres de votre projet ;
   2. Cliquez sur Generate keys en haut à droite ;

      

      2. 3. Sélectionnez le bac à sable et l'offre pour lesquels vous souhaitez générer les clés ;

      

      2. 4. Entrez le nom des clés dans le champBatch name.
         5. Sélectionnez le type Testing,
         6. Spécifiez la quantité ;

      

      2. 5. Une fois les clés créées, téléchargez-les. Cliquez sur le bouton du menu d'actions (…), puis sur Download.

      

      5. Cliquez sur le bouton de profil en haut à droite du lanceur EGS, puis sélectionnez l'option Redeem Code.
      6. Échangez la clé téléchargée. Une fois la clé d'une offre échangée avec succès, l'utilisateur reçoit l'offre correspondante.

      

      Mettre à jour les builds de jeu

      Afin de mettre à jour les builds de jeu existants, répétez les étapes suivantes : préparation des builds de jeu,téléchargement vers EGS et assignation à l’artéfact.

      Cet article vous a été utile ?

      Oui

      Non

      Merci !

      Que pouvons-nous améliorer ? Message Envoyer

      Nous sommes désolés de l'apprendre

      Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message Envoyer

      Merci pour votre commentaire !

      Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
      Dernière mise à jour: 24 Décembre 2024

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