facebook_send_invite(titlestring, msg, picture_url, redirect_url, ds_map_response);
Argument La description titlestring Le titre du dialogue (une chaîne de caractères) msg Le message qui apparaît dans la boîte de dialogue (une chaîne). picture_url l'URL de l'image à inclure dans le dialogue. redirect_url Le "SiteURL" de votre application sur la page des paramètres de l'application Facebook Developers. ds_map_response Un ds_map pré-créé qui est utilisé pour stocker les détails de la réponse.
N/A
Avec cette fonction, vous pouvez faire en sorte que votre jeu affiche une boîte de dialogue Facebook "apprequests", qui permettra à votre joueur de sélectionner des amis dans une liste et de lui envoyer un message d'invitation au jeu. La fonction nécessite que vous fournissiez une création précédemment créée ds_map qui sera ensuite rempli avec les détails de l'utilisateur pertinents. Cette carte devrait être interrogée à chaque étape après avoir appelé cette fonction car la réponse pourrait apparaître à tout moment, et quand elle le fera la carte devrait avoir une clé " à " qui retournera une liste contenant tous les identifiants utilisateur Facebook des personnes invitées (voir exemple prolongé ci-dessous pour plus de détails).
NOTE: Le "SiteURL" est ignoré sur Android modules iOS et Android et n'est requis que sur le module HTML5 si vous n'hébergez pas l'application sur le "SiteURL" (ie: vous testez en local).
REMARQUE: L'utilisateur n'a pas besoin d'être connecté pour utiliser cette fonction car la boîte de dialogue de connexion sera affichée dans le cadre de la demande d'invitation.
Vous pouvez envoyer une invitation à des amis de la manière suivante:
if mouse_check_button_pressed(mb_left)
{
map = ds_map_create();
facebook_send_invite("Catch The Haggis!", "Come
and play Catch The Haggis with me...",
"http://MacSweeneygames.com/Clown.jpg", "", map);
}
Le code ci-dessus affichera un dialogue "apprequest" où vous pouvez sélectionner des amis à inviter à jouer au jeu, et il crée également un ds_map tenir les identifiants Facebook des utilisateurs invités. Cela doit ensuite être interrogé dans l'événement Step d'une instance pour recevoir les résultats, comme ceci:
if ds_map_exists(map, "to")
{
var list = ds_map_find_value(map, "to");
var size = ds_list_size(list);
for(var i = 0; i < size; i++;)
{
fb_uid[i] =
ds_list_find_value(list, i);
}
ds_map_clear(map);
}
Ce code vérifie le ds_map pour la clé "à" et quand il est ajouté, il accède alors à la liste ds-que "à" contient et boucle à travers, définissant le tableau "fb_uid" pour contenir les ID utilisateur qui ont été retournés.