FAQ

Questions générales

Pourquoi devrais-je utiliser Xsolla Launcher alors que je peux créer mon propre lanceur ?

Xsolla Launcher est une bonne solution pour économiser du temps et des ressources, que ce soit pendant la phase finale du développement ou après la sortie du jeu. La solution est gratuite pour les partenaires, mais implique des frais de paiement. Xsolla Launcher propose régulièrement de nouvelles fonctionnalités pour les utilisateurs et s’intègre avec d’autres produits Xsolla, notamment In-Game Store, Site Builder et Login. De plus, Xsolla suit les tendances du marché.

Combien va me coûter Xsolla Launcher ?

Le prix de Xsolla Launcher est déjà inclus dans les frais Xsolla. Des frais supplémentaires peuvent s’appliquer à la livraison des jeux. Toutefois, l’utilisation d’un système d’équilibrage P2P permet de réduire les frais de distribution de 80 % en moyenne.

Comment puis-je envoyer des mises à jour de jeu à Steam si j'utilise Xsolla Launcher ?

Si vous utilisez le lanceur Steam, vous téléchargez le build du jeu et le lanceur directement sur Steam. Dans ce cas, Steam livre et met à jour le jeu. Si vous souhaitez fournir du contenu en utilisant Xsolla Launcher et son CDN sur Steam, veuillez contacter votre chef de projet ou envoyer un e-mail à csm@xsolla.com.

Dois-je maintenir deux builds distincts, pour Steam et pour l'autonome ? Ou est-ce le même build qui est téléchargé sur Steam ?

Le nombre de builds dépend de la méthode d’intégration avec Steam. Toutefois, un seul build suffit dans la plupart des cas. Launcher vous permet de collecter les données utilisateur dans une seule base de données si vous proposez des jeux sur différentes plateformes. De plus, Launcher prend en charge l’enregistrement de bout-en-bout : si un utilisateur lance le jeu via Steam pour la première fois, il n’a pas besoin d’entrer ses données.

Dans ce cas, l’utilisateur peut visiter votre site en dehors du système Steam. Il peut s’authentifier en utilisant son Steam OpenID et rejoindre votre communauté officielle. Ensuite, l’utilisateur pourra participer aux discussions sur les forums, lire les nouvelles, découvrir de nouveaux jeux, etc.

J'utilise des outils Steam, y compris son lanceur, et je n'ai pas de frais de CDN. Qu'est-ce qui changera si j'utilise Xsolla Launcher ?

L’ajout de Xsolla Launcher à Steam avec un jeu ne change pas la logique de distribution ; Steam demeure responsable de la distribution et de la mise à jour des jeux. Le CDN de Launcher n’est pas utilisé dans ce cas.

Si vous souhaitez distribuer le jeu vous-même et utiliser Launcher de manière indépendante de la plateforme, Xsolla Launcher distribue les builds et les mises à jour du jeu en utilisant son CDN (G-core par défaut) ou tout autre que vous spécifiez. Le frais de trafic ne sont pas inclus dans la commission standard et sont facturés séparément sur une base mensuelle.

Xsolla propose un prix spécial entreprise pour G-core qui s’applique à tous ses clients.

Avez-vous une liste des CDN pré-intégrés avec Xsolla Launcher ? Dois-je contacter les entreprises qui fournissent des CDN pour une intégration supplémentaire ? Puis-je utiliser un CDN qui ne figure pas sur votre liste ?

Si vous souhaitez utiliser un autre fournisseur de CDN, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.

Quels jeux sont affichés dans la liste des jeux dans Xsolla Launcher ? Tous les jeux ajoutés ou seulement ceux achetés par l'utilisateur ?

La liste répertorie tous les jeux intégrés à Xsolla Launcher. Les jeux achetés par l’utilisateur affichent le bouton Play, tandis que les autres jeux affichent le bouton Buy ou un autre bouton selon le type de distribution de jeu.

Puis-je octroyer des clés de jeu gratuites à des utilisateurs spécifiques ? Comment peuvent-ils les utiliser ?

