Questions fréquentes

Ce document répond aux questions fréquentes sur les SDK et la publication pour Google Play Jeux sur PC.

Monétisation

  1. Puis-je utiliser le parcours d'achat sans serveur backend ?

    Du point de vue de la sécurité, le traitement sans serveur backend n'est pas recommandé.

    Pour en savoir plus, consultez Traiter sans serveur de backend.

  2. 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 Jeux 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.

  3. Comment consommer des achats en mode développeur ?

    Traitez l'achat en mode développeur dans les trois minutes, faute de quoi il sera remboursé.

  4. Les paiements récurrents ou les abonnements sont-ils acceptés ?

    Pas pour le moment, mais n'hésitez pas à nous fournir des cas d'utilisation spécifiques que nous pourrions ajouter à notre feuille de route.

  5. Qu'est-ce que l'erreur de facturation dans mes appels d'achat ?

    BillingError est la réponse du résultat du paiement. LaunchPurchaseFlow renverra immédiatement une réponse sans bloquer l'exécution, mais vous devez écouter le rappel pour savoir quand il est terminé et capturer le résultat.

  6. Comment utiliser la validation des achats côté client ?

    Nous vous recommandons d'utiliser les achats côté serveur et leur processus de validation. Pour pouvoir 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 de backend.

  7. Quelles sont les limites d'API pour interroger les détails des produits ?

    Le nombre maximal de produits pouvant être interrogés en un seul appel à l'API QueryProductDetails est de 50. Si vous dépassez cette limite, vous devez diviser la requête en plusieurs appels.

  8. Quels paramètres sont requis lors de l'appel de Query Purchases ou Launch Purchase Flow dans le Billing Client ?

    La fonction accepte QueryPurchasesContinuation, qui est un rappel de fonction avec la signature std::function<void(QueryPurchasesResult)>. Le rappel vous transmet le résultat avec tous les ProductPurchaseDetails. Ces informations sont disponibles dans les fichiers d'en-tête du SDK, dans le fichier includes/billing/models.h.

    Le launch_purchase_flow_result obtenu comporte les fonctions ok() et code(). La fonction ok() indique si le flux a réussi. La fonction code() renvoie l'énumération BillingError (includes/billing/enums.h), qui comporte 10 cas d'erreur possibles, tels que l'annulation par l'utilisateur ou une erreur réseau.

  9. La commande personnalisée est-elle acceptée pour le flux d'achat de lancement dans le client Billing ?

    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_id et obfuscated_profile_id. Vous pouvez n'en fournir aucun, un seul ou les deux.

    Le champ offer_token est obligatoire et spécifie l'offre d'achat que l'utilisateur tente d'acheter lors du processus de règlement. Pour le moment, chaque SKU sur Google Play ne comporte qu'une seule offre (par exemple, acheter un article pour 10 $). À l'avenir, l'équipe de facturation Play prendra en charge 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 à l'horodatage actuel. Pour en savoir plus, consultez Associer un achat à des données internes.

  10. Une erreur de délai d'attente est-elle prévue si un utilisateur ferme le navigateur sans payer lors d'un parcours d'achat ?

    Oui, il s'agit d'un problème connu et d'un comportement prévu dans le flux basé sur le navigateur. Nous travaillons activement sur une fonctionnalité d'achat fluide (basée sur WebView) qui permettra de maintenir le parcours de paiement dans le jeu et de résoudre ce problème de délai d'expiration.

  11. Quels sont les prérequis pour passer de la facturation Google avec OAuth à la facturation Google native avec DLL ?

    Les jeux peuvent continuer à utiliser la connexion OAuth avec Google pour gérer le compte connecté, mais Google vous recommande de cesser d'utiliser les anciennes API REST de facturation. Le passage des API de facturation REST (avec connexion OAuth2) au flux du SDK peut être une opération signalée par une fonctionnalité. Les deux peuvent donc coexister pendant un certain temps pendant que le jeu effectue la transition.

  12. L'appel d'API Launch Purchase Flow est-il traité via un navigateur Web ?

    Oui, pour le moment, elle est traitée via un navigateur. Google prévoit de finaliser l'ensemble du processus sans quitter le jeu, ce qui est possible grâce au SDK.

  13. 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 à partir duquel les appels d'API sont émis. Lorsque vous lancez un parcours d'achat dans le navigateur, vous devez être connecté et utiliser le même compte que celui de la session de jeu. Si l'utilisateur est connecté avec un autre compte, le parcours Web l'invite à changer de compte.

  14. Un jeu peut-il prendre en charge à la fois le SDK natif 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 des anciennes versions continuent d'utiliser le flux existant, tandis que ceux des nouvelles versions passent aux paiements basés sur le SDK. Les utilisateurs des deux modes de paiement coexistent pendant la période de transition.

