Documentation Utilisateur

Transcription

1 EIP 2013 Documentation Utilisateur v1.6 30/12/12

2 Résumé Cette documentation est destinée aux utilisateurs voulant jouer contre l intelligence artificielle et qui souhaite utiliser l interface web mise en place par notre groupe en février Ce document offre un tour des prérequis nécessaires à l utilisation de l interface web ainsi que le moyen de se connecter à la plate-forme de test pour pouvoir jouer contre l IA. Il sera également expliqué l utilisation de l interface web afin de rendre la première utilisation plus facile. 2

3 Informations sur le projet Groupe : riquet_t, roncin_d, boone_c, bousqu_r, chaber_f, lentz_a, maire_e, remy_t. Nom du projet : Type de document : Documentation utilisateur Version : 1.6 Référence : UD6_FR Statut du document : Table des révisions Historique des révisions du document Version Date Description /03/2012 Création du document /04/2012 Correction après relecture /05/2012 Correction pour le DA /06/2012 Correction après relecture /07/2012 Correction pour le TAF /08/2012 Correction après relecture /12/2012 Correction pour le TAF5 3

4 Table des matières Résumé... 2 Informations sur le projet... 3 Table des révisions Introduction Les pré-requis : ce qu il faut vérifier avant de «se lancer» Navigateur internet Cookies Connexion au serveur L interface La base Comment jouer Mode Replay Conclusion Liste des problèmes connus FAQ

5 1. Introduction Ce document constitue la documentation utilisateur officielle de l'utilisation de l intelligence artificielle pokerbot. Le but de ce projet est de réaliser une IA de poker, c est-à-dire un programme intelligent capable de prendre des décisions lors d une partie de poker Texas Holdhem no limit, la variante de poker la plus jouée sur internet et lors de tournois officiel. Cette IA est également capable d expliquer a un humain le cheminement de sa prise de décision. est un programme capable d'observer ses adversaires pour pouvoir dessiner un profil dynamique et capable de s'adapter afin d'exploiter de la meilleure façon possible les failles des stratégies adverses. Pourquoi? Bien souvent les centres de recherche développant des intelligences artificielles se concentrent uniquement sur les performances de leurs IA mais ils en oublient le fait que les humains jouent également., en plus d être une IA performante, possède également un mode didactique capable de donner des cours de poker pour des joueurs novices, amateurs, ou fraîchement professionnels. Afin d en faciliter l utilisation, le package contient également une plateforme web. Il est maintenant possible de se connecter à un client de Poker directement d un navigateur internet. 5

6 2. Les prérequis : ce qu il faut vérifier avant de «se lancer» 2.1. Navigateur internet Avant de se rendre à l URL de il faut vérifier que votre navigateur internet est assez récent pour supporter le fonctionnement du client web. Le client utilise HTML 5 il faut donc que votre navigateur puisse l utiliser, voici la liste des navigateurs : Chrome : supporté version 4+ Firefox : supporté mais désactivé version 4+ IE : non supporté Opéra : supporté mais désactivé version 11+ Safari : supporté version 5+ (Le manque de support des navigateurs est dû à des failles de sécurité dans la spécification du protocole) 2.2. Cookies Vérifiez que les cookies sont activés sur votre poste. L'accès à l'interface fonctionne sans, mais des dysfonctionnements pourraient apparaitre s'ils ne sont pas activés. Chrome : Personnaliser et contrôler Google Chrome -> Options -> Options avancées -> Confidentialité -> Paramètres des cookies -> Autoriser tous les cookies Firefox : outils -> options -> vie privée Opéra : Outils -> Préférences rapides -> Activer les cookies Safari : Safari -> Préférences -> Sécurité -> Accepter les cookies 6

