Verwenden der externen API

Flash Player 9 und höher, Adobe AIR 1.0 und höher

Die externe API für ActionScript 3.0 (flash.external.ExternalInterface) ermöglicht eine einfache Kommunikation zwischen ActionScript und der Containeranwendung, in der Adobe Flash Player ausgeführt wird. In verschiedenen Situationen bietet sich der Einsatz der externen API an, beispielsweise beim Erzeugen von Interaktionen zwischen einem SWF-Dokument und JavaScript in einer HTML-Seite oder beim Erstellen einer Desktopanwendung, in der Flash Player zum Anzeigen einer SWF-Datei verwendet wird.

Mithilfe der externen API können Sie die Interaktion mit einer Containeranwendung implementieren, Daten zwischen ActionScript und JavaScript in HTML-Seiten übergeben und die Kommunikation und den Datenaustausch zwischen ActionScript und einer Desktopanwendung herstellen.

Häufige Aufgaben der externen API sind beispielsweise:

  • Abrufen von Informationen über die Containeranwendung

  • Verwenden von ActionScript zum Aufrufen von Code in einer Containeranwendung, einschließlich einer Webseite oder einer Desktopanwendung

  • Aufrufen von ActionScript-Code aus Code in einer Containeranwendung

  • Erstellen einer Proxy-Klasse zum Vereinfachen des Aufrufs von ActionScript-Code aus einer Containeranwendung

Hinweis: In dieser Beschreibung der externen Schnittstelle wird ausschließlich die Kommunikation zwischen ActionScript in einer SWF-Datei und der Containeranwendung beschrieben, die einen Verweis auf Flash Player oder die Instanz enthält, in der die SWF-Datei geladen wurde. Alle anderen Verwendungsmöglichkeiten von Flash Player innerhalb einer Anwendung werden in diesem Handbuch nicht behandelt. Flash Player ist zur Verwendung als Browser-Plug-In oder als Projektoranwendung (eigenständige Anwendung) vorgesehen. Andere Nutzungsszenarien werden möglicherweise nur begrenzt unterstützt.

Verwenden der externen API in AIR

Da eine AIR-Anwendung keinen externen Container hat, ist diese externe Schnittstelle im Allgemeinen weder zutreffend noch erforderlich. Wenn Ihre AIR-Anwendung eine SWF-Datei direkt lädt, kann der Anwendungscode direkt mit dem ActionScript-Code in der SWF-Datei kommunizieren (sofern die Sicherheits-Sandbox keine Einschränkungen vorgibt).

Wenn die AIR-Anwendung jedoch eine SWF-Datei über eine HTML-Seite in einem HTMLLoader-Objekt lädt (oder eine HTML-Komponente in Flex), dient das HTMLLoader-Objekt als externer Container. Deshalb können Sie die externe Schnittstelle für die Kommunikation zwischen dem ActionScript-Code in der geladenen SWF-Datei und dem JavaScript-Code in der im HTMLLoader-Objekt geladenen HTML-Seite verwenden.