mProjector ActionScript 2

Extension mProjector AS2 v1.1.6

Pour l'utiliser :

1. Téléchargez le fichier mProjector_AS2.mxp (au-dessus)
2. Vérifiez que vous disposez du Macromedia Extension Manager
3. Installez l'extension et vous pouvez désormais utiliser mProjector dans vos fichier AS2.

Package des classes mProjector AS2 v1.1.6

Il suffit de dézipper le contenu de l'archive à la racine du dossier de classes de la version du logiciel Flash que vous utilisez. Au résultat les classes intrinsic contenues dans l'archive cotoient les classes intrinsic natives de Macromedia à la racine du dossier de classes.

mProjector est un logiciel de publication de projecteurs Flash. Il permet à une animation Flash d'intégrer des fonctionalités de communication avec le système d'exploitation. Ces fonctionnalités ne sont pas intégrées au lecteur Flash d'origine habituellement destiné à être exécuté dans l'environnement du navigateur.

Les API de mProjector peuvent être utilisées en syntaxe pointée directement dans Flash comme on utiliserait l'API de n'importe quelle autre implémentation des sockets, Flashcom, XML, ou communication HTTP interne au lecteur d'origine.

Ce qui fait la différence de cette application par rapport à SWF studio ou Flash Studio c'est que l'exécution du code est faite de manière synchrone, ligne aprés ligne, rendant ainsi possible à une méthode système de retourner le résultat de son exécution directement dans le contexte d'exécution du lecteur Flash.

On peut par exemple écrire directement dans la fenêtre d'action de l'IDE de Flash :

var sContent:String = mFile.readString("C:\\Folder\\File.txt");
trace("Le fichier texte contient : " + sContent);

Ce qui retourne le contenu du fichier texte en temps réel lors de l'exécution du script dans l'animation.

Exemple concret d'utilisation de l'extension avec la classe mSystem et la méthode getComputerName.

Les appels aux méthodes de l'interface de mProjector sont interceptés par le projecteur à l'exécution de l'animation par une cuisine interne un peu obscure. En AS1 il n'est donc pas nécessaire de déclarer les classes mApplication, mWindow, mSystem, mFile, mRegistry et mMenu ainsi que toutes leurs méthodes documentées respectivement dans l'aide de mProjector avant d'y faire appel.

Seulement, les concepteurs de mProjector n'ont pour l'instant pas prévu que la plupart d'entre nous aient besoin de publier des applications AS2 en utilisant les fonctionalités offertes pas leur outil.

En effet pour pouvoir appeler une classe interne à mProjector représentant l'interface de l'API correspondante dans une de nos propres classes AS2 il faut écrire :

class myClass
{
    function getFileContent():String
    {
        return mFile.readString("C:\\Folder\\File.txt");
    }
}

Seulement l'appel à la méthode readString de la classe mFile n'est théoriquement possible que si cette classe et cette méthode sont déclarées dans les classes utilisées par le projet au moment de la publication, sinon le compilateur signale inévitablement une erreur.

C'est pourquoi, comme me l'a inspiré Francis Bourre (Petepx) dans un de ces billets sur le site TweenPix, j'ai crée un package contenant 6 fichiers .as correspondant aux 6 classes intrinsic propres à chaque API. Ainsi, les classes mApplication, mWindow, mSystem, mFile, mRegistry et mMenu semblent exister au moment de l'export ou de la vérification de syntaxe pour le compilateur qui n'y voit que du feu et n'affiche plus aucune erreur.