Uso de la API externa

Flash Player 9 y posterior, Adobe AIR 1.0 y posterior

La API externa de ActionScript 3.0 (flash.external.ExternalInterface) permite una comunicación directa entre ActionScript y la aplicación contenedora en la que se ejecuta Adobe Flash Player. Existen varias situaciones en las que puede resultar práctico utilizar la API externa como, por ejemplo, al crear una interacción entre un documento SWF y JavaScript en una página HTML, o al desarrollar una aplicación de escritorio que utilice Flash Player para mostrar un archivo SWF.

Puede utilizar la API externa para interactuar con una aplicación contenedora, pasar datos entre ActionScript y JavaScript en una página HTML y establecer comunicación e intercambio de datos entre ActionScript y una aplicación de escritorio.

Algunas tareas habituales de la API externa son:

  • Obtener información acerca de la aplicación contenedora

  • Utilizar ActionScript para llamar a código de una aplicación contenedora, incluida una página web o una aplicación de escritorio

  • Llamar a código de ActionScript desde el código de una aplicación contenedora

  • Crear un proxy para simplificar las llamadas al código de ActionScript desde una aplicación contenedora

Nota: esta sección sobre la interfaz externa sólo describe la comunicación entre el código ActionScript de un archivo SWF y la aplicación contenedora que incluye una referencia a la instancia de Flash Player en la que se carga el archivo SWF. En esta documentación no se tratan otros usos de Flash Player en una aplicación. Flash Player se ha diseñado para utilizarse como un complemento de navegador o un proyector (aplicación autónoma). Puede haber compatibilidad limitada con otros escenarios de uso.

Uso de la API externa en AIR

Dado que una aplicación de AIR no tiene ningún contenedor externo, esta interfaz externa no suele activarse (ni suele necesitarse). Si su aplicación de AIR carga un archivo SWF directamente, el código de la aplicación puede comunicarse directamente con el código ActionScript del SWF (sujeto a restricciones del entorno limitado de seguridad).

No obstante, cuando su aplicación de AIR carga un archivo SWF mediante una página HTML en un objeto HTMLLoader (o un componente HTML en Flex), el objeto HTMLLoader hace de contenedor externo. De este modo, puede utilizar la interfaz externa para comunicarse entre el código ActionScript en el archivo SWF cargado y el código JavaScript en la página HTML cargada en el objeto HTMLLoader.