Connexion à des sources externes > Echange de messages avec Flash Player > Utilisation de fscommand

Utilisation de fscommand

Utilisez l'action fscommand pour envoyer un message au programme, quel qu'il soit, hébergeant Flash Player. L'action fscommand possède deux paramètres : commande et arguments. Pour envoyer un message à la version autonome de Flash Player, vous devez utiliser des commandes et des arguments (paramètres) prédéfinis. Par exemple, l'action suivante définit le lecteur autonome pour qu'il affiche l'animation en taille plein écran lorsque le bouton est relâché :

on (release) {
	fscommand("fullscreen", "true");
}

Le tableau suivant indique les valeurs que vous pouvez spécifier pour les paramètres commande et arguments de l'action fscommand pour contrôler une animation lue dans le lecteur autonome (y compris les projections) :

Commande	Arguments	Objectif
quit	Aucun	Ferme la projection.
fullscreen	true ou false	La spécification de true définit Flash Player en mode plein écran. La spécification de false renvoie le lecteur en affichage normal du menu.
allowscale	true ou false	La spécification de false définit le lecteur de sorte qu'il soit toujours affiché dans sa taille originale et que son échelle ne soit jamais modifiée. La spécification de true oblige l'animation à adopter l'échelle 100 % du lecteur.
showmenu	true ou false	La spécification de true active le jeu complet des éléments de menu contextuel. La spécification de false masque tous les éléments de menu contextuel, à l'exception de A propos de Flash Player.
exec	Chemin de l'application	Exécute une application depuis la projection.

Pour utiliser fscommand pour envoyer un message à un langage de programmation tel que JavaScript dans un navigateur web, vous pouvez transmettre deux arguments quelconques dans les paramètres commande et arguments. Ces paramètres peuvent être des chaînes ou des expressions et seront utilisés dans une fonction JavaScript qui traite l'action fscommand.

Une action fscommand invoque la fonction JavaScript nomDeLanimation_DoFSCommand dans la page HTML qui contient l'animation Flash, où nomDeLanimation est le nom de Flash Player tel qu'il est affecté par l'attribut NAME de la balise EMBED ou par l'attribut ID de la balise OBJECT. Si le nom monAnimation a été affecté à Flash Player, la fonction JavaScript invoquée est monAnimation_DoFSCommand.

Pour utiliser l'action fscommand pour ouvrir une boîte de message depuis une animation Flash dans la page HTML avec JavaScript :

1	Dans la page HTML qui contient l'animation Flash, ajoutez le code JavaScript suivant :
	function Lanimation_DoFSCommand(commande, args) { if (commande == "fenêtreMessage") { alert(args); } }

	Si vous publiez votre animation en utilisant Flash avec le modèle FSCommand dans les paramètres de publication HTML, ce code est inséré automatiquement. Les attributs NAME et ID de l'animation seront le nom du fichier. Par exemple, pour le fichier monAnimation.fla, les attributs seront définis avec monAnimation. Pour plus d'informations sur la publication, consultez Publication.
	Alternativement, pour les applications Internet Explorer, vous pouvez associer un gestionnaire d'événement directement dans la balise <SCRIPT>, comme le montre cet exemple :
	<Script Language = "JavaScript" event="FSCommand (commande, args)" for= "Lanimation"> ... </Script>

2	Dans le document Flash, ajoutez l'action fscommand à un bouton, comme dans l'exemple suivant :
	fscommand("fenêtreMessage", "Ceci est une fenêtre de message invoquée depuis Flash.")

	Vous pouvez également utiliser des expressions pour l'action et les paramètres fscommand, comme dans l'exemple suivant :
	fscommand("fenêtreMessage", "Bonjour, " + name + ", bienvenue sur notre site web!")

3	Choisissez Fichier > Aperçu avant publication > HTML pour tester le document.

L'action fscommand peut envoyer des messages à Macromedia Director qui sont interprétés par Lingo comme des chaînes, des événements ou un code exécutable Lingo. Si le message est une chaîne ou un événement, vous devez écrire le code Lingo pour le recevoir depuis l'action fscommand et entraîner une action dans Director. Pour plus d'informations, consultez le centre de support de Director.

En Visual Basic, Visual C++, et dans d'autres programmes pouvant héberger les contrôles ActiveX, fscommand envoie un événement VB avec deux chaînes qui peut être traité dans l'environnement du langage de programmation. Pour plus d'informations, utilisez les mots-clés Flash méthod pour effectuer une recherche sur le centre de support de Flash.