Messages

Le second mécanisme de communication supporté par Game Maker est l'envoi et la réception de messages. Un joueur peut envoyer des messages à un ou à tous les autres joueurs. Les joueurs peuvent voir si des messages sont arrivés et réagir en conséquence. Les messages peuvent être envoyés en mode garantie dans lequel on peut être certain qu'ils arriveront à leurs destinataires (mais au prix d'une certaine lenteur) ou en mode non garantie, qui est plus rapide.

Les routines suivantes d'adressage de messages existent :

mplay_message_send(player, id, val) Envoie un message au joueur indiqué (soit un identificateur ou un nom; utilisez 0 pour envoyer le message à tous les joueurs). id est un identificateur entier du message et val correspond à la valeur (soit un réel ou une chaîne). Le message est envoyé dans le mode non garantie. Si val contient une chaîne, la longueur maximale de la chaîne permise sera de 30 000 caractères.
mplay_message_send_guaranteed(player, id, val) Envoie un message au joueur indiqué (soit un identificateur ou un nom; utilisez 0 pour envoyer le message à tous les joueurs). id est un identificateur entier du message et val correspond à la valeur (soit un réel ou une chaîne). Le message est expédié dans le mode garantie. Si val contient une chaîne, la longueur maximale permise sera de 30 000 caractères.
mplay_message_receive(player) Réceptionne le prochain message de la file d'attente des messages en provenance du joueur indiqué (soit un identificateur soit un nom). Utilisez 0 pour recevoir les messages de tous les joueurs. La routine indique en retour s'il y avait effectivement un nouveau message. Dans l'affirmative, vous pourrez utiliser les routines suivantes pour en lire le contenu :
mplay_message_id() Retourne l'identificateur du dernier message reçu.
mplay_message_value() Retourne la valeur ou contenu du dernier message reçu.
mplay_message_player() Retourne le joueur ayant envoyé le dernier message reçu.
mplay_message_name() Retourne le nom du joueur ayant envoyé le dernier message reçu.
mplay_message_count(player) Retourne le nombre de messages restant dans la file d'attente pour le joueur player (utilisez 0 pour compter tous les messages).
mplay_message_clear(player) Supprime tous les messages en attente dans la file du joueur player (utilisez 0 pour supprimer tous les messages).

Quelques remarques sont à faire ici. En premier lieu, si vous souhaitez envoyer un message uniquement à un joueur en particulier, il vous faudra connaître l'unique id du joueur. Comme indiqué précédemment, vous pouvez obtenir cet id grâce à la fonction mplay_player_id(). Cet identificateur du joueur est également utilisé lorsque vous recevez des messages d'un joueur particulier. Alternativement, vous pouvez donner le nom du joueur sous forme de chaîne. Si plusieurs joueurs possédent le même nom, seul le premier recevra le message.

En second lieu, vous vous demandez peut-être pourquoi chaque message posséde un identificateur entier. La raison est que cela aide votre application à envoyer différents types de messages. Le réceptionnaire peut vérifier le type du message en utilisant l'id et effectuer les actions appropriées (en raison qu'il n'y a aucune garantie que les messages arrivent, envoyer l'id et la valeur dans différents messages peut causer de sérieux problèmes.)

<< Traduction française par Philippe Ragni - (2005) >>