Windows App Bundle

  1. Lorsque vous envoyez une 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.

  2. Existe-t-il des limites de taille pour les fichiers WAB ?

    La taille des fichiers WAB ne doit pas dépasser 10 Go.

  3. Pourquoi mon jeu ne s'installe-t-il pas ou n'apparaît-il pas après l'importation de mon fichier WAB ?

    Si votre jeu est intégré sans version PC préexistante (une "première fois WAB"), le système peut le placer automatiquement dans un état de publication gérée. Cela se produit, car il n'existe aucune référence à mettre à jour. Pour publier complètement le WAB et rendre le jeu disponible à l'installation, vous devez accéder à la Google Play Console et exécuter manuellement l'action de publication requise (par exemple, en cliquant sur "Publier les modifications").

  4. Comment importer le fichier WAB pour les tests internes ?

    Partagez les comptes de la liste d'autorisation avec Google afin que Google puisse les activer pour les tests internes. Une fois que Google a reçu la liste, il s'assure que les partenaires y sont inclus lors du processus d'intégration.

  5. 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 le publier manuellement. Vous devez fournir au personnel du backend Google une heure UTC précise (à l'heure près). Google configure ensuite le calendrier de publication et s'assure qu'il est publié à temps.

SDK pour PC

  1. Quelles sont les différences entre l'ancienne API et le SDK Google Play Jeux sur PC ?

    • Notre ancienne API n'offre que des fonctionnalités de facturation.
    • Le SDK pour PC est compatible avec le service Google Desktop (GDS) et toutes les fonctionnalités pour PC.
    • Aucune connexion Google basée sur un navigateur n'est requise avec le SDK PC.

  2. 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.

  3. Le SDK PC natif est-il compatible avec les caractères multibytes dans le fichier de certification PEM ?

    Oui, le SDK accepte les caractères multibytes pour la certification.

  4. Comment le SDK gère-t-il la connexion à un 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 relancez le jeu, les deux peuvent s'exécuter en même temps.

  5. L'intégration de Play Install Referrer fonctionne-t-elle avec le SDK PC ?

    Le SDK PC (version 25.5.409.0 et ultérieures) est compatible avec l'API Play Install Referrer. Pour en savoir plus, consultez la documentation de l'API Play Install Referrer.

Lanceur d'applications

  1. Si un joueur utilise un lanceur d'applications tiers au lieu du client Google Play, son compte de services Play Jeux se synchronisera-t-il 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.

  2. Comment gérer l'initialisation si Google Play Games lance un lanceur de jeu tiers ?

    Vous n'êtes pas tenu 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 du client Google Play Games 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.

  3. 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. Le client Google Play Jeux n'est pas compatible avec les fonctions de mise à jour. Le lanceur doit donc être capable de mettre à jour à la fois le jeu et le lanceur lui-même.

Initialisation

  1. Lorsque je lance un jeu à l'aide de l'application Google Play Jeux, mes informations de 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 connecter à nouveau via le processus de connexion Google.

  2. Est-il possible de réutiliser plusieurs fois les paramètres d'initialisation ?

    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.

  3. Existe-t-il un moyen 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.gamename

    L'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.

  4. Existe-t-il un moyen de vérifier l'installation de Google Play Jeux sur PC sans utiliser le SDK ?

    Vous pouvez vérifier l'état de l'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 Services

    La présence de cette clé indique que les services de jeux Google Play (nécessaires pour exécuter des jeux sur PC) sont installés sur la machine. Si la clé est manquante, vous devez rediriger l'utilisateur vers la page d'installation de Google Play Jeux sur PC pour qu'il télécharge et installe le client.

Tests

  1. Existe-t-il des environnements de test ouverts ou fermés semblables à ceux des mobiles ?

    Bien qu'un bac à sable de bout en bout dédié ne soit pas disponible, nous reconnaissons la nécessité pour les développeurs de disposer d'un environnement de test semblable à celui de production. Une solution plus robuste sera bientôt proposée.

  2. Comment ajouter des testeurs ?

    Votre contact Google crée un groupe de diffusion pour chaque projet de couverture et de précision, auquel les comptes Google des testeurs doivent être ajoutés. Seuls les membres de ce groupe de diffusion sont autorisés à télécharger les packages de test dans Google Play Games.

Divers

  1. Puis-je utiliser un VPN ?

    Pour les développeurs qui souhaitent 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 dans une région compatible.

    Assurez-vous d'activer le mode TUN sur le VPN. Pour savoir comment activer le mode TUN et configurer le pare-feu, consultez 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.

  2. Comment commencer à développer pour Google Play Jeux sur PC dans Unity ou l'éditeur UE ?

  3. Comment utiliser correctement les clés de registre ?

    Vous devez créer des clés de registre en fonction de la ruche racine. Vous pouvez définir la ruche racine sur HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER selon votre objectif et la nature des données. La ruche HKEY_LOCAL_MACHINE est utilisée comme exemple dans les consignes.

  4. Quelles sont les exigences pour l'examen des packages PC par Google ?

    Les packages pour PC sont soumis à une analyse anti-malware, après quoi les examinateurs ne testent que les processus d'installation, de démarrage et de désinstallation du jeu.

  5. 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::billing est obligatoire pour les achats via une application et la vente de contenus numériques. google::play::install_referrer est nécessaire pour suivre les données de parrainage et vous aider à comprendre quelles sources de trafic envoient le plus d'utilisateurs pour télécharger votre application. google::play::games::integrity est nécessaire pour protéger votre application contre les acteurs malveillants en détectant les appareils potentiellement risqués et les émulateurs inconnus.

  6. Pourquoi certains processus de jeu sont-ils arrêtés lorsque le client Google Play Jeux est fermé, tandis 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 du fait que le jeu soit un jeu Android émulé ou un jeu PC natif. 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.

  7. Dois-je utiliser la fonctionnalité de désinstallation de Google Play Games ou un programme de désinstallation personnalisé ?

    Google recommande d'utiliser notre fonctionnalité de désinstallation de Google Play Jeux.

Aide supplémentaire

Si vous avez besoin d'une aide supplémentaire qui n'est pas abordée dans ces questions fréquentes, veuillez nous contacter à l'adresse google-play-games-pc@google.com.