Greg's Blog

Ce tutoriel ne vient pas entièrement de moi, j’ai collaborté avec PyroFrissons de RedStation afin de vous aider à créer simplement votre propre bot MSN. Bon bien sur, je n’ai pas pu résister à la tentation de modifier certaines choses et de rajouter des morceaux que j’avais posté dans mon mon premier tuto. De plus, j’ai du me taper toute la mise en forme et l’insertion d’images dans l’article ! Cette fois, notre source comprend une interface graphique complète et de nouvelles fonctions très utiles. Si vous souhaitez voir le résultat d’un bot msn, ajoutez le mien (madbot@hotmail.fr) à vos contacts MSN.

[Le Tuto] : Robot MSN (SDK Incesoft)

Nous sommes fiers de vous présenter aujourd’hui notre bot MSN réalisé en C#. Nous sommes deux à l’origine de ce projet, d’un côté Greg pour la base du bot et de l’autre PyroFrissons pour la création de l’interface graphique et de toutes les nouvelles fonctionnalités s’y rapprochant. C’est pour cela que le tuto sera présent sur nos deux sites. Nous allons donc de ce pas vous apprendre à créer votre propre robot MSN à l’aide de notre source. Suivez attentivement tout ce qui va suivre pour ne pas être perdu.

1. Mises à jour

Voici une liste des plus complètes qui détaille les modifications apportées au bot depuis sa 1ère version.

• Création d’une interface graphique
• Choix de l’identifiant de connexion
• Changement du surnom et du message personnel
• Changement de l’avatar
• Console colorisé personnalisable
• Affichage de la réponse du robot
• Envoi de messages différés à un contact
• Mode passif et pause si nécessaire
• Liste noire (pour les contacts bannis)
• Liste d’administrateurs (depuis MSN)
• Enregistrement de ces listes
• Sauvegarde des conversations

2. Survol d’utilisation

Vous disposez de cinq onglets proposants tous les réglages mis à votre disposition afin de profiter plainement de votre futur bot. Détaillons les un par un.

2.1 – Panneau d’Administration

Vous pouvez soit paramétrer le robot pour une connexion depuis la source (que l’on vera tout à l’heure).
Soit depuis les deux cases prévus à cet effet démontré ci-dessous.
Ne pas oublier les boutons radio (sorte de ronds cliquable), « Log Défaut » depuis la source et « Log Perso » depuis les cases!

2.2 – Réglages console

Vous pouvez régler les couleurs du fond et des textes de la console depuis cet onglet.
La suppression de messages de la liste est possible mais reste risqué à cause de certains bugs inexpliqués.
Sur la droite, vous pourrez aussi trouver une case à cocher, celle-ci vous permettra d’afficher ou non les messages envoyé par le robot en réponse aux contacts.

2.3 – Surnom et message personnel

D’ici, nous vous laissons la possibilité de modifier le surnom et le message personnel du robot à votre guise, d’où le nom de cette partie.
En supplément, nous avons disposé en dessous une fonction qui permettra d’envoyer des messages en différé au contact de votre choix !

2.4 – Mode du robot

Je crois que cette section renferme le plus d’option du programme (enfin, elle est très chargé).
Vous avez deux cases à cocher pour changer le statut du robot afin d’en priver l’usage aux administrateurs.
Mais aussi et le plus important du programme, la possibilité de placer des adresses en liste noire et administrative.
Vous pouvez aussi changer le mot de passe qui sera utilisé par les administrateurs. Le mot de passe d’origine est « 0000″ (quatre zéro). Lors du changement, il sera convertit en MD5 et donc irréversible.

Bien sur, ceci n’est pas le plus important mais sachez que vous pouvez toujours poser des questions via les commentaires si vous ne comprenez pas quelque chose.

2.5 – Sauvegarde Console

Certains de nos admirateurs, nous ont conseillés d’ajouter une sauvegarde de base sous fichier texte.
Donc nous avons bien évidemment équipé la bête afin de répondre à vos désirs.
Il est même possible de cocher une case pour enregistrer les messages directement après leurs affichage !

3. Inscription et configuration d’Incesoft

3.1 – Inscription

Pour pouvoir utiliser cette beauté de la programmation :razz: , il faut tout d’abord être inscrit sur le site qui propose le service. Rendez-vous sur sp.incesoft.com et sur la droite, cliquez sur le bouton vert « Register ».

