Le plugin Xap

Un nouveau plugin pour Xlobby est disponible. XAP-Xlobby permet de connecter Xlobby au monde xAP.

1) Xap ! C'est quoi ?

XAP est un protocole de communication entre applications ou agents. Encore un nouveau protocole allez-vous me dire ?  oui mais celui-ci est simple car basé sur des échanges de messages textes formatés, multi-plateforme et multi-machine. En conclusion, les applications compatibles xap communiquent entre elles via ces messages, qu’elles soient sur le même poste ou le même réseau local, un peu comme des personnes qui parleraient autour d’une table. Ce mode a surtout été crée pour facilité la  domotisation de vos maisons.

2) Tu n'aurais pas un exemple, par hasard ?

Bien sûr ! Imaginez : l’agent 1 en charge de surveiller vos comptes de messagerie envoie un message à destination de tout le monde signalant l’arrivée d’un nouveau mail. Xlobby (agent 2) vous en informe et affiche alors son objet. Puis, il envoie un message à destination d’un agent 3 en charge de piloter la gestion vocale (API de windows) lui demandant de dire la phrase suivante « Attention, vous venez de recevoir un nouveau message » Ca donne par exemple …

Sympa non ?

3) D'autres exemples ?

En fait tout ou presque, est possible du moment ou vous trouver un agent qui le permet ou une âme charitable qui vous écrit cet agent. Actuellement, ce protocole s’installe très vite dans le monde de la domotique et un grand nombre d’applications (ou agents) existent comme les 3 cités dans l’exemple ci dessus. Pour vous en convaincre aller voir cette adresse :

http://wiki.xapautomation.org/tiki-index.php?page=XapApplications-List&PHPSESSID=1d5b842a236b2b92c238dba3bab1d815

4) Xlobby va pouvoir faire plein de nouveaux trucs, non ?

Oui, plein. Le plugin est ouvert et permet de configurer les messages que Xlobby va pouvoir envoyer donc les ordres qu’il va pouvoir donner et les messages qu’il va pouvoir écouter donc les actions qu’il devra faire sur une action externe.

5) Mise en oeuvre

Tout d’abord, il faut installer tous les agents nécessaires.

Pour Xlobby, soyez sûr d'avoir une version récente, http://www.xlobby.com/xlobby2.zip et téléchargez puis décompressez l’archive http://www.france.xlobby.com/forum/ptrinchi/xAP_plugin.zip

Copiez les :

-       6 DLL dans votre dossier de xlobby2.exe (soit xlobby ou xlobbyfr)

-       un dossier dans le dossier plugins nommé xAP-Xlobby avec 2 fichiers : AP-Xlobby.dll et xAP.ini

-       un dossier dans xAP-Xlobby nommé Schema contenant 2 fichiers : actions.xml et events.xml

 

Ensuite, il faut installer vos autres agents. Dans le reste de l’exemple, nous allons essayer de faire communiquer Xlobby avec le serveur de comptes POP3 pour être informé de l’arrivée d’un nouveau mail comme l’image ci-dessus. Un agent de ce type existe déjà, vous pouvez le télécharger à l’adresse suivante :

 http://www.xapframework.net/modules.php?na...showpage&pid=13

Maintenant, il faut paramétrer les agents.

Commençons par l’agent POP3. Ne vous inquiétez pas, le pop3 examine vos boites mais ne les vide pas, il ne passe pas non plus les messages non lus en lus.

Double-cliquez sur MailMonitor.exe, vous obtenez la fenêtre suivante :

  

 Cliquez sur l'icone dans le cadre rouge  pour paramétrer les comptes à surveiller.

  

 Sous Mailbox and Logins paramétrez vos comptes. La subaddress doit être un chiffre (cadre rouge) qui va s’incrémenter pour rendre l’élément unique.

Vous pouvez aussi aller modifier les fréquences d’interrogation sous Access Frequency.

A partir de ce moment, des lignes apparaissent dans l’historique, si vous n’avez aucune croix rouge (photo ci dessous) tout va bien sinon c'est que vous avez mal configuré votre compte. Corrigez votre erreur.

 

5) Mon agent POP3 est OK, on passe à Xlobby ?

Il n’y a pas de paramétrage pour le plugin de Xlobby. Il faut juste vérifier que ce dernier est bien reconnu. Aller dans le setup de Xlobby via F2. Sous l’onglet plugin vous devez avoir une ligne pour xAP-Xlobby. Oui ? alors tout est ok. Non ? Il vous faut vérifier que tous les fichiers cités ci-dessus lors de l’installation sont bien présents.

Maintenant, Xlobby, lors de la réception d’un message de nouveau mail, va chercher à lancer un événement qui s’appelle goto new mail dans le groupe goto. A vous de créer ce que vous voulez comme action pour cet événement. Sachez seulement que Xlobby peut aussi afficher des informations venant des agents comme le sujet de votre nouveau mail (voir l’image d’exemple) 2 informations sont disponibles, pour les afficher utilisez une zone texte et mettez dedans

plugin>xap-xlobby>text>xxx ou plugin>xap-xlobby>state>xxx

xxx représentant l’adresse de l’objet pop3. Pour connaître exactement la valeur de cette adresse double cliquez sur une des lignes de l’application xAP Mail Monitor ayant new mail status dans la colonne event. Vous allez trouver une ligne du type source=KCSoft.MailMonitor.AAAAA:pop_free_fr.XXXXX, tout ce qui est à droite du caractère : (pop_free_fr.XXXXX dans notre cas) est votre adresse.

 Version 1 par ptrinchi (22/07/2005)