Oui, vous pouvez télécharger des clés de jeu à partir du Compte éditeur et les envoyer gratuitement à vos utilisateurs de la manière que vous souhaitez. Les utilisateurs pourront activer leurs clés dans Xsolla Launcher.

Les utilisateurs peuvent-ils s'authentifier automatiquement dans les jeux après s'être authentifiés dans Xsolla Launcher ?

Oui, c’est possible. Pour transférer les données utilisateur de Xsolla Launcher vers le jeu, utilisez le paramètre –xsolla-login-token. Pour accéder aux données utilisateur, vous devez décoder la valeur du paramètre.

Que puis-je faire si l'icône de Xsolla Launcher dans la barre d'état système n'a pas changé après avoir modifié et recompilé Xsolla Launcher ?

Réinstaller Xsolla Launcher.

Où puis-je trouver les fichiers journaux du lanceur ?

Pour trouver les fichiers journaux du lanceur :

1. Ouvrez le lanceur.
2. Accédez aux paramètres du lanceur.
3. Cliquez sur Browse logs dans la section General.

Comment un jeu s'intègre-t-il à Xsolla Launcher ?

Pour intégrer le jeu à Launcher, créez un projet dans votre Compte éditeur et téléchargez le build du jeu. Ensuite, vous pouvez ajouter des images pour votre jeu et configurer des paramètres supplémentaires dans l’interface.

Existe-t-il une solution IPC dans le SDK ?

Il n’y a actuellement pas d’IPC, car Xsolla Launcher ne possède pas de fonctionnalités qui nécessitent une communication IPC. Mais nous prévoyons d’ajouter des fonctionnalités telles que le streaming en direct et un magasin de jeux dans la superposition, qui nécessiteront l’IPC (via le SDK), et nous l’ajouterons à ce moment-là.

Xsolla Launcher est-il pris en charge sur mobile ou Mac ?

Xsolla Launcher est compatible avec Windows et macOS.

Comment le contenu de la page d'un jeu est-il alimenté dans Xsolla Launcher ?

Les informations relatives au contenu se remplissent dans les paramètres de chaque jeu dans la section Game Info. Vous pouvez également saisir des informations pour la page du jeu dans la section Game Titles de Xsolla Launcher. Pour en savoir plus, consultez les instructions.

Build Loader

Lorsque je télécharge un correctif de jeu via Build Loader, je reçois l'erreur suivante : « Attention! File path longer than 260 characters. ». Comment puis-je résoudre ce problème ?

Sous Windows, en raison d’une limite sur la longueur maximale du chemin complet, il est recommandé de déplacer le répertoire du jeu vers un emplacement plus proche de la racine ; par exemple, C:/Patch. Ensuite, passez le chemin mis à jour au build du jeu en utilisant la commande –game-path <path-to-game>. Pour en savoir plus, reportez-vous aux instructions.

Je n'arrive pas à exécuter Build Loader. Que faire ?

Build Loader est un utilitaire en ligne de commande. Pour l’exécuter, ouvrez un interpréteur de commandes tel que cmd.exe dans le répertoire contenant le fichier build_loader.exe, et utilisez la commande ./build_loader.exe. Pour plus d’informations, référez-vous aux instructions.

Je rencontre un problème inconnu avec Build Loader. Que faire ?

Contactez l’équipe d’intégration de Xsolla via le chat dans le coin inférieur droit du Compte éditeur, et fournissez le fichier log.txt se trouvant dans le même répertoire que le fichier build_loader.exe.

Compte éditeur

Lorsque je me connecte au Compte éditeur, je reçois une notification indiquant que j'utilise une ancienne version du lanceur et que la création d'un nouveau lanceur s'impose. Cependant, quand je clique sur le bouton Try New Launcher, nos lanceurs s'affichent. Comment puis-je y remédier ?

Actuellement, le Compte éditeur prend en charge Launcher 2.x.x et 3.x.x, mais la création de versions 2.x.x n’est plus possible. Lorsque vous passez à la nouvelle version, les paramètres sont enregistrés localement. Cependant, en vous connectant depuis un nouvel appareil, les paramètres de l’ancienne version du lanceur s’appliqueront.