Si vous ne savez pas quoi mettre, voici un exemple :

• Password : Votre mot de passe
• Confirm Password : Retapez votre mot de passe
• Company Name : Entrez un truc du genre : « Personal Usage »
• Contact : Votre adresse mail
• Telephone : Le mien c’est 0102030405, pas vous ?
• Email address : Votre adresse mail
• Server Location : Ne choissisez pas europe, il déconne !
• Location : Votre pays
• Province : Votre région

Note : Nous vous conseillons le serveur « CHINA » car le serveur européen subit des bugs.

3.2 – Configuration

Vous allez reçevoir un mail avec vos identifiants de connexion qui devront être inscrits dans le code source du bot. Retournez maintenant sur le site sp.incesoft.com pour vous identifier et commencer la configuration.

Vous arrivez maintenant sur une page pleine de cases, le plus important est le SPID, le mot de passe et « Display Picture » qui est tout simplement l’endroit où vous allez uploader l’avatar du bot.
Pour l’info, il est possible d’avoir jusqu’à 2 bot sur le même compte !

Si vous n’avez toujours pas d’adresse MSN pour votre bot, il est encore temps de lui en créer une ici !

• Faîtes défiler le menu de gauche : “SP Info management”
• Puis allez dans : « Msn account management »
• Cliquez sur “Add new account” et entrez les infos de votre compte MSN.
• Confirmer la manip

Et voilà, on a fait la moitié du travail, on va maintenant changer l’avatar !

• Faîtes défiler le menu de gauche : “Ressource management”
• Puis allez dans : « Display Picture »
• Cliquez sur “Add new Display Picture” et envoyez un PNG de 96*96px
• Pour changer l’avatar, il vous suffit de le changer depuis « SP Info management »

Cette partie est terminée, nous allons passer aux logiciels puis à un peu de code !

4. Installation et utilisation de SharpDevelop

4.1 – Installation des Composants

Pour commencer à coder, il va vous falloir des outils ! Téléchargez puis installez les dans l’ordre.

• Téléchargez et installez NET Framework 2.0 Runtime
• Téléchargez et installez NET Framework 2.0 SDK
• Téléchargez et installez SharpDevelop 2.1 ou Microsoft Visual C# 2005 Express

Vous pensiez avoir tout téléchargé ? Et non, il vous manque la prestigieuse source du robot ! Téléchargez là ici : RobotFormTXT(SRC).zip

4.2 – Utilisation de SharpDevelop

SharpDevelop est un logiciel de développement du langage CSharp ou C#. Ce langage requiert le .Net Framework de Microsoft pour fonctionner. Je vais vous faire une petite visite du programme mais sachez qu’il ressemble à Visual à quelques poins près, donc si vous préférez le logiciel de Microsoft.

Commencez par lancer ce fameux logiciel si ce n’est pas déjà fait.

La page sur laquelle vous tombez est une sorte de page web listant tous vos projets.
Nous, on s’intéresse seulement au bot donc cliquez sur « Ouvre une solution » puis cherchez après décompression de notre source le fichier « RobotForm.sln ».
Dès lors, SharpDevelop va se charger d’afficher le projet.

Ce panneau se situe à gauche ou à droite (en fonction du logiciel) est c’est une arborescence de votre projet (source), cela vous permettra de naviguer facilement entre les pages.
Toutes les pages en CSharp ont l’extension « .cs », voici un exemple : Form1.cs

Au centre, vous verrez soit le code de la page ouverte depuis l’arborescence, soit l’interface graphique pour une modification simpliste des composants de la form (fenêtre).

Voici les boutons qui vous permettent de passer du code à la gestion de l’interface graphique.

Sur notre code, vous pouvez voir des cases blanches contenant du texte, ce ne sont que des conteneurs pour éviter d’afficher tout le code.
Pour afficher la partie qui vous intéresse, jouez avec les [+] et [-] sur la gauche et juste devant les lignes.

Pour enregistrer les modifications vous pouvez cliquer sur les disquettes ou une simple pression des touches CTRL + S.

Cette zone est utile seulement pour la compilation, l’exécution et l’arrêt de la source (ceci pour créer l’executable « .exe » et l’essayer).

