Paramétrage d'une Connexion

Afin que deux ordinateurs puissent communiquer entre eux, il est nécessaire de disposer d'un protocole de connexion. Comme dans la plupart des jeux, Game Maker offre quatre types différents de connexions : IPX, TCP/IP, par Modem et Série. La connexion IPX (pour être plus précis, il s'agit d'un protocole) est pratiquement totalement transparente aux utilisateurs. Elle peut être utilisée pour jouer à des jeux avec d'autres personnes se trouvant sur le même réseau local. Pour être effective, elle doit être installée sur votre ordinateur (dans le cas où cela ne fonctionnerait pas, veuillez consulter la documentation de Windows ou aller dans le panneau de configuration de Windows, rubrique "réseau", puis ajoutez le protocole IPX). TCP/IP est le protocole d'internet. Il peut être utilisé pour jouer avec d'autres joueurs n'importe où sur Internet, à condition que vous connaissiez votre adresse IP. Dans le cas d'un réseau local, il n'est pas obligatoire de fournir des addresses. Une connexion par modem s'effectue par modem comme son nom l'indique. Vous devrez fournir quelques réglages du modem (une chaîne d'initialisation et un numéro de téléphone) avant de pouvoir l'utiliser. Enfin, quand vous utilisez une ligne série (c'est à dire une connexion directe entre les ordinateurs), il est nécessaire de paramétrer un certain nombre de ports. Il existe quatre fonctions GML que l'on peut utiliser pour initialiser ces connexions :

mplay_init_ipx() Initialise une connexion IPX.
mplay_init_tcpip(addr) Initialise une connexion TCP/IP. addr est une chaîne contenant l'adresse du site web ou encore l'adresse IP, par exemple 'www.gameplay.com' ou '123.123.123.12', éventuellement suivie par un numéro de port (exemple : ':12'). C'est seulement quand vous vous joignez à une session de jeu (voir ci-dessous) qu'il est nécessaire de fournir une addresse. Dans le cas d'un réseau local, il n'est pas nécessaire d'indiquer une adresse IP.
mplay_init_modem(initstr, phonenr) Initialise une connexion par modem. initstr est la chaîne d'initialisation destinée au modem (peut être vide). phonenr correspond à la chaîne contenant le numéro de téléphone à appeler (exemple : '0201234567'). Un numéro de téléphone n'est nécessaire qu'à l'instant où vous rejoignez une session (voir ci-dessous).
mplay_init_serial(portno, baudrate, stopbits, parity, flow) Initialise une connexion série. portno est le numéro de port (1 à 4). baudrate est la vitesse en bauds à utiliser (100 à 256K). stopbits indique le nombre de bits d'arrêt (0 = 1 bit, 1 = 1.5 bit, 2 = 2 bits). parity indique la parité (0=aucune, 1=impaire, 2=paire, 3=mark). Et flow précise le type de contrôle de flux (0=aucun, 1=xon/xoff, 2=rts, 3=dtr, 4=rts et dtr). Retourne une valeur en cas de succés. Un appel typique sera par exemple : mplay_init_serial(1,57600,0,0,4). Donnez la valeur 0 comme premier argument pour ouvrir une boîte de dialogue permettant à l'utilisateur de modifier les réglages.

Votre jeu devra invoquer l'une de ces fonctions une seule fois précisément. Toutes les fonctions signalent si la commande a réussi. Ces fonctions se terminent en échec si le protocole particulier n'est pas installé ou n'est pas supporté par votre système. Afin de vérifier si la connexion en cours a réussi, vous pourrez utiliser la fonction suivante :

mplay_connect_status() Retourne le statut de la connexion courante. 0 = pas de connexion, 1 = connexion IPX, 2 = connexion TCP/IP, 3 = connexion par modem et 4 = connexion série.

Pour clôre la connexion en cours :

mplay_end() Ferme la connexion courante.

Si vous utilisez une connexion TCP/IP, vous pourrez vouloir indiquer à la personne avec laquelle vous jouez, l'adresse IP de votre ordinateur. La fonction suivante vous le permettra :

mplay_ipaddress() Retourne l'adresse IP de votre machine (exemple : '123.123.123.12') sous la forme d'une chaîne de caractères. Il vous sera par exemple possible d'afficher cette information à un endroit précis de l'écran. Veuillez noter que cette routine est lente cependant, aussi ne l'utilisez pas en permanence.

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