facebook_graph_request(graph_path, httpMethod, ds_map_parameters, ds_map_return)
Argument La description graph_path La partie du graphe social à interagir avec httpMethod La méthode http à utiliser (POST, GET, DELETE). ds_map_parameters Le ds_map avec les informations à envoyer. ds_map_return Le ds_map à recevoir (-1 pour none).
N/A
Avec cette fonction, vous pouvez faire interagir l'utilisateur avec le Facebook Social Graph. L'argument "graph_path" est l'endroit où vous définissez la partie du graphique que vous souhaitez accéder, comme la liste d'amis de l'utilisateur en cours, ou d'autres commentaires d'applications ou même un événement. Le chemin exact peut être défini en utilisant les termes décrits dans la section Publication des pages Facebook Graph Api. Vous définissez ensuite la méthode http à utiliser, généralement POST ou GET, mais Facebook accepte également la méthode DELETE.
L'argument suivant est légèrement plus complexe car il nécessite que vous ayez créé et rempli un ds_map avec les informations correctes que GameMaker Studio 2 va ensuite convertir en json automatiquement lorsqu'il est envoyé à l'Api Facebook. Les informations que vous mettez dans cette carte dépendront beaucoup du chemin que vous choisissez d'utiliser et une liste complète de toutes les valeurs possibles peut être trouvée ici. Un exemple de la structure de cette carte peut être vu dans l'exemple de code fourni ci-dessous.
Enfin, nous avons un argument pour stocker toutes les informations que Facebook a renvoyées à partir de la requête graphique. Cette information vient sous la forme de json quel GameMaker Studio 2 convertit en un ds_map. Pour que cela fonctionne correctement, vous devez avoir préalablement créé une carte ds_map, et si cette carte a été utilisée ailleurs et contient déjà des paires clé / valeur, elle sera effacée par cette fonction avant l'ajout des données Facebook. Il est très important que vous lisiez la documentation Facebook sur les valeurs de retour possibles afin que vous sachiez exactement à quoi vous attendre. Heureusement, Facebook a une page de test Graph Api où vous pouvez vérifier les différents chemins graphiques et voir exactement quelles informations ils vont retourner.
REMARQUE: L'utilisateur doit être connecté pour que la requête graphique fonctionne.
var wallPostMap;
wallPostMap = ds_map_create();
ds_map_add(wallPostMap, "message", "I just got a hi-score playing
Catch The Clown!");
ds_map_add(wallPostMap, "picture",
"http://MacSweeneygames.com/Clown.jpg");
ds_map_add(wallPostMap, "link", "http://MacSweeneygames.com/");
ds_map_add(wallPostMap, "name", "Catch The Clown");
ds_map_add(wallPostMap, "caption", "MacSweeneygames.com");
ds_map_add(wallPostMap, "description", "Play Catch the clown now on
MacSweeney Games!");
facebook_graph_request("me/feed", "POST", wallPostMap, -1);
ds_map_destroy(wallPostMap);
Le code ci-dessus va créer un ds_map et stocker son index dans la variable locale "wallPostMap". Il remplit ensuite le fichier ds_map avec les paires clé / valeur nécessaires pour publier une image et du texte sur le mur des utilisateurs actuellement connectés. Enfin, il envoie la requête graphique et supprime la carte ds_map de la mémoire.