Créer et se Joindre à des Sessions

Quand vous vous connectez à un réseau, il peut y avoir plusieurs jeux se déroulant actuellement sur le même réseau. Nous appellerons cela des sessions. Ces différentes sessions peuvent correspondre à des jeux différents ou encore au même jeu. Un jeu doit s'identifier de manière unique sur le réseau. Heureusement, Game Maker fait ce travail pour vous. La seule chose que vous devez savoir est que lorsque vous modifiez l'ID du jeu dans l'écran des options, l'identification du jeu changera également. De cette manière, vous pourrez ainsi éviter que des personnes avec de vieilles versions de votre jeu ne puissent jouer contre des personnes disposant de la nouvelle version.

Si vous souhaitez lancer un nouveau jeu en mode multi-joueurs, il sera nécessaire de créer une nouvelle session. Vous utiliserez cette routine à cet effet :

mplay_session_create(sesname, playnumb, playername) Crée une nouvelle session pour la connexion réseau courante. sesname est une chaîne de caractères indiquant le nom de la session. playnumb est un nombre identifiant le nombre maximal de joueurs autorisés à jouer à ce jeu (utilisez 0 pour avoir un nombre arbitraire de joueurs). playname est votre nom de joueur. Retourne une valeur en cas de succés.

Une instance du jeu doit créer la session. L'autre ou les autres instances du jeu vous permettront de vous joindre à cette session. Ceci est légérement plus compliqué qu'il n'y parait. Vous devrez en premier lieu vérifier quelles sessions sont disponibles puis en choisir une pour vous joindre à une session. A cet effet, il existe trois routines importantes :

mplay_session_find() Recherche toutes les sessions qui acceptent encore des joueurs puis retourne le nombre de sessions trouvées.
mplay_session_name(numb) Retourne le nom de la session de numéro numb (0 étant la première session). Cette routine ne peut être appelée qu'après l'appel de la routine précédente.
mplay_session_join(numb, playername) Vous permet de rejoindre la session de numéro numb (0 étant la première session). playername correspond à votre nom de joueur. Retourne une valeur en cas de succès.

Il existe aussi une routine qui peut changer le mode de session. Elle devra être appelée avant de créer une session:

mplay_session_mode(move) Détermine si oui ou non l'on doit transférer la session cliente sur un autre ordinateur lorsque le client quitte la session. move ne peut prendre que les valeurs true ou false (valeur par défaut).

Pour vérifier le statut de la session courante, vous pourrez utiliser la fonction suivante :

mplay_session_status() Retourne le statut de la session courante. 0 = pas de session, 1 = session créée, 2 = session rejointe.

Un joueur peut arrêter une session en utilisant la routine suivante :

mplay_session_end() Termine la session pour ce joueur.

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