Ce document répond aux questions fréquentes sur les SDK et la publication pour Google Play Jeux sur PC.
Monétisation
Pourquoi mon parcours d'achat échoue-t-il avec le code d'erreur 6 après l'ajout d'une nouvelle clé de facturation ou de licence ?
Les clés de licence nouvellement générées dans la Google Play Console subissent un délai de mise en cache et de propagation de plusieurs heures dans le backend commercial avant que les caches internes de Google Play ne se synchronisent dans tous les environnements de diffusion. Même si votre client de jeu peut interroger les informations détaillées sur le produit, les demandes d'achat échoueront avec le code d'erreur 6 tant que la synchronisation ne sera pas terminée. Attendez plusieurs heures après avoir importé ou mis à jour votre clé de licence avant de tester les achats.
Puis-je utiliser le parcours d'achat sans serveur backend ?
Du point de vue de la sécurité, Google recommande d'utiliser un serveur backend.
Pour en savoir plus, consultez Traiter sans serveur backend.
Les systèmes de paiement existants basés sur des API sont-ils autorisés après l'intégration du SDK Google Play Jeux sur PC ?
Tous les paiements doivent être gérés par le SDK Google Play Games sur PC à l'aide de Google Play Billing. Vous ne pouvez pas utiliser votre mode de paiement existant basé sur l'API dans le même jeu.
Comment consommer des achats en mode développeur ?
Traitez l'achat en mode développeur dans un délai de trois minutes, sinon il sera remboursé.
Les paiements récurrents ou les abonnements sont-ils acceptés ?
Pas dans l'immédiat, mais n'hésitez pas à nous faire part de cas d'utilisation spécifiques que nous pourrions ajouter à notre feuille de route.
Qu'est-ce que l'erreur de facturation dans mes appels d'achat ?
BillingError est la réponse du résultat du paiement. LaunchPurchaseFlow renvoie immédiatement sans blocage, mais vous devez écouter le rappel pour savoir quand il est terminé et capturer le résultat.
Comment utiliser la validation des achats côté client ?
Nous vous recommandons d'utiliser l'achat côté serveur et sa procédure de validation. Pour traiter les achats depuis votre application cliente, votre jeu doit figurer sur une liste d'autorisation. Veuillez contacter votre partenaire Google si votre jeu nécessite un accès. Pour en savoir plus, consultez Traiter sans serveur backend.
Quelles sont les limites d'API pour l'interrogation des informations détaillées sur les produits ?
Le nombre maximal de produits pouvant être interrogés dans un seul appel à l'API
QueryProductDetailsest de 50. Si vous dépassez cette limite, vous devez diviser la requête en plusieurs appels.Pourquoi les requêtes de produits ou les parcours d'achat échouent-ils avec des erreurs internes lors du chargement de nombreux SKU de produits ?
Interroger trop de codes SKU de produits à la fois ou appeler
QueryProductDetailsen C++ ouQueryProductDetailsAsyncdans Unity consécutivement trop de fois sur une courte période (par exemple, en envoyant des dizaines d'appels par lot dans une boucle serrée ou en créant une instanceBillingClientpar lot) peut surcharger les connexions IPC et backend locales. Lorsque ces connexions sont réinitialisées, les requêtes d'informations détaillées sur le produit échouent et votre jeu ne peut pas obtenir les jetons d'offre requis pour lancer un parcours d'achat.Pour éviter ces erreurs lors du chargement de votre catalogue, suivez ces pratiques :
- Respectez le nombre de produits accepté par appel : n'interrogez pas plus de 50 produits dans un seul appel
QueryProductDetailsouQueryProductDetailsAsync, et mettez en cache lesProductDetailsrenvoyés en mémoire au lieu d'interroger à nouveau l'intégralité du catalogue. Pour en savoir plus sur les limites de traitement par lot acceptées et l'interrogation des informations détaillées sur le produit, consultez la question précédente sur les limites d'API, Afficher les produits disponibles à l'achat pour C++ et Interroger les informations détaillées sur le produit pour Unity. - Évitez d'appeler les API trop de fois consécutivement sur une courte période : n'envoyez pas plusieurs lots de requêtes de produits simultanément ou l'un après l'autre sans espacement. Réutilisez une seule instance
BillingClient, sérialisez les requêtes ou limitez la simultanéité à deux ou trois appels en cours à la fois, et ajoutez un bref délai entre les lots consécutifs. - Installez la dernière version du SDK : mettez à jour votre intégration vers la dernière version du SDK Google Play Jeux sur PC (version 26.9.261.0 pour C++ ou 26.9.261.0 pour Unity) à partir de la page Téléchargements du SDK Play Jeux sur PC pour vous assurer que votre client inclut les dernières améliorations de stabilité de la facturation et de l'IPC.
- Respectez le nombre de produits accepté par appel : n'interrogez pas plus de 50 produits dans un seul appel
Quels paramètres sont requis lors de l'appel de Query Purchases ou Launch Purchase Flow dans le client Billing ?
La fonction accepte
QueryPurchasesContinuation, qui est un rappel de fonction avec la signaturestd::function<void(QueryPurchasesResult)>. Le rappel vous transmet le résultat avec tous lesProductPurchaseDetails. Ces informations sont disponibles dans les fichiers d'en-tête du SDK, dans le fichierincludes/billing/models.h.L'objet
launch_purchase_flow_resultobtenu comporte les fonctionsok()etcode(). La fonctionok()indique si le flux a réussi. La fonctioncode()renvoie l'énumérationBillingError(includes/billing/enums.h), qui comporte 10 cas d'erreur possibles, tels que l'annulation par l'utilisateur ou une erreur réseau.Est-il possible de personnaliser l'ordre de lancement du parcours d'achat dans le client de facturation ?
Dans la conception actuelle du SDK, il n'est pas possible de transmettre votre propre charge utile. Toutefois, vous pouvez fournir n'importe quelle combinaison de
obfuscated_account_idetobfuscated_profile_id. Vous pouvez n'en fournir aucun, un seul ou les deux.Le champ
offer_tokenest obligatoire et spécifie l'offre d'achat que l'utilisateur tente d'acheter dans le processus de paiement. Pour l'instant, chaque SKU sur Google Play ne comporte qu'une seule offre (par exemple, acheter un article pour 10 $). À l'avenir, l'équipe Play Billing proposera la prise en charge de plusieurs offres.Pour garantir l'association des métadonnées en cas d'interruption du parcours d'achat, stockez-les sur votre serveur backend avant de lancer la boîte de dialogue d'achat et associez-les à l'ID de compte de l'utilisateur, au SKU acheté et au code temporel actuel. Pour en savoir plus, consultez Associer un achat à des données internes.
Quels sont les prérequis pour passer de la facturation Google avec OAuth à la facturation Google basée sur une DLL ?
Les jeux peuvent continuer à utiliser la connexion OAuth avec Google pour gérer le compte connecté, mais Google vous recommande de ne plus utiliser les anciennes API de facturation REST. Le passage des API de facturation REST (avec connexion OAuth2) au flux du SDK peut être une opération basée sur un flag de fonctionnalité. Les deux peuvent donc coexister pendant un certain temps, le temps que le jeu passe au nouveau système.
L'appel d'API Launch Purchase Flow est-il traité via un navigateur Web ?
Non, le parcours d'achat s'effectue désormais entièrement dans le jeu à l'aide d'une superposition WebView fluide, sans quitter le client du jeu.
Un utilisateur doit-il se connecter séparément à chaque jeu pour effectuer un achat ?
Le compte au premier plan dans Google Play Jeux est utilisé pour chaque session de jeu. Vous n'avez donc pas besoin de vous reconnecter. Le compte que vous utilisez dans Google Play Jeux au début de la session de jeu est celui qui émet les appels d'API. Le parcours d'achat utilisera automatiquement ce compte.
Un jeu peut-il prendre en charge à la fois le SDK PC et les anciens systèmes de paiement ?
Le système de paiement fonctionne selon un modèle à double flux en fonction de la version binaire du jeu. Les utilisateurs d'anciennes versions continuent d'utiliser le flux existant, tandis que les utilisateurs de nouvelles versions passent aux paiements basés sur le SDK. Les utilisateurs des deux flux de paiement coexistent pendant la période de transition.
Windows App Bundle
Lorsque j'envoie un WAB à l'aide d'un lanceur tiers, le package du jeu est-il requis pour l'examen ?
Vous pouvez simplement envoyer votre programme d'installation sans avoir à envoyer l'intégralité du package de votre jeu. L'examinateur pourra télécharger le package de votre jeu à l'aide du programme d'installation.
Existe-t-il des limites concernant la taille des fichiers WAB ?
Pour la publication d'un programme d'installation, vous pouvez importer un fichier WAB d'une taille maximale de 10 Go. Pour la publication gérée Play, la taille maximale d'un fichier WAB est de 200 Go.
Pourquoi mon jeu ne s'installe-t-il pas ou n'apparaît-il pas après l'importation de mon WAB ?
Si votre jeu est intégré sans version PC préexistante (un "premier WAB"), le système peut le placer automatiquement dans un état d'attente de publication gérée. Cela est dû au fait qu'il n'existe aucune référence à mettre à jour. Pour publier entièrement le WAB et rendre le jeu disponible pour l'installation, vous devez accéder à la Google Play Console et exécuter manuellement l'action de publication requise (par exemple, cliquer sur "Publier les modifications").
Comment importer le WAB pour un test interne ?
Partagez les comptes de la liste d'autorisation avec Google afin que Google puisse les activer pour les tests internes. Une fois que Google dispose de la liste, il s'assure que les utilisateurs sont inclus dans le processus d'intégration.
Où le package WAB doit-il être importé ?
Vous pouvez importer le package WAB à l'emplacement mentionné dans la première question. Toutefois, vous ne pouvez pas la publier manuellement. Vous devez fournir à l'équipe backend de Google une heure UTC précise (à l'heure près). Google configure ensuite le calendrier de mise en ligne et s'assure que la publication est effectuée à temps.
SDK PC
Quelles sont les différences entre l'ancienne API et le SDK Google Play Jeux sur PC ?
- L'ancienne API ne propose que des fonctionnalités de facturation.
- Le SDK PC est compatible avec le service Google Desktop (GDS) et toutes les fonctionnalités PC.
- Aucune connexion Google basée sur un navigateur n'est requise avec le SDK PC.
Existe-t-il un autre moyen d'initialiser le SDK en lançant le jeu directement à l'aide du lanceur de jeu, sans passer par Google Play Jeux sur PC ?
Votre jeu doit être lancé via le client Google Play Jeux sur PC. Pour en savoir plus, consultez ce document pour les développeurs.
Le SDK PC est-il compatible avec les caractères multioctets dans le fichier de certification PEM ?
Oui, le SDK accepte les caractères multioctets pour la certification.
Comment le SDK gère-t-il la connexion au compte Google pour plusieurs instances ou comptes ?
Chaque lancement de jeu dans Google Play Jeux est traité comme une "session de jeu", et chaque "session de jeu" peut être associée à un compte. Ils peuvent être différents. Ainsi, si vous lancez le jeu avec le compte A, puis que vous passez au compte B et que vous le relancez, les deux peuvent s'exécuter en même temps.
L'intégration de Play Install Referrer fonctionne-t-elle avec le SDK PC ?
Le SDK PC (25.5.409.0 et versions ultérieures) est compatible avec l'API Play Install Referrer. Pour en savoir plus, consultez API Play Install Referrer.
Lanceur d'applications
Si un joueur utilise un lanceur tiers au lieu du client Google Play, son compte des services de jeux Play sera-t-il synchronisé automatiquement ?
Pour que les fonctions du SDK fonctionnent, le jeu doit être lancé directement via le client Google Play Jeux. Si un autre processus, tel qu'un programme d'installation ou une application de lancement, lance le jeu, ce processus doit lui-même être lancé à partir du client Google Play Jeux. Le jeu doit transmettre tous les paramètres reçus du client au processus client.
Comment gérer l'initialisation si Google Play Jeux lance un lanceur de jeu tiers ?
Vous n'êtes pas obligé d'intégrer le SDK directement dans votre lanceur d'applications. Toutefois, vous devez transmettre tous les arguments de ligne de commande reçus par le lanceur depuis le client Google Play Jeux directement au processus enfant généré (l'exécutable du jeu). Si l'initialisation échoue (par exemple, en renvoyant
kActionRequiredShutdownClientProcess), tous les processus, y compris le lanceur, doivent être arrêtés afin que Google Play Jeux puisse tenter de récupérer et de relancer le jeu automatiquement. Pour en savoir plus, consultez l'étape 5 du guide de configuration.Comment gérer les mises à jour et la maintenance de mon jeu et de mon lanceur une fois qu'ils sont en production ?
Les mises à jour et la maintenance ultérieures doivent être implémentées via votre lanceur d'application. Le client Google Play Jeux n'est pas compatible avec les fonctions de mise à jour. Le lanceur doit donc être capable de mettre à jour le jeu et le lanceur lui-même.
Comment le programme d'installation reçoit-il le jeton de session GPG pour la lecture automatique ?
GPG transmet le jeton de session au programme d'installation à l'aide de l'argument de ligne de commande
--g_session_token=<token>. Pour activer cette fonctionnalité, vous devez définiracceptsCommandLineArguments="true"dans votreplay_publishing_config.xml.Le programme d'installation est chargé d'extraire ce jeton et de l'utiliser pour lancer le jeu. Si la génération du jeton échoue, GPG lance le programme d'installation sans le jeton (solution de secours).
Initialisation
Lorsque je lance un jeu à l'aide de l'application Google Play Jeux, les informations de mon compte Google sont-elles synchronisées ?
Après avoir lancé le jeu via le client Google Play Jeux, le compte est automatiquement synchronisé et il n'est pas nécessaire de se reconnecter via le processus de connexion Google.
Est-il possible de réutiliser les paramètres d'initialisation plusieurs fois ?
Cela est possible tant que le client Google Play Jeux est en cours d'exécution et que les informations de connexion sont valides. Toutefois, dans des scénarios comme celui décrit dans le guide, tous les processus lancés par le jeu doivent être arrêtés lorsque l'utilisateur ferme le jeu ou que le jeu se ferme en raison d'un échec d'initialisation du SDK, tel que
kActionRequiredShutdownClientProcess.Est-il possible de créer un raccourci pour ouvrir le jeu directement ?
Vous pouvez utiliser l'URI suivant pour ouvrir le jeu directement :
googleplaygames://launch/?pid=2&id=com.company.gamenameL'URI permet de détecter si le client Google Play Jeux sur PC est ouvert. Si le client n'est pas ouvert, le client Google Play Jeux s'ouvre avant l'exécution du jeu ou du lanceur. Vous devez gérer le jeu ou le lanceur pour empêcher l'exécution de plusieurs instances.
Est-il possible de vérifier l'installation de Google Play Jeux sur PC sans utiliser le SDK ?
Vous pouvez vérifier l'état d'installation de Google Play Jeux sur PC sans intégrer le SDK en vérifiant la présence de la clé de registre Windows suivante :
HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games ServicesLa présence de cette clé indique que les services de jeux Google Play (requis pour exécuter des jeux sur PC) sont installés sur l'ordinateur. Si la clé est manquante, vous devez rediriger l'utilisateur vers la page d'installation de Google Play Jeux sur PC pour télécharger et installer le client.
Tests
Existe-t-il des environnements de test ouverts ou fermés semblables à l'environnement mobile ?
Bien qu'un bac à sable dédié de bout en bout ne soit pas disponible, nous reconnaissons la nécessité d'un environnement de test de type production pour les développeurs. Une solution plus robuste sera bientôt proposée.
Comment ajouter des testeurs ?
Votre contact Google crée un groupe de messagerie pour chaque projet de PC, auquel les comptes Google des testeurs doivent être ajoutés. Seuls les membres de ce groupe de messagerie sont autorisés à télécharger les packages de test dans Google Play Games.
Autres
Puis-je utiliser un VPN ?
Pour les développeurs qui doivent tester leur jeu dans des régions où Google Play Jeux sur PC n'est pas disponible, nous vous recommandons d'utiliser un VPN pour obtenir une adresse IP d'une région compatible.
Assurez-vous d'activer le mode TUN sur le VPN. Vous trouverez des instructions sur l'activation du mode TUN et la configuration du pare-feu dans le manuel d'utilisation du fournisseur de VPN.
Une fois le mode TUN activé, installez Google Play Jeux sur PC et l'émulateur à des fins de test.
Comment commencer à développer pour Google Play Jeux sur PC dans Unity ou UE Editor ?
- Activez le mode développeur et procédez aux tests.
- Ajoutez les fichiers
manifest.xmlet.dll. Pour en savoir plus, consultez la documentation pour les développeurs. - Enregistrez un GUID de partenaire en accès anticipé à des fins de test.
Comment utiliser correctement les clés de registre ?
Vous devez créer des clés de registre basées sur la ruche racine. Vous pouvez définir la ruche racine sur
HKEY_LOCAL_MACHINEouHKEY_CURRENT_USERen fonction de votre objectif et de la nature des données. La rucheHKEY_LOCAL_MACHINEest utilisée comme exemple dans les consignes.Quelles sont les exigences de Google pour l'examen des packages PC ?
Les packages PC sont soumis à une détection de logiciels malveillants, après quoi les examinateurs ne testent que l'installation du jeu, son démarrage et sa désinstallation.
Est-il nécessaire d'intégrer toutes les API ?
Les autres API ne sont pas obligatoires, mais elles offrent des avantages supplémentaires.
google::play::billingest requis pour les achats via une application et la vente de contenus numériques.google::play::install_referrerest nécessaire pour suivre les données de parrainage afin de vous aider à identifier les sources de trafic qui génèrent le plus de téléchargements de votre application.google::play::games::integrityest nécessaire pour protéger votre application contre les acteurs malveillants en détectant les appareils potentiellement risqués et les émulateurs inconnus.Pourquoi certains processus de jeu sont-ils arrêtés lorsque le client Google Play Jeux est fermé, alors que d'autres ne le sont pas ?
Google ne contrôle pas les sous-processus ni les processus du jeu en cours d'exécution. Le comportement dépend de s'il s'agit d'un jeu Android émulé ou d'un jeu PC. Les jeux émulés sont installés dans leur propre environnement. Leur comportement dépend donc en grande partie de l'initialisation et de l'arrêt de l'émulateur.
Dois-je utiliser la fonctionnalité de désinstallation de Google Play Games ou un programme de désinstallation personnalisé ?
Google recommande d'utiliser la fonctionnalité de désinstallation de Google Play Jeux.
Aide supplémentaire
Si vous avez besoin d'une aide supplémentaire non couverte par ces questions fréquentes, veuillez contacter google-play-games-pc@google.com.