Suite à l'abandon de l'API Connexion Google, nous allons supprimer le SDK games v1 en 2026. Après février 2025, vous ne pourrez plus publier sur Google Play des titres nouvellement intégrés au SDK v1 des jeux. Nous vous recommandons d'utiliser le SDK Games v2 à la place.
Bien que les titres existants avec les intégrations de la version 1 des jeux précédents continuent de fonctionner pendant quelques années, nous vous encourageons à migrer vers la version 2 à partir de juin 2025.
Ce guide explique comment utiliser le SDK de la version 1 des services de jeux Play. Le SDK C++ pour les services de jeux Play v2 n'est pas encore disponible.
Ce guide explique comment utiliser le service Events dans une application C++.
Avant de commencer
Si ce n'est pas déjà fait, n'hésitez pas à revoir les concepts d'événement dans les jeux.
Pour configurer votre environnement de développement C++ afin d'utiliser le service Events, suivez les instructions du guide Premiers pas avec C++. Vous pouvez télécharger le SDK C++ des services Play Jeux sur la page de téléchargement du SDK.
Avant que votre jeu puisse accéder aux événements, vous devez d'abord les définir dans la Google Play Console.
Envoyer un événement
Vous pouvez ajouter du code dans votre jeu pour avertir le service Événements chaque fois qu'un événement intéressant se produit. Voici quelques exemples d'événements que vous pouvez capturer dans votre jeu: tuer des ennemis, explorer ou revenir dans différentes régions du jeu, ou acquérir des objets dans le jeu. En règle générale, vous appelez la méthode Increment sur le gestionnaire d'événements pour incrémenter le nombre d'événements de 1 chaque fois que le joueur effectue une action associée à l'événement (par exemple, "Tué un monstre").
L'exemple suivant montre comment envoyer le nombre d'événements mis à jour au service Events.
// Increment the event count when player performs the 'Attack blue
// monster' action.
game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);
Récupérer des événements
Pour récupérer la valeur de compte actuelle stockée sur les serveurs de Google pour un événement spécifique, appelez l'une des méthodes Fetch*. Vous pouvez le faire, par exemple, si vous souhaitez afficher les statistiques ou la progression d'un joueur dans le jeu à partir d'une interface utilisateur personnalisée.
L'exemple suivant montre comment récupérer et consigner les données d'événement dans votre jeu.
// Log Events details.
LogI("---- Showing Event Counts -----");
gpg::EventManager::FetchAllCallback callback =
[](gpg::EventManager::FetchAllResponse const &response) {
for (auto i : response.data) {
gpg::Event const &event = i.second;
LogI("Event name: %s count: %d", event.Name().c_str(),
event.Count());
}
};
game_services_->Events().FetchAll(callback);