Si les lanceurs créés ne s'affichent pas dans la section Launcher du Compte éditeur, comment cela peut-il être corrigé ?

Supprimez les données et les fichiers de cookies du site Web du Compte éditeur dans les paramètres de votre navigateur.

Je ne peux modifier aucun paramètre dans le Compte éditeur. Comment y remédier ?

Vérifiez que vous disposez d’un rôle de propriétaire ou de développeur. Les utilisateurs d’autres rôles ne bénéficient que des droits de lecture.

J'ai changé le rôle dans le Compte éditeur, mais je n'ai toujours pas le droit de modifier les paramètres du lanceur. Comment puis-je résoudre ce problème ?

Pour actualiser les autorisations, procédez à une nouvelle connexion au Compte éditeur.

La génération du lanceur est bloquée. Comment y remédier ?

Contactez l’équipe d’intégration de Xsolla via le chat dans le coin inférieur droit du Compte éditeur.

Comment puis-je voir rapidement les modifications que j'ai effectuées dans Xsolla Launcher ?

Il suffit de générer un brouillon de Xsolla Launcher. Tous les paramètres et les modifications de personnalisation que vous enregistrez dans le Compte éditeur sont automatiquement appliqués au brouillon.

Comment puis-je distribuer mon jeu free-to-play avec microtransactions via Xsolla Launcher ?

Pour distribuer un jeu gratuit :

1. Accédez à votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Launcher.
3. Sur la carte du projet, cliquez sur Edit Launcher.
4. Dans la section Games, cliquez sur Set up.
5. Cliquez sur Distribution et sélectionnez Free-to-play.
6. Dans le menu supérieur, cliquez sur Store et réglez la bascule Show store in launcher sur On.

Une fois ces étapes terminées, l’onglet Store devrait apparaître dans Launcher pour jouer. Pour en savoir plus, consultez les instructions.

Customisation

Le plugin Figma tokens ne fonctionne pas correctement. Comment y remédier ?

Accédez aux paramètres de Figma Tokens et changez le stockage des tokens en document local.

Que puis-je personnaliser dans Figma ?

Figma permet de configurer :

• l’arrondi et les couleurs des boutons ;
• les couleurs de police ;
• l’arrondi et les couleurs de la fenêtre ;
• l’arrondi et les couleurs des articles ;
• l’arrondi et les couleurs des champs de saisie ;
• les couleurs du panneau.

Les images ne sont fournies qu’à des fins de prévisualisation, téléchargez-les vers le Compte éditeur. D’autres paramètres tels que la position des éléments et la taille de l’image ne sont pas personnalisables.

Est-il possible de télécharger le code source du lanceur Xsolla pour apporter des modifications directes, plutôt que de se limiter aux options du site Web ?

Pour l’instant, le code source du lanceur ne peut être téléchargé. La personnalisation du lanceur est uniquement possible via le Compte éditeur et Figma, après la signature d’un contrat.

J'aimerais désactiver la fonctionnalité de connexion sur le lanceur. Comment procéder ?

Cette fonctionnalité sera disponible dans le Compte éditeur.

Je n'arrive pas à modifier le nom du lanceur. Que faire ?

Nous pouvons effectuer la modification de notre côté, mais cette action impactera la mise à jour automatique du lanceur. Les utilisateurs devront réinstaller le lanceur à partir du programme d’installation. Nous déconseillons de modifier le nom des lanceurs actifs.

Comment modifier l'ordre des jeux dans le lanceur ?

Pour l’instant, l’ordre des jeux ne peut être modifié.

Puis-je déplacer le bouton Download ?

Les éléments ne peuvent être déplacés, mais vous pouvez personnaliser leur arrondi et leur couleur via Figma et télécharger les paramètres vers le Compte éditeur.

Installateur

Dois-je intégrer un lien de téléchargement du lanceur sur mon site Web ? Puis-je permettre l'enregistrement des utilisateurs via le lanceur plutôt que le site Web ?

Oui, c’est le principal canal de distribution des lanceurs pour tous nos partenaires. Mais ces derniers doivent mettre à jour ce lien à chaque nouvelle génération de lanceur. Le lanceur dispose également d’une fonction d’enregistrement.

