{"id":62,"date":"2020-01-14T09:25:12","date_gmt":"2020-01-14T08:25:12","guid":{"rendered":"https:\/\/tutos.jusdeliens.com\/?p=62"},"modified":"2020-01-14T09:25:12","modified_gmt":"2020-01-14T08:25:12","slug":"pytactx-prise-en-main","status":"publish","type":"post","link":"https:\/\/tutos.jusdeliens.com\/index.php\/2020\/01\/14\/pytactx-prise-en-main\/","title":{"rendered":"Prise en main de l’API PytactX \ud83d\ude80"},"content":{"rendered":"\n
\"\"<\/figure><\/div>\n\n\n\n

Vous souhaitez vous initier \u00e0 la programmation avec Python tout en vous amusant ? <\/p>\n\n\n\n

Dans ce tutoriel, vous allez apprendre comment programmer un robot virtuel gladiateur (i.e. un agent) dans une ar\u00e8ne de jeu TactX, pour lui transmettre de l’intelligence afin de lui permettre d’affronter les agents ennemis en temps r\u00e9el, et tout ceci de mani\u00e8re autonome.<\/p>\n\n\n\n\n\n\n\n

\ud83c\udf10 Connexion \u00e0 une ar\u00e8ne du jeu<\/h2>\n\n\n\n

Avant de se lancer dans le combat dans l’ar\u00e8ne, il vous faut d’abord obtenir vos identifiants. Pour cela, rien de plus simple, \ud83d\udc49renseignez votre Pr\u00e9nom, Nom et Email dans ce formulaire<\/a>. Vous recevrez vos identifiants gratuitement sous 48h.<\/p>\n\n\n\n

Une fois re\u00e7us par mail, \u00e0 vos claviers et neurones ! Sur play.jusdeliens.com<\/a> renseignez vos username et password communiqu\u00e9s par mail, puis s\u00e9lectionnez l’ar\u00e8ne que vous souhaitez rejoindre.<\/p>\n\n\n\n

L’acc\u00e8s aux ar\u00e8nes publiques est enti\u00e8rement gratuit mais limit\u00e9. Elles sont ouvertes \u00e0 l’occasion d’affrontements ou de formations jusdeliens dont les dates vous seront communiqu\u00e9es via la newsletter (\ud83d\udc49par ici pour vous abonner<\/a>).<\/p>\n\n\n\n

Pour plus de libert\u00e9, vous pouvez cr\u00e9er votre propre ar\u00e8ne priv\u00e9e<\/a> h\u00e9berg\u00e9e sur un serveur jusdeliens, ouverte 24h\/24, 7 jours sur 7 et accessible dans le monde entier avec IDEAL Arena. Dans ce cas, votre ar\u00e8ne priv\u00e9e sera uniquement accessible \u00e0 ceux \u00e0 qui vous communiquerez son nom.<\/p>\n\n\n\n

Pour les plus t\u00e9m\u00e9raires, un tutoriel sera bient\u00f4t mis en ligne pour cr\u00e9er votre ar\u00e8ne et l’h\u00e9berger sur votre serveur priv\u00e9 (avec OVH ou free). Vous pouvez aussi vous \ud83d\udc49inscrire \u00e0 notre <\/a>p<\/a>r<\/a>o<\/a>c<\/a>h<\/a>a<\/a>i<\/a>n<\/a>e<\/a> <\/a>session de formation.<\/a><\/p>\n\n\n\n

\ud83d\udc63 Vos premiers pas<\/h2>\n\n\n\n

\ud83d\udcda Les modules<\/h3>\n\n\n\n

Premier concept \u00e0 ma\u00eetriser : la notion de module en python. <\/p>\n\n\n\n

Un module en programmation (appel\u00e9 encore librairie) est un fichier d\u00e9velopp\u00e9 par d’autres personnes. Il contient un autre programme que vous allez pouvoir utiliser dans votre programme principale. Son int\u00e9r\u00eat principal est de vous faire gagner du temps pour ne pas avoir \u00e0 tout recoder vous-m\u00eame.<\/p>\n\n\n\n

Pour jouer dans une ar\u00e8ne TactX, on va importer le module pytactx contenu dans un autre fichier, \u00e0 c\u00f4t\u00e9 de votre fichier main dans l’arborescence du projet.<\/p>\n\n\n\n

\"\"
Le fichier main.py contient votre programme principal, c’est dedans que vous d\u00e9velopperez votre programme. Le fichier agent.py dans le dossier j2l\/pytactx contient tout ce qu’il vous faut pour jouer. L’extension .py signifie programme PYthon.<\/figcaption><\/figure>\n\n\n\n

Dans le fichier main.py, ajoutons donc au d\u00e9but du programme la ligne suivante :<\/p>\n\n\n\n

import j2l.pytactx.agent as pytactx<\/code><\/pre>\n\n\n\n
Et voil\u00e0 ! Nous pouvons d\u00e9sormais cr\u00e9er notre agent pour combattre dans l’ar\u00e8ne !<\/p>\n\n\n\n
\ud83d\udcbe Les variables<\/h3>\n\n\n\n
Pour incarner notre agent, il nous faut ma\u00eetriser un 2e concept : la notion de variable. <\/p>\n\n\n\n
Dans un programme, une variable est comme une bo\u00eete de rangement. Elle vous permet de stocker une information (un texte, un nombre, une image …) afin de la manipuler par la suite. On donne un nom \u00e0 cette bo\u00eete afin de pouvoir s’en servir par la suite.<\/p>\n\n\n\n
Dans le module pytactx, la premi\u00e8re variable \u00e0 cr\u00e9er est votre agent. Pour cr\u00e9er cette variable nomm\u00e9e “agent” en Python, on utilise l’op\u00e9rateur \u00e9gal “=” (dit aussi op\u00e9rateur d’affectation). Cette op\u00e9rateur va nous permettre de placer dans notre “bo\u00eete” agent ce qu’il y a \u00e0 droite du \u00e9gal (on dit qu’on initialise la variable).<\/p>\n\n\n\n
agent = pytactx.Agent(playerId=\"LeNomDeMonSuperAgent\", username=\"VotreUserName\", password=\"VotrePassword\", arena=\"nomDeLArene\")<\/code><\/pre>\n\n\n\n
L’expression \u00e0 droite permet de cr\u00e9er votre agent et de le connecter \u00e0 l’ar\u00e8ne de jeu. A vous de remplacer les caract\u00e8res entre guillemets:<\/p>\n\n\n\n
  • “LeNomDeMonSuperAgent” : c’est le nom de votre agent qui apparaitra dans l’ar\u00e8ne<\/li>
  • “VotreUserName” : \u00e0 remplacer par le username transmis par mail<\/li>
  •  “VotrePassword” : \u00e0 remplacer par le password transmis par mail <\/li>
  •  “NomDeLArene” : \u00e0 remplacer par le nom de l’ar\u00e8ne \u00e0 rejoindre<\/li><\/ul>\n\n\n\n
    Une fois cr\u00e9\u00e9e, cette variable agent va notamment vous permettre d’acc\u00e9der aux variables de votre agent indiqu\u00e9e ci-dessous.  Attention par contre, ces variables sont en lecture seule, autrement dit vous ne pourrez pas les modifier directement ! (D\u00e9sol\u00e9 les tricheurs en herbe \ud83d\ude09 ) <\/p>\n\n\n\n
    \"\"
      Les variables de l’agent vous renseignent sur l’\u00e9tat de votre agent dans  le jeu. Elles ne sont accessibles qu’en lecture seule. Les nombres qu’elles contiennent sont des entiers positifs (type ‘int’ pour  integer  en Python).  <\/figcaption><\/figure><\/div>\n\n\n\n
    Gr\u00e2ce \u00e0 ces variables, vous pourrez modifier le comportement de votre agent en fonction de son environnement. Par exemple, si sa vie diminue, c’est … qu’il SE FAIT TIRER DESSUS !! Auquel cas, il serait pertinent de riposter !<\/p>\n\n\n\n
    \ud83e\udd14 Mais tu nous a pourtant dit qu’il n’\u00e9tait pas possible de les modifier directement ? <\/p><\/blockquote>\n\n\n\n
    Et oui, pour les modifier, il faudra utiliser quelque chose d’autre de bien plus puissant, les fonctions !<\/p>\n\n\n\n
    \u2699\ufe0fLes fonctions<\/h3>\n\n\n\n
    Heureusement, il est aussi possible de faire passer votre agent \u00e0 l’action ! 3e concept : les fonctions.<\/p>\n\n\n\n
    Une fonction est un sous programme qui, d\u00e8s lors qu’on l’appelle, ex\u00e9cute une suite d’instructions. Vous pouvez cr\u00e9er vos propres fonctions, par exemple si vous souhaitez ordonner votre programme, ou appeler plusieurs fois la m\u00eame suite d’instructions (comme une routine ou une proc\u00e9dure). Vous pouvez aussi utiliser des fonctions que d’autres d\u00e9veloppeurs ont cod\u00e9es pour vous.<\/p>\n\n\n\n
    Pour appeler une fonction en Python, il suffit d’\u00e9crire sur une nouvelle ligne :<\/p>\n\n\n\n
    nomDeVotreFonction(parametre1, parametre2)<\/code><\/pre>\n\n\n\n
    On reconnait une fonction par ses parenth\u00e8ses apr\u00e8s le nom de la fonction. Ces parenth\u00e8ses d\u00e9limitent les param\u00e8tres d’entr\u00e9e \u00e0 passer \u00e0 la fonction. Selon la fonction, le nombre de param\u00e8tres peut varier.  S’il y en a plusieurs, ils sont s\u00e9par\u00e9s par des virgules. Il peut ne pas avoir de param\u00e8tre du tout. Auquel cas, il n’y aura rien \u00e0 mettre en parenth\u00e8se <\/p>\n\n\n\n
    # Importe le module de maths pour faire des calculs complexes\nimport math\n\n# Appelle la fonction sqrt pour calculer la racine carr\u00e9 du nombre 4\nmath.sqrt(4)\n\n# Appelle la fonction pow pour calculer 2 \u00e0 la puissance 4 \nmath.pow(2,4) <\/code><\/pre>\n\n\n\n
    \ud83e\udd14 C’est quoi ces lignes qui commencent par des ‘#’ ?<\/p><\/blockquote>\n\n\n\n
    Ce sont des commentaires en python. Ce n’est pas du code qui sera ex\u00e9cut\u00e9, mais une aide pour mieux se rep\u00e9rer dans le code. Une bonne habitude \u00e0 prendre avant de coder est de toujours commencer par le commentaire, puis d’ajouter le code correspondant. De cette mani\u00e8re, si vous deviez reprendre votre code des mois plus tard, ou si un autre d\u00e9veloppeur devait reprendre votre travail, cela serait d’une aide consid\u00e9rable !<\/p>\n\n\n\n
    Bon, pour le moment, nous allons nous contenter d’utiliser les fonctions de votre agent qui ont d\u00e9j\u00e0 \u00e9t\u00e9 d\u00e9velopp\u00e9es pour vous. Voici les principales :<\/p>\n\n\n\n
    \"\"
     Les fonctions de votre agent vous permettent de la faire agir pour changer son \u00e9tat. <\/figcaption><\/figure><\/div>\n\n\n\n
    Pour tirer en rafale tout en d\u00e9pla\u00e7ant votre agent \u00e0 la colonne 6 en partant de la gauche et \u00e0 la ligne 7 en partant du haut de la grille, il faut donc \u00e9crire :<\/p>\n\n\n\n
    agent.fire(True)\nagent.moveTowards(6,7)\nagent.update()<\/code><\/pre>\n\n\n\n
    N’oubliez pas d’appeler la fonction update() <\/strong>une fois toutes vos actions effectu\u00e9es, afin d’envoyer votre demande au serveur.<\/p>\n\n\n\n
    \ud83e\udd14 Tu as mis un “T” majuscule \u00e0 Towards c’est normal ?<\/p><\/blockquote>\n\n\n\n
    \u26d4 Important<\/mark><\/strong>
    Oui, Python n’aime pas les caract\u00e8res sp\u00e9ciaux comme les espaces ou les accents dans les noms de variables et de fonctions. Du coup, on peut mettre une majuscule \u00e0 la place de l’espace, c’est la convention camelCase <\/strong>(comme les bosses du chameau \ud83d\udc2b), ou bien un underscore (le tiret du 8 qui rampe au sol comme un serpent \ud83d\udc0d) qui est la convention snake_case<\/strong>. Notez que Python est sensible \u00e0 la casse, donc agent.movetowards()<\/s><\/strong> ne marchera pas car la fonction est connu sous le nom agent.moveTowards()<\/strong>.<\/p>\n\n\n\n
    Bien maintenant que vous savez comment cr\u00e9er votre agent, r\u00e9cup\u00e9rer ses variables d’\u00e9tat et le faire ex\u00e9cuter des actions, il ne reste plus qu’\u00e0 relier tout cela avec de belles structures conditionnelles !<\/p>\n\n\n\n
    \ud83d\udeaaLes structures conditionnelles<\/h3>\n\n\n\n
    Et bien oui, c’est bien beau de savoir tirer mais vu votre nombre de munitions, il vaut mieux tirer uniquement quand un ennemi est devant vous non ? Et pour \u00e7a, il nous faut traduire l’expression suivante :<\/p>\n\n\n\n
    Si un ennemi est devant nous\n    Alors on lui tire dessus en rafale\nSinon\n    On arr\u00eate de tirer en rafale pour \u00e9conomiser nos pr\u00e9cieuses munitions<\/code><\/pre>\n\n\n\n
    Cette expression “Si Alors Sinon” est dite conditionnelle car l’action \u00e0 r\u00e9aliser d\u00e9pend d’une condition. En python, cette expression se traduirait par cela :<\/p>\n\n\n\n
    if ( agent.distance != 0 ):\n     agent.tirer(True)\nelse:\n     agent.tirer(False)<\/code><\/pre>\n\n\n\n
    Pour savoir si un ennemi est devant nous, nous comparons la variable d’\u00e9tat de l’agent “agent.distance”. Si elle est diff\u00e9rente de 0, c’est qu’un ennemi est devant dans la direction de notre agent. Si elle est \u00e9gale \u00e0 0, c’est qu’aucun ennemi n’est visible dans cette direction.<\/p>\n\n\n\n
    En python, on peut r\u00e9aliser diff\u00e9rents tests \u00e0 l’aides des op\u00e9rateurs suivants.<\/p>\n\n\n\n
    COMPARAISON<\/td>OP\u00c9RATEUR PYTHON<\/td><\/tr>
    Strictement sup\u00e9rieur \u00e0<\/td>><\/td><\/tr>
    Sup\u00e9rieur ou \u00e9gal \u00e0<\/td>>=<\/td><\/tr>
    Strictement inf\u00e9rieur \u00e0<\/td><<\/td><\/tr>
    Inf\u00e9rieur ou \u00e9gal \u00e0<\/td><=<\/td><\/tr>
    Egal \u00e0<\/td>==<\/td><\/tr>
    Diff\u00e9rent de<\/td>!=<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    \ud83e\udd14 C’est normal que tu aies mis 2 signes \u00e9gal pour la comparaison “\u00e9gal \u00e0” ?<\/p><\/blockquote>\n\n\n\n
    Absolument ! Souvenez vous, on a vu au d\u00e9but l’op\u00e9rateur d’affection ‘=’ pour cr\u00e9er et initialiser une variable. Pour distinguer l’affection de la comparaison, python (comme d’autres langages) a fait le choix d’utiliser 2 signes \u00e9gal ‘==’ pour la comparaison.<\/p>\n\n\n\n
    \ud83e\udd14 Pourquoi as-tu mis ‘:’ \u00e0 la fin du ‘if’ et du ‘else’ ?<\/p><\/blockquote>\n\n\n\n
    En python les structures conditionnelles, ainsi que les boucles et d\u00e9finitions de fonctions sont des blocs. Comme les blocs qui s’encapsulent sous Scratch, un bloc un python commence par ‘:’ . Les instructions \u00e0 ex\u00e9cuter dans ce bloc doivent \u00eatre pr\u00e9c\u00e9d\u00e9s d’une indentation.<\/p>\n\n\n\n
    \"\"
    Bloc “Si Alors” en Scratch \u00e0 gauche, et le bloc conditionnel correspondant en python \u00e0 droite<\/figcaption><\/figure>\n\n\n\n
    \ud83e\udd14 Une indentation ? Il faut que j’aille voir mon dentiste ?!<\/p><\/blockquote>\n\n\n\n
    Une indentation permet une meilleur lisibilit\u00e9 du code. De cette mani\u00e8re on peut rapidement voir les blocs d’instructions qui seront ex\u00e9cut\u00e9s selon les conditions. En python, en plus des ‘:’ au d\u00e9but du bloc, l’INDENTATION EST OBLIGATOIRE pour signifier que chaque instruction indent\u00e9e est \u00e0 ex\u00e9cuter dans le bloc sup\u00e9rieur qui la contient.<\/p>\n\n\n\n
    \ud83e\udd14 Combien de caract\u00e8res espaces as-tu mis pour faire l’indentation ?<\/p><\/blockquote>\n\n\n\n
    \u26d4 Important<\/mark><\/strong>
    Les indentations ne sont pas des caract\u00e8res d’espace comme les autres. Il est coutume d’utiliser la touche tabulation sur le clavier pour faire une indentation (la touche avec 2 fl\u00e8ches parall\u00e8les horizontales et oppos\u00e9es en haut \u00e0 gauche du clavier \u2194\ufe0f). C’est donc UN SEUL CARACT\u00c8RE TABULATION qui est recommand\u00e9, plut\u00f4t que plusieurs caract\u00e8res avec la touche espace.<\/p>\n\n\n\n
    Bon maintenant que toutes ces notions sont comprises, on va pouvoir ex\u00e9cuter le code suivant.<\/p>\n\n\n\n
    import j2l.pytactx.agent as pytactx\n\nagent = pytactx.Agent(playerId=\"jusdeliens\", username=\"monUserName\", password=\"vousNeLeSaurezJamais!\", arena=\"leNomDeVotreArene\")\n\nif ( agent.distance != 0 ):\n     agent.fire(True)\nelse:\n     agent.fire(False)\n\nagent.update()<\/code><\/pre>\n\n\n\n
    Sous repl.it, il ne vous reste plus qu’\u00e0 cliquer sur le bouton “Run” pour d\u00e9marrer votre programme.<\/p>\n\n\n\n
    \"\"
    Lancement du programme sous repl.it en appuyant sur le bouton “Run”<\/figcaption><\/figure><\/div>\n\n\n\n
    Dans la console (fen\u00eatre noire \u00e0 droite), entrer les informations demand\u00e9es puis entrer. Si la valeur par d\u00e9faut est correcte, tapez simplement entrer.<\/p>\n\n\n\n
    \"\"
    Entrez les informations demand\u00e9es dans la console puis entrer.<\/figcaption><\/figure><\/div>\n\n\n\n
    \ud83e\udd14 Il ne se passe rien dans l’ar\u00e8ne, je ne vois pas mon agent, c’est normal ?<\/p><\/blockquote>\n\n\n\n
    C’est normal ! Nous avons oubli\u00e9 une derni\u00e8re chose !<\/p>\n\n\n\n
    \u27bfLes boucles<\/h3>\n\n\n\n
    Si votre agent n’apparait pas, c’est parce le programme s’est termin\u00e9 trop vite. L\u2019interpr\u00e9teur python a bien ex\u00e9cut\u00e9 ligne par ligne le programme demand\u00e9, mais un fois arriv\u00e9e \u00e0 la ligne 13 le programme se termine.<\/p>\n\n\n\n
    \ud83e\udd14 Tu veux dire qu’on a oubli\u00e9 de lui dire de r\u00e9p\u00e9ter nos instructions pour ne pas s’arr\u00eater ?<\/p><\/blockquote>\n\n\n\n
    Exactement ! Et pour \u00e7a, il nous faut ma\u00eetriser un dernier concept : les boucles !<\/p>\n\n\n\n
    “R\u00e9p\u00e9ter tant que”, “r\u00e9p\u00e9ter pour chaque valeur de 0 jusqu’\u00e0 10”, voici de nouveaux blocs qui nous permettront d’enrichir nos programmes ! <\/p>\n\n\n\n
    On distingue 2 types de boucles : les born\u00e9es et les non born\u00e9es.<\/p>\n\n\n\n