De externe API gebruiken

Flash Player 9 of hoger, Adobe AIR 1.0 of hoger

Met de externe API van ActionScript 3.0 (flash.external.ExternalInterface) is directe communicatie mogelijk tussen ActionScript en de containertoepassing waarin Adobe Flash Player wordt uitgevoerd. Er zijn verschillende situaties denkbaar waarin u gebruik wilt maken van de externe API, bijvoorbeeld wanneer u interactie tot stand brengt tussen een SWF-document en JavaScript in een HTML-pagina, of wanneer u een desktoptoepassing maakt die gebruikmaakt van Flash Player om een SWF-bestand weer te geven.

U kunt de externe API gebruiken om te communiceren met een containertoepassing, gegevens door te geven tussen ActionScript en JavaScript in een HTML-pagina en om communicatie tot stand brengen en gegevens uit te wisselen tussen ActionScript en een bureaubladtoepassing.

Sommige algemene externe API-taken zijn:

  • Informatie ophalen over de containertoepassing.

  • ActionScript gebruiken om een code in een containertoepassing aan te roepen, waaronder een webpagina of bureaubladtoepassing.

  • ActionScript-code aanroepen vanuit code in een containertoepassing.

  • Proxy maken om het aanroepen van ActionScript-codes uit een containertoepassing te vereenvoudigen.

Opmerking: Deze discussie over de externe interface beslaat alleen de communicatie tussen ActionScript in een SWF-bestand en de containertoepassing die een verwijzing naar Flash Player of de instantie bevat waarin het SWF-bestand is geladen. Elk ander gebruik van Flash Player binnen een toepassing valt buiten het bereik van deze documentatie. Flash Player is bedoeld om als browserinsteekmodule of als projector (zelfstandige toepassing) te worden gebruikt. De ondersteuning voor andere gebruiksscenario’s is mogelijk beperkt.

De externe API in AIR gebruiken

Aangezien een AIR-toepassing niet beschikt over een externe container, wordt deze externe interface niet algemeen toegepast en is de interface over het algemeen niet nodig. Wanneer uw AIR-toepassing rechtstreeks een SWF-bestand laadt, kan de toepassingscode rechtstreeks communiceren met de ActionScript-code in het SWF-bestand (afhankelijk van beperkingen met betrekking tot de beveiligingssandbox).

Wanneer uw AIR-toepassing echter een SWF-bestand laadt met een HTML-pagina in een HTMLLoader-object (of een HTML-component in Flex), fungeert het HTMLLoader-object als de externe container. Zo kunt u met de externe interface communiceren tussen de ActionScript-code in het geladen SWF-bestand en de JavaScript-code in de HTML-pagina die geladen is in de HTMLLoader.