Une dernière chose importante qui permettra à tout le monde d’identifier vos problèmes s’il y en a.
C’est cette partie en bas qui permet plusieurs choses dont le plus important est qu’elle précise les erreurs de codage !
Il vous suffira donc de copier l’erreur présente ici (entièrement avec tout les chiffres) pour nous faire part d’un problème persistant. Bien sur, avant de poster, réfléchissez à ce que vous venez de faire et essayer de trouver vous mêmes la solution.

5. Codage et compréhension

Explications des parties importantes du code qui vous permettra d’y voir plus clair.
Tout ceci sera également démontré par des images pour une fine compréhension !

5.1 – Connexion depuis le programme

Au début du tutoriel nous vous avons présentés le panneau d’administration, et donc la connexion via le programme et non les deux cases.
Ceci est en fait réalisé depuis la source dans le conteneur « Variables », ouvrez-le puis vous trouverez ceci :

Modifiez les valeurs entre guillemets par votre SPID et mot de passe Incesoft (symbolisé par des étoiles).

Ceci n’est pas très utile mais vous pouvez changer la police « Comic Sans MS » par une autre, exemple : « Arial »

5.2 – Connexion automatique

Ne pensez pas trop, nous allons vous expliquer très simplement comment permettre à votre programme de démarrer et à de se connecter par la suite sans aucune assistance (si aucune erreur n’est présente).

Dirigez vous toujours dans le conteneur nommé « Variables » (pensez à le refermer à chaque fin d’utilisation), il vous suffit de modifier comme ci-dessus.

Si vous souhaitez essayer dès maintenant le programme, appuyez sur l’icone « lecture » dans la barre du haut.
N’oubliez pas de le stopper une fois le test réalisé.

5.3 – Apprentissage du robot

Maintenant, il va vous falloir modifier cette partie (et seulement ça) :

C’est ici que vous apprendrez tout à votre bot.
Nous comprenons que ça peut être compliqué pour les novice mais avec de la patience, vous comprendrez facilement.

5.3.1 – Où Aller

Ouvrez donc la classe de l’image du dessus pour afficher tout le code du robot.
Recherchez maintenant cette ligne. En dessous d’elle, c’est les instructions effectuées dès la réception d’un message.

Nous n’allons pas nous attarder ici car ce n’est pas là que tout commence.
Descendez un peu, à la ligne 2454 vous trouverez ceci :

Les lignes qui commencent par « // » sont des commentaires que le programme ignore totalement mais qui pourront vous servir de repères. Nous vous avons laissé deux exemple de réponses du robot, les salutations et les au revoir (boujour, ça va et au revoir). Le plus important est d’être méthodique lors de l’écriture des conditions.

5.3.2 – Comment ça marche ?

En informatique, nous appelons ça des conditions et cela nous permet de diriger les réponses en fontion de ce que dit le contact. Voici un exemple de condition :

Celle-ci vous l’oriez parrié, c’est pour que le bot comprenne les « au revoir » de dire différentes façons.
« au » + « revoir » + …
« bye » + …
« a+ » + …

En fait, tout ça permettra de répondre au contact soit : « a+ ;) », « @+ ;) » ou « Bye ! » (fonction aléatoire)

5.3.3 – Lui apprendre plus

Pour lui apprendre plus, il suffit de copier une codition entière, je m’explique.
Regardez la partie condition des adieux, vous voyez des crochets qui délimitent sont contenu.
Vous devez donc copier tout de l’image affiché en 5.3.2.

A l’identique juste après le crochet de fermeture, ce qui dennera une parfaite copie de la condition.
Pour lui faire comprendre autre chose que tout le temps « au revoir », il faut maintenant procéder à une modification mineur.

5.3.4.1 – Comprendre la condition

Nous restons donc sur la copie de cette fameuse condition pour lui faire comprendre autre chose.
En premier, c’est aux arguments de la condition elle-même qu’il faut s’attaquer.
Donc les lignes démontrées ci-dessous.

Vous pouvez voir que dedans, il y a toutes les façons possible de lui dire adieux.
C’est ce qu’il faut faire car les fautes des chateurs sont importantes (même pour moi).
Vous avez du remarcquer aussi qu’il n’y a pas d’accent et pas de cédille, c’est pour faciliter la vie au programme.
Donc si vous y mettez ces caractères, il ne les comprendra pas.

