Utiliser le SDK pour PC lors du développement

Pour que le SDK s'initialise correctement dans un jeu, plusieurs exigences doivent être satisfaites. En voici quelques exemples :

  • Exécution à partir d'un exécutable de jeu signé numériquement

  • Lancement de l'exécutable de jeu à partir de Google Play Jeux

Ces exigences peuvent être contraignantes pour les développeurs qui créent activement leur jeu dans un éditeur de jeu ou un IDE de code, car elles nécessitent d'empaqueter et de publier le jeu pour sa sortie.

Pour améliorer le workflow de développement, le SDK propose un mode développeur. Lorsqu'il est activé, le mode développeur permet au SDK de fonctionner dans un éditeur de jeu ou un IDE de code. Le SDK peut être initialisé sans que l'exécutable ne soit signé numériquement ni lancé à partir de Google Play Jeux.

Prérequis

  • Obtenez un GUID de partenaire en accès anticipé. Il s'agit d'une clé secrète qui permet à votre équipe de développement d'utiliser le SDK à partir de l'éditeur de votre moteur de jeu sans avoir à empaqueter ni à signer numériquement votre exécutable de jeu, ni à le lancer à partir de Google Play Jeux.

Étape 1 : Activez le mode développeur dans le fichier manifeste

Activez le mode développeur pour votre application en définissant IsDeveloperMode sur true dans le fichier manifest.xml de votre application.

<?xml version="1.0" encoding="utf-8"?>
<?Manifest version="1">
   <?Application>
     <?PackageName>com.example.package<?/PackageName>
     <?IsDeveloperMode>true</?IsDeveloperMode>
   <?/Application>
<?/Manifest>

Étape 2 : Activez l'accès anticipé

Activez l'accès anticipé sur l'appareil sur lequel vous effectuez des tests en définissant la EarlyAccessPartnerGuid valeur de chaîne sous la HKLM\Software\Google\Play Games Services\EarlyAccessPartnerGuid clé de registre.

Vous pouvez le faire à l'aide de l'Éditeur du Registre Windows ou à partir d'un terminal cmd d'administrateur avec la commande suivante :

C:\> reg add "HKLM\Software\Google\Play Games Services" /v EarlyAccessPartnerGuid /t REG_SZ /d EAP GUID

Étape 3 : Connectez-vous à Google Play Jeux pour PC

Lorsque le mode développeur est activé, le SDK utilise le compte connecté à Google Play Jeux pour PC lors des appels d'API. Si plusieurs comptes sont connectés, le compte actif est utilisé.

Si votre jeu n'a pas été publié publiquement (il n'a jamais été publié sur le canal de publication de production dans la Play Console), nous vous recommandons d'utiliser un compte Google qui a rejoint le groupe de test interne de votre jeu. Les testeurs internes auront accès à votre jeu avant sa sortie, ce qui est nécessaire pour que certaines API du SDK fonctionnent. Par exemple, pour effectuer un achat avec Play Billing. Vous pouvez gérer les testeurs internes de votre application dans la Play Console.

Étapes suivantes

Ajoutez des fonctionnalités Google Play pour PC à votre application :