Avantages de l’API externe et conditions requises

L’API externe correspond à la partie d’ActionScript qui fournit le mécanisme de communication entre ActionScript et le code exécuté dans une application dite externe, c’est-à-dire qui joue le rôle de conteneur pour Flash Player (en général un navigateur Web ou une application de projection autonome). Dans ActionScript 3.0, la fonctionnalité de l’API externe est assurée par la classe ExternalInterface. Dans les versions de Flash Player antérieures à Flash Player 8, l’action fscommand() était utilisée pour établir les communications avec l’application conteneur. La classe ExternalInterface remplace l’action fscommand().

La classe ExternalInterface est un sous-système qui simplifie les communications d’ActionScript et Flash Player avec JavaScript dans une page HTML ou avec toute application de bureau qui incorpore une occurrence de Flash Player.

La classe ExternalInterface est disponible uniquement dans les circonstances suivantes :

• Dans toutes les versions prises en charge d’Internet Explorer pour Windows (5.0 et ultérieure)

• Dans une application conteneur telle qu’une application de bureau utilisant une occurrence du contrôle ActiveX Flash Player

• Dans un navigateur qui prend en charge l’interface NPRuntime, qui actuellement comprend Firefox 1.0 et versions ultérieures, Mozilla 1.7.5 et versions ultérieures, Netscape 8.0 et versions ultérieures, ainsi que Safari 1.3 et versions ultérieures.

Dans tous les autres cas de figure (par exemple exécution dans un lecteur autonome), la propriété ExternalInterface.available renvoie la valeur false.

Depuis ActionScript, vous pouvez appeler une fonction JavaScript sur la page HTML. L’API externe apporte les améliorations fonctionnelles suivantes grâce à fscommand() :

• Vous pouvez utiliser toutes les fonctions JavaScript, pas seulement les fonctions compatibles avec fscommand().

• Vous pouvez transmettre n’importe quel nombre d’arguments, avec n’importe quels noms ; vous n’êtes pas limité à une commande et une chaîne d’argument. L’API externe offre donc bien plus de souplesse que fscommand().

• Vous pouvez transmettre divers types de données (Boolean, Number et String, entre autres) et n’êtes plus limité aux paramètres String.

• Vous pouvez recevoir la valeur d’un appel, et cette valeur retourne immédiatement à ActionScript (comme la valeur de retour d’un appel que vous faites).