Configuration

Creer un Compte

Inscrivez-vous sur gamdato.com. Un lien d'activation sera envoye a votre adresse e-mail (il expire en 24 heures). Apres verification de votre e-mail, connectez-vous avec vos identifiants pour acceder au tableau de bord.

Enregistrer un Jeu

Naviguez vers votre tableau de bord et creez un nouveau jeu en entrant un nom. Le systeme generera un panneau de controle ou vous pourrez gerer les informations du jeu, les classements, les succes et voir la liste des joueurs.

Telecharger et Installer l'Extension

Telechargez l'extension Gamdato et importez-la dans votre projet GameMaker. Le fichier telechargeable contient une integration basique mais complete de tous les services Gamdato. Nous recommandons de voir comment elle fonctionne avant de l'utiliser dans votre projet.

Configuration du Controleur

Creez un objet persistant instancie une fois au debut de votre jeu. Placez les scripts suivants dans leurs evenements correspondants :

Evenement Create :

gmda_setController("GAME-ID", "API-KEY");
gmda_setLeaderboard("TABLE-KEY");

Evenement Step :

gmda_Updatefunction();

Evenement Async HTTP :

gmda_HTTPfunction();

Lire les Resultats : la File d'Evenements

Vous ne recevez jamais de donnees directement depuis l'appel. Presque toutes les fonctions gmda_* sont asynchrones : vous les declenchez, puis vous lisez le resultat dans la file d'evenements avec gmda_pollEvent(), l'equivalent GameMaker des signaux de Godot. Videz la file a chaque Step ; chaque entree est une struct { event, success, ... }. Les getters synchrones (gmda_get*, gmda_status) retournent leur valeur directement.

// Evenement Step, apres gmda_Updatefunction()
var e = gmda_pollEvent();
while (!is_undefined(e)) {
    switch (e.event) {
        case "session_started":  show_debug_message("player: " + e.player_name); break;
        case "submit_completed": show_debug_message("best: " + string(e.response.score.score)); break;
        case "save_loaded":      /* e.response.save.data */ break;
        case "error":            show_debug_message("error: " + string(e.error)); break;
    }
    e = gmda_pollEvent();
}

Fonctions Utilitaires

Aides supplementaires disponibles dans l'extension :

• gmda_status() : true une fois que la session est active ET que les tables sont chargees. Verifiez-le avant les appels qui ont besoin de donnees.
• gmda_getDate() : la derniere date locale generee par gmda_refreshDate().
• gmda_refreshDate() : met a jour et retourne la date/heure actuelle.
• gmda_reloadinfo() : recharge toutes les tables de classement depuis le serveur.