7 3. Connexion au serveur Après avoir vérifié la compatibilité de la configuration de votre navigateur avec les prérequis décrits dans le chapitre précédent, rendezvous à l'url suivante : pokerbot.acsel.epitech.eu Vous arrivez sur une page simple avec une liste de différentes options : - Rejoindre une partie : vous permet de rejoindre ou de créer votre propre partie - Parties jouées : vous permet de revoir une ancienne partie joué - Site vitrine : vous redirige vers notre site vitrine - Forum : vous redirige vers notre forum - Les liens Facebook et tweeter en bas vous redirige vers notre page de réseaux sociaux. C est tout, nous allons voir comment se connecter à une salle et jouer contre l A maintenant. 7

8 4. L interface 4.1. La base Sur la première page, allez dans le menu «rejoindre une partie» puis choisissez la salle de poker que vous souhaitez rejoindre. 8

9 Une fois dans la salle vous pouvez jouer immédiatement. Voici un bref aperçu de l interface : 1- Etat de la connexion avec le serveur. 2- Si vous êtes hors ligne vous pouvez utiliser ce bouton pour relancer le serveur. Il faudra rafraichir la page après. 3- Lance une partie. 4- Arrête une partie. 5- Ajoute un IA. 6- Mélange ou non les cartes entre chaque partie. 7- Boutons d action. 8- Messagerie instantanée avec les autres joueurs dans la partie. 9

10 4.2. Comment jouer Une fois connecté vous serez dans cette situation. Ici personne ne s est connecté avant, nous sommes donc le «Player 1». Pour lancer la partie il faut qu il y est au minimum deux joueurs sur la table, nous pouvons soit attendre qu un autre joueur arrive soit cliquer sur les boutons 5 afin d ajouter une IA à la table. 10

11 Une fois que deux joueurs ont rejoint la room le jeu commence. Ici c est à nous de jouer il faudra donc utiliser les boutons 7 pour jouer. Si c est à une IA de jouer elle jouera toute seule sans problème. Si une IA mode professeur est lancé il est possible de discuter avec elle grâce au chat, 2, pour demander de l aide. Elle parlera également toute seule afin d expliquer chaque action qu elle entreprend. Mise à part cela tout se déroule comme une partie de poker classique. 11

12 5. Mode Replay Le mode replay est uniquement utilisé pour revoir des parties afin d étudier le comportement des adversaires. Dans ce mode il est possible de voir les cartes de tous les joueurs facilitant ainsi l apprentissage. Dans la partie «Parties jouées» il est possible de choisir quelle partie vous voulez revoir. Il suffit de cliquer sur le lien qui nous intéresse. 12

13 1- Voir la main précédente 2- Voir l action précédente 3- Voir l action suivante 4- Voir la main suivante En cliquant sur les boutons il est possible de revoir toute la partie au rythme qui vous convient. 13

14 6. Conclusion A l'aide des quelques explications données dans cette documentation, des fenêtres d'aide intégrées à l'interface (quand vous voyez un "?", cliquez dessus et vous accéderez à des explications supplémentaires), vous devez pouvoir utiliser pleinement l'ensemble des fonctionnalités présentes dans cet outil. 14

15 7. Liste des problèmes connus - Impossible de se connecter au serveur de test suite à une mise à jour du navigateur internet. -> Repasser à votre ancienne version ou bien essayez un autre navigateur internet. - L IA étant encore en phase de développement il se peut qu elle cesse de marcher. -> Relancer une partie. - Déconnexion de la partie ou perte des jetons lors d un rafraichissement de la page. 15

16 8. FAQ - Est-ce que je peux tester gratuitement? Tout à fait il suffit pour cela de nous contacter afin d obtenir l adresse internet de notre plate-forme de test. - La page m affiche toujours «error» quand je me connecte. Vérifiez que votre navigateur internet est de la bonne version (Cf 2.1 Navigateur internet). S il est de la bonne version contacté notre équipe pour vérifier qu un serveur est actif. - L IA ne joue plus. Notre IA étant encore en phase de développement il se peut qu elle se bloque, il vous suffit de relancer une partie. - Comment puis-je me tenir au courant? Il est possible de nous suivre sur facebook ( ou tweeter ( ) ou bien sur le forum ( 16