Utilisation de l’API externe

Flash Player 9 et ultérieur, Adobe AIR 1.0 et ultérieur

L’API externe ActionScript 3.0 (flash.external.ExternalInterface) autorise les communications simples entre ActionScript et l’application conteneur dans laquelle s’exécute Adobe Flash Player. L’API externe peut vous être utile dans plusieurs cas de figure, par exemple si vous créez une interaction entre un document SWF et JavaScript dans une page HTML ou si vous construisez une application de bureau qui affiche un fichier SWF à l’aide de Flash Player.

L’API externe permet d’interagir avec une application conteneur, de transmettre des données entre ActionScript et JavaScript dans une page HTML, ainsi que d’établir une communication et d’échanger des données entre ActionScript et une application de bureau.

Exemples de tâches courantes de l’API externe :

  • Obtention d’informations sur l’application conteneur

  • Utilisation d’ActionScript pour appeler un code dans une application conteneur, y compris une page Web ou une application de bureau

  • Appel de code ActionScript depuis un code dans une application conteneur

  • Création d’un proxy pour simplifier l’appel de code ActionScript depuis une application conteneur

Remarque : seule une communication entre ActionScript dans un fichier SWF et l’application conteneur qui comprend une référence à Flash Player ou à l’occurrence dans laquelle ce fichier SWF est chargé est passée en revue ci-après. Toute autre utilisation de Flash Player dans une application n’est pas traitée dans cette documentation. Flash Player est conçu pour être utilisé comme plug-in de navigation ou de projection (application autonome). Les autres scénarios d’utilisation peuvent avoir une prise en charge limitée.

Utilisation de l’API externe dans AIR

Etant donné qu’une application AIR ne possède pas de conteneur externe, l’interface externe n’est généralement ni utilisée, ni requise. Lorsque l’application AIR charge directement un fichier SWF, le code correspondant peut communiquer directement avec le code ActionScript dans le fichier SWF (conformément aux restrictions du sandbox de sécurité).

Toutefois, lorsque l’application AIR charge un fichier SWF par le biais d’une page HTML dans un objet HTMLLoader (ou un composant HTML dans Flex), cet objet sert de conteneur externe. Le code ActionScript figurant dans le fichier SWF chargé peut ainsi communiquer avec le code JavaScript figurant dans la page HTML chargée dans l’objet HTMLLoader, par le biais de l’interface externe.