Puis-je inclure le lien de téléchargement du lanceur dans l'e-mail de confirmation d'inscription ?

Actuellement, cette option n’est pas prise en charge, car le lien de téléchargement du lanceur change à chaque nouvelle version générée.

Comment puis-je modifier le nom du fichier d'installation ?

Pour modifier le nom du fichier d’installation, reportez-vous aux instructions.

Puis-je récupérer les informations sur l'installation du lanceur par un utilisateur ?

Malheureusement non, et pour l’instant, nous ne disposons pas d’une telle fonctionnalité.

L'installation du lanceur échoue alors que le programme d'installation Web exécute un installateur autonome. Comment y remédier ?

Voici quelques solutions populaires à ce problème :

• Essayez de changer le répertoire d’installation.
• Si le changement de répertoire sur le lecteur actuel n’a pas fonctionné, essayez d’installer le lanceur sur un autre lecteur.
• Désactivez votre antivirus, redémarrez votre ordinateur, puis essayez d’installer le lanceur.
• Essayez d’installer le lanceur via un installateur hors ligne.

Comment puis-je obtenir un installateur hors ligne ?

1. Dans le Compte éditeur, accédez à la page Launcher build.
2. Sélectionnez un build de brouillon ou un build publié.
3. Choisissez un système d'exploitation et cliquez sur Get a link to a stand-alone installer.

Je rencontre l'erreur « Your internet connection seems to be not permitted or dropped out ». Comment y remédier ?

Essayez de désactiver votre antivirus et votre pare-feu, redémarrez votre ordinateur et réessayez.

Lancement des jeux

Le jeu nécessite-t-il l'exécution de Xsolla Launcher pour fonctionner ?

Xsolla Launcher est toujours en cours d’exécution. Lorsqu’il est utilisé pour lancer le jeu, il se cache dans la barre d’état système afin de ne pas utiliser de ressources. Le joueur peut mettre fin au processus de Xsolla Launcher sans affecter le jeu, car il n’y a pas de connexion pendant la session de jeu.

Existe-t-il une solution pour connecter des PC sur le même LAN via une connexion P2P, de telle sorte que les données ne soient transférées qu'au sein de ce LAN ?

Non, il n’y a pas de telle solution pour l’instant.

Lorsque l'utilisateur démarre un jeu dans le lanceur, existe-t-il un moyen de récupérer les informations de connexion au jeu ?

Oui. Le lanceur passe le JWT comme argument de ligne de commande.

Je souhaite configurer une version Prod du lanceur et disposer de plusieurs branches de test pour mon jeu. Combien d'environnements pouvez-vous prendre en charge ?

Pour l’instant, chaque jeu se limite à un seul build du lanceur. Un autre build du jeu peut être utilisé pour la version de brouillon du lanceur, mais celle-ci ne peut être partagée avec les utilisateurs finaux.

Lorsqu'un utilisateur télécharge un jeu, l'antivirus affiche une fenêtre d'avertissement ou bloque le processus. Comment résoudre ce problème ?

Cette réaction de l’antivirus au téléchargement en P2P (pair-à-pair) est un faux positif. Pour télécharger des fichiers de jeu, le lanceur utilise des connexions P2P via une adresse IP publique partagée par plusieurs utilisateurs ou sites Web.
Si vous utilisez le logiciel Malwarebytes, référez-vous à leur commentaire officiel à ce sujet.
Cette erreur se corrige dans les paramètres du lanceur en désactivant l’option Use P2P (peer-to-peer) network.

Le lanceur prend-il en charge l'exécution de jeux par navigateur ?

Oui, pour configurer le lancement des jeux par navigateur, reportez-vous aux instructions.

Peut-on intégrer des arguments supplémentaires dans le fichier exécutable pour son lancement ?

Pour l’instant, notre système ne prend pas en charge cette fonctionnalité. Toutefois, vous pouvez créer un script qui lance le jeu avec les arguments requis, puis spécifier ce script en tant que fichier exécutable dans le Compte éditeur.

Lorsque je démarre le jeu dans le lanceur, je rencontre l'erreur « Game files are missing or damaged ». Comment y remédier ?

