Uso da API externa

Flash Player 9 e posterior, Adobe AIR 1.0 e posterior

A API externa do ActionScript 3.0 (flash.external.ExternalInterface) permite a comunicação direta entre o ActionScript e o aplicativo de contêiner no qual o Adobe Flash Player está sendo executado. Existem diversas situações nas quais você poderá optar por usar a API externa como, por exemplo, ao criar a interação entre um documento SWF e o JavaScript em uma página HTML ou ao criar um aplicativo de área de trabalho que usa o Flash Player para exibir um arquivo SWF.

Você pode utilizar a API externa para interagir com um aplicativo de contêiner, como transmitir dados entre o ActionScript e o JavaScript em uma página HTML e como estabelecer a comunicação e fazer o intercâmbio de dados entre o ActionScript e um aplicativo de área de trabalho.

Algumas tarefas comuns da API externa são:

  • Obtenção de informações sobre o aplicativo de contêiner

  • Uso do ActionScript para chamar o código em um aplicativo de contêiner, incluindo uma página da Web ou um aplicativo de área de trabalho

  • Chamada do código do ActionScript a partir do código de um aplicativo de contêiner

  • Criação de um proxy para simplificar a chamada do código do ActionScript a partir de um aplicativo de contêiner

Nota: Esta discussão abrange apenas a comunicação entre o ActionScript em um arquivo SWF e o aplicativo de contêiner que inclui uma referência ao Flash Player ou à ocorrência na qual o arquivo SWF está carregado. Qualquer outro uso do Flash Player em um aplicativo está fora do escopo desta documentação. O Flash Player foi desenvolvido para ser usado como um plug-in de navegador ou como um projetor (aplicativo dedicado). Outros ambientes de uso podem ter suporte limitado.

Utilizando a API externa no AIR

Como um aplicativo AIR não possui um contêiner externo, esta interface externa geralmente não se aplica - ou não é geralmente necessária. Quando seu aplicativo AIR carrega um arquivo SWF diretamente, o código do aplicativo pode se comunicar diretamente como o código do ActionScript no arquivo SWF (sujeito a restrições de caixa de proteção de segurança).

No entanto, quando seu aplicativo AIR carrega um arquivo SWF utilizando uma página HTML em um objeto HTMLLoader ( ou um componente HTML no Flex) o objeto HTMLLoader serve como o contêiner externo. Portanto, você pode utilizar a interface externa para estabelecer comunicação entre o código ActionScript no SWF carregado e o código JavaScript na página HTML carregado no HTMLLoader.