Flash CS3-Dokumentation

Programmieren mit ActionScript 3.0 > Verwenden der externen API > Anforderungen und Vorzüge der externen API

Anforderungen und Vorzüge der externen API

Die externe API ist der Teil von ActionScript, der einen Mechanismus für den Datenaustausch zwischen ActionScript und anderem Code bereitstellt, der in einer „externen Anwendung" ausgeführt wird, die als Container für Flash Player fungiert (gewöhnlich ein Webbrowser oder eine eigenständige Projektoranwendung). In ActionScript 3.0 wird die Funktionalität der externen API durch die ExternalInterface-Klasse bereitgestellt. In den Flash Player-Versionen vor Flash Player 8 wurde für den Datenaustausch mit der Containeranwendung die fscommand()-Aktion verwendet. Die ExternalInterface-Klasse ersetzt fscommand(). Ihre Verwendung wird für den gesamten Datenaustausch zwischen JavaScript und ActionScript empfohlen.

HINWEIS

Für den Fall, dass Sie die alte fscommand()-Funktion verwenden müssen - beispielsweise um die Kompatibilität mit älteren Anwendungen zu wahren oder für die Interaktion mit einer SWF-Containeranwendung von Drittanbietern oder mit dem eigenständigen Flash Player - ist diese weiterhin als Funktion auf Paketebene im flash.system-Paket verfügbar.

Die ExternalInterface-Klasse ist ein Subsystem, das den Datenaustausch zwischen ActionScript bzw. Flash Player und JavaScript in HTML-Seiten bzw. allen Desktopanwendungen erleichtert, die eine Instanz von Flash Player enthalten.

Die ExternalInterface-Klasse steht nur in folgenden Fällen zur Verfügung:

In allen unterstützten Versionen von Internet Explorer für Windows (ab Version 5.0)
In einer Containeranwendung, z. B. einer Desktopanwendung mit einer Instanz des Flash Player-ActiveX-Steuerelements
In allen Browsern, die die NPRuntime-Schnittstelle unterstützen - derzeit folgende Browser:
- Firefox ab Version 1.0
- Mozilla ab Version 1.7.5
- Netscape ab Version 8.0
- Safari ab Version 1.3

In allen anderen Fällen (z. B. beim Ausführen in einem eigenständigen Player) gibt die ExternalInterface.available-Eigenschaft den Wert false zurück.

Mit ActionScript können Sie JavaScript-Funktionen in einer HTML-Seite aufrufen. Im Vergleich zu fscommand() bietet die externe API die folgende verbesserte Funktionalität:

Sie können jede gewünschte JavaScript-Funktion verwenden, nicht nur die Funktionen, die mit der fscommand-Funktion einsetzbar sind.
Sie können eine beliebige Anzahl von Argumenten mit frei wählbaren Namen übergeben. Sie sind nicht darauf beschränkt, einen Befehl und einen einzigen Argumentstring zu übergeben. Dadurch bietet die externe API viel mehr Flexibilität als fscommand().
Sie können unterschiedliche Datentypen übergeben (z. B. Boolean, Number und String). Die Beschränkung auf Parameter vom Typ String entfällt.
Sie können den Wert eines Aufrufs empfangen. Dieser Wert wird sofort (als Rückgabewert des Aufrufs) an ActionScript zurückgegeben.

WARNUNG

Wenn der Name der Flash Player-Instanz in einer HTML-Seite (das id-Attribut des object-Tags) einen Bindestrich (-) oder andere Zeichen enthält, die in JavaScript als Operator definiert sind (z. B. +, *, /, \, . usw.), sind ExternalInterface-Aufrufe aus ActionScript beim Anzeigen der Containerwebseite im Internet Explorer unwirksam.

Darüber hinaus funktionieren ExternalInterface-Aufrufe aus ActionScript nicht, wenn die die Flash Player-Instanz definierenden HTML-Tags (object und embed) in einem HTML-form-Tag verschachtelt sind.

Flash CS3

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/main/00000339.html