1. Vérifiez que le fichier exécutable est configuré dans le Compte éditeur.
2. Vérifiez que le nom et le chemin relatif du fichier exécutable sont corrects.
3. Assurez-vous d'utiliser le lanceur de brouillon pour voir les modifications en temps réel. Si vous utilisez le lanceur publié, veillez à ce qu'une nouvelle version soit générée et publiée.

Puis-je fournir des clés gratuites aux joueurs possédant déjà le jeu sur d'autres plateformes (par exemple Steam, Epic Games) pour les transférer sur la plateforme Xsolla ?

Vous pouvez obtenir un nombre quelconque de clés de jeu dans la section Store du Compte éditeur, puis les envoyer manuellement par e-mail aux utilisateurs. Ces derniers pourront ensuite les utiliser dans le lanceur.

Puis-je télécharger une archive SFX en tant que fichier redistribuable ?

L’archive SFX peut se compacter en fichier EXE.

Quand un fichier redistribuable s'installe-t-il ?

Les redistribuables ne s’installent que lors de l’installation du jeu. Lorsque le jeu est mis à jour ou réparé, les redistribuables ne sont pas réinstallés.

Est-il possible d'ajouter les distinctions au lanceur ?

Launcher ne dispose pas encore de la fonctionnalité de distinctions.

Le magasin de jeux du lanceur prend-il en charge les coupons ?

Seuls les codes promo sont acceptés dans le panier d’achat.

Puis-je vendre des abonnements via le lanceur ?

Pour l’instant, le lanceur ne prend pas en charge les abonnements. Si vous avez besoin de cette fonctionnalité, veuillez nous en informer.

Launcher prend-il en charge les mods de jeu ?

Pour l’instant, Launcher ne prend pas en charge les mods de jeu. Si vous avez besoin de cette fonctionnalité, veuillez nous en informer.

Migration de Launcher v 2.x vers Launcher v 3.x

Puis-je créer une demande de fonctionnalité pour Launcher 2.x ?

Pour l’instant, nous n’acceptons les demandes de fonctionnalités que pour Launcher 3.x.

Puis-je télécharger Launcher depuis Github et le paramétrer via des fichiers de configuration ?

GitHub n’a été utilisé que pour Launcher 2.x. Le paramétrage de Launcher 3.x se réalise dans le Compte éditeur.

Les nouvelles de Launcher 2.x se transfèrent-elles de manière automatique dans les tuiles de contenu de Launcher 3.x ?

Pour l’instant, Launcher ne dispose pas d’une telle fonctionnalité. Il s’agit de deux systèmes de nouvelles distincts.

Onglets

Les utilisateurs rencontrent l'erreur « Try again » lorsqu'ils ouvrent un onglet dans le lanceur. Comment résoudre ce problème ?

Voici une raison possible : votre site Web renvoie le paramètre x-frame-options: SAMEORIGIN, ce qui bloque l’affichage du site dans le lanceur. Supprimez l’en-tête x-frame-options et ajoutez l’en-tête Content-Security-Policy: frame-ancestors file://*.

Propriété et clés

Comment les utilisateurs de Xsolla Launcher accèdent-ils aux jeux ? Les jeux peuvent-ils être distribués par le biais d'abonnements, de coupons ou de codes promo ?

Actuellement, l’accès aux jeux est uniquement possible avec une clé de jeu. Nous prévoyons d’ajouter des abonnements à Xsolla Launcher en 2024.

Les utilisateurs de Xsolla Launcher peuvent-ils télécharger des mises à jour de jeux s'ils n'ont pas acheté de clés de jeu ?

Non. Les jeux et les mises à jour ne sont pas disponibles sans l’achat de clés de jeu. Si vous avez des jeux free-to-play, c’est possible.

Que se passe-t-il avec l'accès de l'utilisateur au jeu si l'utilisateur effectue un remboursement ?

L’utilisateur perd l’accès au jeu. Toutefois, il pourra acheter à nouveau le jeu via Xsolla Launcher en utilisant le bouton Buy.Dernière mise à jour: 21 Février 2024