5.3.4.2 – Modifier la condition

Pour vous faire comprendre nous allons faire des exemples.
Quand je vais dire « au revoir » au robot, il va l’identifier par cette ligne :

Vos questions sont multiples et s’il manque des réponses, nous sommes là.
Pour séparer « au revoir » de « bye » par exemple, il faut mettre « || », c’est deux barres écrites par ALT GR + 6 sont des séparateurs.
Alors que « && » sont des assembleurs, c’est pour celà qu’entre « au » et « revoir » il y a ces deux bidules (lol).

Si les arguments sont disposés par deux sur chaque ligne c’est simplement pour une bonne implantation.
Vous pouvez donc changer ceci comme il vous plait, et pensez que les modifications sont toujours récupérables par les touches CTRL + Z.

Maintenant, voici un exemple à trous mots :

Vous avez certainement encore repéré les « && » entre cette fois « quoi », « de » et « neuf », je crois que sa rentre!
Et à une extrémité ceci « || » pour les séparer du reste.

« msgplus.IndexOf(« quoi ») > -1″ est en fait simple à comprendre pour le programme, mais nous ont fait que savoir à quoi c’est utile…
Vous pouvez changer sa par ceci « msgplus.CompareTo(« lol ») == 0″ au cas où le mot serait tapé que de cette façon (identique).
« msgplus » est en fait une variable où est stoqué le texte du contact et nous le gérons avec le reste.

5.3.4.3 – Le faire parler

Passons à la réponse du bot qui n’est pas très compliqué comparé à la condition (;)).
Donc voici tout ce qui est entre crochets :

Random en anglais veut dire aléatoire, c’est ce à quoi sa correspond car sa produit un chiffre à partir de rien.
Heu quesque je dis, en informatique il n’y a que des 1 et des 0 donc pas d’aléatoire.
Sa me chifone un peu quand même, mais vous aurez comprit que je joue l’imbéssile de service (lol).
Donc on lui donne le chiffre des milisecondes de notre horloge pour lui faire générer quelque chose d’approximativement aléatoire.
C’est déjà plus compréhenssilbe!!

La seul ligne qui dirige la valeur aléatoire sur nos phrases c’est celle-ci : int value = rand.Next(3);
Le nombre placé sur cette ligne est en fait le nombre de phrase que l’on propose.
Sur cet exemple nous en avons que trois et pour en rajoutez une il suffit de suivre comme ci-dessous sans oublier de changer le nombre de phrases que l’on a mit.

Voilà, vous devez tout savoir enfin pour changer els phrases c’est toujours entre guillemets donc maintenant c’est bon!

5.3.5 – Comprend Rien

Je suppose que depuis un moment vous fixez votre regarde sur « Rien Comprit » (désolé pour els fautes :)).
Ceci est en fait très simple, lors de l’arrivée du commentaire d’un contact il va scruter vos conditions.
Mais s’il ne trouve rien, il va se rabattre là dessus pour lui répondre, bien, que rien (^^).

Pour lui apprendre d’autres phrases que « J’ai rien comprit », vous savez maintenant comment faire!
Je vous déconseil de toucher à ce que vous comprenez pas sauf si votre logique égale la mienne… (Je me vante)

6 – Où est l’application?

C’est tout bête, allez dans le dossier de la source, et là deux répertoires se sont créer.
Allez dans « bin » puis dans « Debug », il vous faudra bien sur prendre et l’exécutable (avec l’icone du smiley) et la dll qui permet de tout faire fonctionner.

7 – Quelques rien du tout

J’espère que tout celà vous a été facile à comprendre car j’ai mit tout mon coeur à réaliser et l’applciation et le tutoriel.
Si vous avez aimé notre application et/ou tutoriel, vous serez aimable de nous laisser un commentaire pour nous faire savoir que cela vous plait!!

8 – Pour finir

Si vous souhaiter tester directement l’application sans apporter de changements à la source, nous vous fournissons l’exécutable pour l’essai seulement, car il comprend seulement les « bonjours », « ça va » et « au revoir » mais contient bien sur toutes les fonctionnalités. Téléchargez le ici : RobotFormTXT(BIN).zip

Merci d’avoir pris le temps de lire notre tutoriel !