Alimenter votre jeu avec le SDK Play Jeux pour PC

Avec le SDK Play Jeux pour PC, vous pouvez accéder aux services Google Play pour créer et monétiser votre jeu sur PC. Vendez du contenu numérique avec Play Billing, connectez-vous facilement avec Play Jeux et vérifiez que vos utilisateurs disposent d'un droit d'accès valide à votre application avec Play Integrity.

Pour obtenir une vue d'ensemble des fonctionnalités à venir, des versions stables et de l'architecture d'intégration, consultez la feuille de route de Play Jeux pour PC.

Prêt à vous lancer ?

Prérequis

• Créez une fiche d'application dans la Play Console et revendiquez un nom de package Play.

• Téléchargez et installez Google Play Jeux pour PC, puis connectez-vous avec votre compte Google.

Étape 1 : Ajoutez le SDK à votre projet

Étape 2 : Ajoutez un fichier manifeste

Avant de pouvoir utiliser le SDK dans votre jeu, vous devez associer l'exécutable de votre jeu au nom de package Play que vous avez revendiqué dans la Play Console. Pour ce faire, ajoutez un fichier manifest.xml dans le même répertoire que l'exécutable de votre jeu.

Exemple de contenu manifest.xml :

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

Exemple d'emplacement manifest.xml :

C:\Program Files
└───Example Game
    ├───Game.exe
    └───manifest.xml

Étape 3 : Signez numériquement votre jeu

Avant que votre jeu puisse utiliser le SDK, son exécutable doit être signé numériquement à l'aide d'une signature numérique Authenticode. Pour savoir comment signer un exécutable, consultez la documentation sur SignTool .

Une fois le processus de signature numérique de votre jeu terminé, envoyez les informations du certificat à votre représentant Google pour configuration.

Étape 4 : Initialisez le SDK

Initialisez le SDK lors de la séquence de démarrage de votre jeu. Cette opération doit être effectuée automatiquement sans nécessiter d'interaction de l'utilisateur. Il est recommandé de vérifier que l'initialisation a réussi avant de rendre la fenêtre de votre jeu. Cela permet d'offrir la meilleure expérience utilisateur possible en détectant et en résolvant les erreurs dès que possible, et d'éviter que la fenêtre de votre jeu n'apparaisse brièvement dans les cas où le processus de votre jeu doit se fermer.

Commencez à utiliser le SDK en appelant GooglePlayInitialize (C++) / GooglePlayInitialization.InitializeAsync (C#) pour initialiser l'API. Cela configurera l'état global, se connectera à l'environnement d'exécution du SDK et vérifiera que l'application a démarré correctement. Cette opération DOIT être appelée et le rappel de continuation doit être effectué avec InitializeResult::ok() (C++) / Result.IsOk (C#) égal à true avant que toute autre API puisse être utilisée.

  // Initialize the SDK as part of the startup sequence of your application.
  auto promise = std::make_shared<std::promise<InitializeResult>>();
  GooglePlayInitialize(
    [promise](InitializeResult result) {
      promise->set_value(std::move(result));
    });

  auto initialize_result = promise->get_future().get();
  if (initialize_result.ok()) {
    // The SDK succeeded with initialization. Continue with the startup sequence
    // of the game.
    // ...
  } else if (initialize_result.code() == InitializationError::kActionRequiredShutdownClientProcess) {
    // The SDK failed to initialize and has requested that your game process exit
    // as soon as possible.
    exit(1);
  } else {
    // The SDK failed to initialize for an alternative reason. It is still
    // generally recommended that you exit the game process as soon as possible,
    // because it won't be possible to access any APIs in the SDK. Critical
    // operations such as verifying the user owns a valid license to your game
    // won't be possible.