Requisitos y ventajas de la API externa

La API externa es la parte de ActionScript que proporciona un mecanismo de comunicación entre ActionScript y el código que se ejecuta en una "aplicación externa", que actúa a modo de contenedor de Flash Player (normalmente un navegador Web o una aplicación de proyector independiente). En ActionScript 3.0, la funcionalidad de la API externa viene dada por la clase ExternalInterface. En las versiones de Flash Player anteriores a Flash Player 8, se usaba la acción fscommand() para llevar a cabo la comunicación con la aplicación contenedora. La clase ExternalInterface sustituye a fscommand() y se recomienda su uso para todas las comunicaciones entre JavaScript y ActionScript.

NOTA

La antigua función fscommand() aún está disponible como función a nivel de paquete en el paquete flash.system para los casos en los que resulte necesario usarla (por ejemplo para mantener la compatibilidad con aplicaciones anteriores o para interactuar con una aplicación contenedora de SWF de un tercero o con la versión autónoma de Flash Player).

La clase ExternalInterface es un subsistema que permite comunicar fácilmente ActionScript y Flash Player con JavaScript en una página HTML o con cualquier aplicación de escritorio que incluya una instancia de Flash Player.

La clase ExternalInterface sólo está disponible en los siguientes casos:

En todas las versiones compatibles de Internet Explorer para Windows (5.0 y versiones posteriores)
En una aplicación contenedora, como una aplicación de escritorio que utilice una instancia del control ActiveX de Flash Player
En cualquier navegador que admita la interfaz NPRuntime, entre los que se incluyen actualmente los siguientes:
- Firefox 1.0 o posterior
- Mozilla 1.7.5 o posterior
- Netscape 8.0 o posterior
- Safari 1.3 o posterior

En todas las demás situaciones (como al ejecutarse en un reproductor autónomo), la propiedad ExternalInterface.available devuelve el valor false.

Desde ActionScript se puede llamar a una función de JavaScript en la página HTML. La API externa ofrece las siguientes mejoras con respecto a fscommand():

Se puede utilizar cualquier función de JavaScript, no sólo que se usan con la función fscommand().
Se puede pasar un número arbitrario de argumentos y los argumentos pueden tener el nombre que se desee; no existe la limitación de pasar un comando con un único argumento de tipo cadena. Esto hace que la API externa sea mucho más flexible que fscommand().
Se pueden pasar diversos tipos de datos (como Boolean, Number y String); ya no se está limitado a los parámetros de tipo String.
Se puede recibir el valor de una llamada y ese valor vuelve inmediatamente a ActionScript (como valor devuelto de la llamada que se realiza).

ADVERTENCIA

Si el nombre asignado a la instancia de Flash Player en una página HTML (el atributo id de la etiqueta object) incluye un guión (-) u otros caracteres definidos como operadores en JavaScript (como +, *, /, \, ., etc.), las llamadas a ExternalInterface desde ActionScript no funcionarán cuando la página Web contenedora se visualice en Internet Explorer.

Además, si las etiquetas HTML que definen la instancia de Flash Player (las etiquetas object y embed) están anidadas en una etiqueta form HTML, las llamadas a ExternalInterface desde ActionScript no funcionarán.

Flash CS3

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/main/00000339.html