flash.externalExtensionContext Die ExtensionContext-Klasse stellt eine Schnittstelle für den Aufruf von Funktionen in der nativen Implementierung einer ActionScript-Erweiterung bereit.flash.events:EventDispatcher Die ExtensionContext-Klasse stellt eine Schnittstelle für den Aufruf von Funktionen in der nativen Implementierung einer ActionScript-Erweiterung bereit. Sie können diese Klasse nur in ActionScript-Klassen verwenden, die Teil der Erweiterung sind.

AIR-Profilunterstützung: Diese Funktion wird nur auf Geräten mit AIR für TV in Anwendungen, die das extendedTV-Geräteprofil verwenden, unterstützt.

Eine ActionScript-Erweiterung ist eine Kombination aus:

ActionScript-Klassen.
Nativem Code. Nativer Code ist Code, der außerhalb der Laufzeitumgebung auf einem Gerät ausgeführt wird. Beispiel: In C geschriebener Code ist nativer Code.

Sie können eine ActionScript-Erweiterung erstellen, um einer AIR-Anwendung den Zugriff auf gerätespezifische Funktionen zu ermöglichen. Andere Gründe für das Erstellen einer ActionScript-Erweiterung sind die Wiederverwendung von vorhandenem nativen Code oder die Bereitstellung einer effizienteren Verarbeitung durch nativen Code, den Sie mit ActionScript-Code bereitstellen können. Weitere Informationen zum Schreiben, Erstellen und Komprimieren von ActionScript-Erweiterungen finden Sie in der PDF-Datei Developing ActionScript Extensions for Adobe AIR.

Verwenden Sie die ExtensionContext-Klasse auf der ActionScript-Seite einer ActionScript-Erweiterung, um auf die native Seite der Erweiterung zuzugreifen. Erstellen Sie zuerst eine Instanz der ExtensionContext-Klasse. Rufen Sie dazu die statische ExtensionContext.createExtensionContext()-Methode auf.

Nach dem Erstellen der ExtensionContext-Instanz rufen Sie mit der call()-Methode der Instanz eine native Funktion auf.

Wenn Sie mit einer ExtensionContext-Instanz fertig sind, rufen Sie dispose() auf, um ggf. verknüpfte native Ressourcen freizugeben. Ohne einen expliziten Aufruf von dispose() ruft die automatische Speicherbereinigung (Garbage Collector) der Laufzeitumgebung dispose() auf, wenn sie die Instanz entfernt. Ein expliziter Aufruf von dispose() tritt normalerweise viel früher auf als die automatische Speicherbereinigung.

Eine ExtensionContext-Instanz kann auf StatusEvent-Ereignisse warten, die der native Code absetzt, wenn ein asynchrones Ereignis in der nativen Implementierung der Erweiterung auftritt. Da die ExtensionContext-Klasse von der EventDispatcher-Klasse abgesetzt wird, kann sie Ereignisse absetzen.

Die ExtensionContext-Klasse stellt auch die statische getExtensionDirectory()-Methode bereit, um auf das Verzeichnis zuzugreifen, in dem die Erweiterung auf dem Gerät installiert wurde. Sie stellt auch die actionScriptData-Eigenschaft bereit, um Daten mit der nativen Implementierung der Erweiterung gemeinsam zu verwenden.

Hinweis: AIR-Anwendungen, die das extendedDesktop-Profil verwenden, können mit der NativeProcess-Klasse native Prozesse ausführen.

call Ruft die native Funktion auf, die durch functionName angegeben wird.Keine Funktion entspricht dem Namen, der mit functionName angegeben wird. ArgumentErrorArgumentErrorDie dispose()-Methode wurde bereits für diese ExtensionContext-Instanz aufgerufen. Dieser Fehler wird auch ausgegeben, wenn die native Funktion einen ungültigen Objektverweis zurückgibt. IllegalOperationErrorflash.errors:IllegalOperationErrorDer Wert, der von der nativen Funktion zurückgegeben wird. Der Rückgabewert ist null, wenn die native Funktion keinen Rückgabewert hat oder einen ungültigen Objektverweis zurückgibt. ObjectfunctionNameStringEin Name, der eine Funktion in der nativen Implementierung repräsentiert. Dieser Name ist nicht notwendigerweise der tatsächliche Name der nativen Funktion, sondern ein beliebiger Name, auf den sich die ActionScript-Seite und die native Seite der Erweiterung verständigt haben. argsEine Liste von Argumenten für die native Funktion. Diese Argumente können beliebige ActionScript-Objekte sein: Grundtypen oder ActionScript-Klassenobjekte. Die ActionScript-Seite und die native Seite der Erweiterung verständigen sich auf die Typen und die Reihenfolge der Argumente. Ruft die native Funktion auf, die durch functionName angegeben wird. Alle zusätzlichen Argumente werden an die native Funktion übergeben. createExtensionContext Erstellt eine ExtensionContext-Instanz für den gegebenen Erweiterungsbezeichner und Kontexttyp.Der extensionID-Parameter ist null oder keine gültige Erweiterungs-ID. ArgumentErrorArgumentErrorDie neue ExtensionContext-Instanz. Gibt null zurück, wenn keine Erweiterung mit dem gegebenen Wert für extensionID verfügbar ist. flash.external:ExtensionContextextensionIDStringDer Erweiterungsbezeichner der Erweiterung. Dieser Bezeichner hat denselben Wert wie das id-Element in der Erweiterungsdeskriptordatei. Anwendungsentwickler verwenden diesen Wert auch im extensionID-Element in der Anwendungsdeskriptordatei. Alle Erweiterungen teilen sich einen allgemeinen Namespace. Um Namenskonflikte zu vermeiden, verwenden Sie die umgekehrte DNS-Schreibung für den Erweiterungsbezeichner. contextTypeStringDer Kontexttyp der Erweiterung. Je nach Kontexttyp kann die native Implementierung verschiedene Initialisierungen ausführen. Zum Beispiel kann die native Implementierung einen anderen Satz verfügbarer nativer Funktionen angeben, die die ActionScript-Seite aufrufen kann. Der Wert des Kontexttyps ist ein beliebiger String, auf den sich die ActionScript-Seite und die native Seite der Erweiterung verständigt haben. Einfache Erweiterungen haben oft keine Verwendung für verschiedene Kontexttypen. Übergeben Sie in diesen Fällen einen leeren String "" oder null als contextType-Wert. Erstellt eine ExtensionContext-Instanz für den gegebenen Erweiterungsbezeichner und Kontexttyp. dispose Verwirft diese ExtensionContext-Instanz. Verwirft diese ExtensionContext-Instanz.

Die Laufzeitumgebung benachrichtigt die native Implementierung, die alle verknüpften nativen Ressourcen freigeben kann. Nach dem Aufruf der dispose()-Methode kann der Code nicht die call()-Methode aufrufen und kann die actionScriptData-Eigenschaft weder abrufen noch festlegen.

getExtensionDirectory Gibt das Verzeichnis zurück, in dem die Erweiterung auf dem Gerät installiert ist.Das Verzeichnis ist nicht vorhanden. Der wahrscheinlichste Grund ist, dass die angegebene extensionID nicht gültig ist. IOErrorflash.errors:IOErrorEine File-Instanz für das Verzeichnis, in dem die Erweiterung installiert wurde. flash.filesystem:FileextensionIDStringDer Erweiterungsbezeichner der Erweiterung. Dieser Bezeichner hat denselben Wert wie der extensionID-Parameter in createExtensionContext(). Gibt das Verzeichnis zurück, in dem die Erweiterung auf dem Gerät installiert ist.

Manchmal schließt eine Erweiterung Ressourcen, zum Beispiel Bilder, ein, auf die Sie aus dem ActionScript-Code der Erweiterung zugreifen möchten. Manchmal sind für den Code auch Informationen erforderlich, die in der Anwendungsdeskriptordatei der Erweiterung verfügbar sind, zum Beispiel die Versionsnummer der Erweiterung. Mit dieser Methode können Sie auf das Basisverzeichnis der Erweiterung zugreifen.

Unabhängig davon, wo sich die Erweiterung auf dem Gerät befindet, sind die Erweiterungsdateien immer an demselben Speicherort in Relation zu diesem Basisverzeichnis der Erweiterung. Mit der File-Instanz, die diese Methode zurückgibt, können Sie zu bestimmten Dateien, die in der Erweiterung enthalten sind, navigieren und darauf zugreifen.

actionScriptData Das ActionScript-Objekt, falls vorhanden, das mit diesem Kontext verknüpft ist.ObjectDie dispose()-Methode wurde bereits für diese ExtensionContext-Instanz aufgerufen. IllegalOperationErrorflash.errors:IllegalOperationError Das ActionScript-Objekt, falls vorhanden, das mit diesem Kontext verknüpft ist.

Sie können ein beliebiges ActionScript-Objekt mit einer ExtensionContext-Instanz verknüpfen. Die native Implementierung kann dieses ActionScript-Objekt ebenfalls abrufen und festlegen. Deshalb können Sie actionScriptData verwenden, um Daten auf der ActionScript-Seite und der nativen Seite einer Erweiterung gemeinsam zu verwenden.

Sie können den Wert von actionScriptData auch auf null setzen.

ExternalInterface Die ExternalInterface-Klasse ist eine API (Application Programming Interface), die die direkte Kommunikation zwischen ActionScript und dem SWF-Container ermöglicht; zum Beispiel eine HTML-Seite mit JavaScript oder eine Desktopanwendung, die Flash Player für die Anzeige einer SWF-Datei verwendet.Verify table is still correct and paragraph below the table still applies. Ermöglicht die Kommunikation zwischen ActionScript und dem Container. Object Die ExternalInterface-Klasse ist eine API (Application Programming Interface), die die direkte Kommunikation zwischen ActionScript und dem SWF-Container ermöglicht; zum Beispiel eine HTML-Seite mit JavaScript oder eine Desktopanwendung, die Flash Player für die Anzeige einer SWF-Datei verwendet.

Mit der ExternalInterface-Klasse können Sie eine ActionScript-Funktion in der Flash-Laufzeitumgebung aufrufen, wenn Sie JavaScript auf der HTML-Seite verwenden. Die ActionScript-Funktion gibt dann einen Wert zurück, den JavaScript unmittelbar als Rückgabewert des Aufrufs entgegennimmt.

Diese Funktionalität ersetzt die Methode fscommand().

Verwenden Sie die ExternalInterface-Klasse in den folgenden Kombinationen aus Browser und Betriebssystem:

BrowserBetriebssystemBetriebssystemInternet Explorer ab Version 5.0Windows Netscape ab Version 8.0Windows MacOS Mozilla ab Version 1.7.5Windows MacOS Firefox ab Version 1.0Windows MacOS Safari ab Version 1.3 MacOS

Flash Player für Linux ab Version 9.0.31.0 unterstützt die ExternalInterface-Klasse in den folgenden Browsern:

BrowserMozilla ab Version 1.7.xFirefox ab Version 1.5.0.7SeaMonkey ab Version 1.0.5

Die ExternalInterface-Klasse erfordert, dass der Webbrowser des Benutzers entweder ActiveX^® oder die NPRuntime-API unterstützt, die von einigen Browsern für das Plug-In-Scripting verwendet wird. Auch wenn eine Kombination aus Browser und Betriebssystem oben nicht aufgeführt ist, sollte sie die ExternalInterface-Klasse unterstützen, sofern die NPRuntime-API unterstützt wird. Weitere Informationen finden Sie unter http://www.mozilla.org/projects/plugins/npruntime.html.

Hinweis: Achten Sie beim Einbetten von SWF-Dateien in HTML-Seiten darauf, dass das id-Attribut gesetzt ist und das id- und name -Attribut des object- und embed-Tags die folgenden Zeichen nicht enthalten:

 . - + ~~ / \

Hinweis für Flash Player-Anwendungen: In Flash Player ab Version 9.0.115.0 ist das Zeichen . (Punkt) innerhalb des id- und name-Attributs zulässig.

Hinweis für Flash Player-Anwendungen: Wenn Flash Player 10 oder höher in einem Browser ausgeführt wird, ist das programmgesteuerte Öffnen von Popupfenstern mithilfe dieser Klasse möglicherweise nicht erfolgreich. Verschiedene Browser (und Browserkonfigurationen) blocken eventuell Popupfenster. Es kann daher nicht sichergestellt werden, dass Popupfenster eingeblendet werden. Den größten Erfolg verspricht diese Klasse beim Öffnen eines Popupfensters in Code, der als direktes Ergebnis einer Benutzeraktion ausgeführt wird, z. B. in einer Ereignisprozedur für ein Mausklick- oder Tastendruckereignis.

Aus ActionScript stehen auf HTML-Seiten folgende Funktionen zur Verfügung:

Aufrufen beliebiger JavaScript-Funktionen
Übergeben einer beliebigen Anzahl von Argumenten mit frei wählbaren Namen
Übergeben unterschiedlicher Datentypen (Boolean, Number, String usw.)
Empfangen eines Rückgabewerts aus der JavaScript-Funktion

Aus JavaScript stehen auf HTML-Seiten folgende Funktionen zur Verfügung:

Aufrufen einer ActionScript-Funktion
Übergeben von Argumenten mithilfe der Funktionsaufruf-Standardnotation
Zurückgeben eines Werts an die JavaScript-Funktion

Hinweis für Flash Player-Anwendungen: Flash Player unterstützt zurzeit keine SWF-Dateien, die in HTML-Formulare eingebettet sind.

Hinweis für AIR-Anwendungen: In Adobe AIR kann die ExternalInterface-Klasse für die Kommunikation zwischen JavaScript in einer HTML-Seite, die in einem HTMLLoader-Steuerelement geladen ist, und ActionScript in SWF-Inhalten, die in dieser HTML-Seite eingebettet sind, verwendet werden.

Im folgenden Beispiel wird die Datenübertragung zwischen Flash Player und einem HTML-Container demonstriert. package { import flash.display.Sprite; import flash.events.*; import flash.external.ExternalInterface; import flash.text.TextField; import flash.utils.Timer; import flash.text.TextFieldType; import flash.text.TextFieldAutoSize; public class ExternalInterfaceExample extends Sprite { private var input:TextField; private var output:TextField; private var sendBtn:Sprite; public function ExternalInterfaceExample() { input = new TextField(); input.type = TextFieldType.INPUT; input.background = true; input.border = true; input.width = 350; input.height = 18; addChild(input); sendBtn = new Sprite(); sendBtn.mouseEnabled = true; sendBtn.x = input.width + 10; sendBtn.graphics.beginFill(0xCCCCCC); sendBtn.graphics.drawRoundRect(0, 0, 80, 18, 10, 10); sendBtn.graphics.endFill(); sendBtn.addEventListener(MouseEvent.CLICK, clickHandler); addChild(sendBtn); output = new TextField(); output.y = 25; output.width = 450; output.height = 325; output.multiline = true; output.wordWrap = true; output.border = true; output.text = "Initializing...\n"; addChild(output); if (ExternalInterface.available) { try { output.appendText("Adding callback...\n"); ExternalInterface.addCallback("sendToActionScript", receivedFromJavaScript); if (checkJavaScriptReady()) { output.appendText("JavaScript is ready.\n"); } else { output.appendText("JavaScript is not ready, creating timer.\n"); var readyTimer:Timer = new Timer(100, 0); readyTimer.addEventListener(TimerEvent.TIMER, timerHandler); readyTimer.start(); } } catch (error:SecurityError) { output.appendText("A SecurityError occurred: " + error.message + "\n"); } catch (error:Error) { output.appendText("An Error occurred: " + error.message + "\n"); } } else { output.appendText("External interface is not available for this container."); } } private function receivedFromJavaScript(value:String):void { output.appendText("JavaScript says: " + value + "\n"); } private function checkJavaScriptReady():Boolean { var isReady:Boolean = ExternalInterface.call("isReady"); return isReady; } private function timerHandler(event:TimerEvent):void { output.appendText("Checking JavaScript status...\n"); var isReady:Boolean = checkJavaScriptReady(); if (isReady) { output.appendText("JavaScript is ready.\n"); Timer(event.target).stop(); } } private function clickHandler(event:MouseEvent):void { if (ExternalInterface.available) { ExternalInterface.call("sendToJavaScript", input.text); } } } } Zum Testen des vorausgegangenen ActionScript-Codes müssen Sie die erzeugte SWF-Datei mithilfe der folgenden HTML-Vorlage einbetten:  <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>ExternalInterfaceExample</title> <script language="JavaScript"> var jsReady = false; function isReady() { return jsReady; } function pageInit() { jsReady = true; document.forms["form1"].output.value += "\n" + "JavaScript is ready.\n"; } function thisMovie(movieName) { if (navigator.appName.indexOf("Microsoft") != -1) { return window[movieName]; } else { return document[movieName]; } } function sendToActionScript(value) { thisMovie("ExternalInterfaceExample").sendToActionScript(value); } function sendToJavaScript(value) { document.forms["form1"].output.value += "ActionScript says: " + value + "\n"; } </script> </head> <body onload="pageInit();"> <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" id="ExternalInterfaceExample" width="500" height="375" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab"> <param name="movie" value="ExternalInterfaceExample.swf" /> <param name="quality" value="high" /> <param name="bgcolor" value="#869ca7" /> <param name="allowScriptAccess" value="sameDomain" /> <embed src="ExternalInterfaceExample.swf" quality="high" bgcolor="#869ca7" width="500" height="375" name="ExternalInterfaceExample" align="middle" play="true" loop="false" quality="high" allowScriptAccess="sameDomain" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer"> </embed> </object> <form name="form1" onsubmit="return false;"> <input type="text" name="input" value="" /> <input type="button" value="Send" onclick="sendToActionScript(this.form.input.value);" /><br /> <textarea cols="60" rows="20" name="output" readonly="true">Initializing...</textarea> </form> </body> </html> addCallback Registriert eine ActionScript-Methode als vom Container aufrufbare Methode.Der Container unterstützt keine eingehenden Aufrufe. Eingehende Aufrufe werden nur in Internet Explorer für Windows und in Browsern unterstützt, die die NPRuntime-API verwenden, z. B. Mozilla ab Version 1.7.5 oder Firefox ab Version 1.0. ErrorErrorEine Callback-Funktion mit dem angegebenen Namen wurde von ActionScript bereits in einer Sandbox eingefügt, auf die Sie keinen Zugriff haben. Diese Callback-Funktion kann nicht überschrieben werden. Um dieses Problem zu umgehen, schreiben Sie den ActionScript um, der ursprüngliche die Methode addCallback() aufgerufen hat, sodass die Methode Security.allowDomain() aufgerufen wird. SecurityErrorSecurityErrorDie Containerumgebung ist Teil einer Sicherheits-Sandbox, auf die der aufrufende Programmcode keinen Zugriff hat. Befolgen Sie die nachstehenden Schritte, um das Problem zu beheben:

Legen Sie auf der HTML-Seite im object-Tag für die SWF-Datei den folgenden Parameter fest:
<param name="allowScriptAccess" value="always" />
Fügen Sie in der SWF-Datei den folgenden ActionScript-Code ein:
flash.system.Security.allowDomain( sourceDomain )

SecurityErrorSecurityErrorfunctionNameStringDer Name, über den der Container die Funktion aufrufen kann. closureFunctionDer aufzurufende Funktionsabschluss. Dies kann eine autonome Funktion oder ein Methodenabschluss sein, der auf eine Methode einer Objektinstanz verweist. Durch das Übergeben eines Methodenabschlusses können Sie die Callback-Funktion sogar an eine Methode einer bestimmten Objektinstanz leiten.

Hinweis: Durch das Wiederholen von addCallback() für eine vorhandene Rückruffunktion mit einem null-Abschlusswert wird der Rückruf entfernt.

Registriert eine ActionScript-Methode als vom Container aufrufbare Methode. Nach einem erfolgreichen Aufruf von addCallBack() kann die registrierte Funktion im Player mit einem JavaScript- oder ActiveX-Code im Container aufgerufen werden.

Hinweis: Bei lokalem Inhalt, der in einem Browser ausgeführt wird, kann die Funktion ExternalInterface.addCallback() nur aufgerufen werden, wenn sich die SWF-Datei und die Webseite, in die sie eingebettet ist, in der lokalen vertrauenswürdigen Sicherheits-Sandbox befinden. Weitere Informationen finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

call Ruft eine vom SWF-Container bereitgestellte Funktion auf und übergibt keine oder beliebig viele Argumente.Should probably provide a link for the 4th paragraph above for info on Netscape. Der Container unterstützt keine ausgehenden Aufrufe. Ausgehende Aufrufe werden nur in Internet Explorer für Windows und in Browsern unterstützt, die die NPRuntime-API verwenden, z. B. Mozilla ab Version 1.7.5 oder Firefox ab Version 1.0. ErrorErrorDie Containerumgebung ist Teil einer Sicherheits-Sandbox, auf die der aufrufende Programmcode keinen Zugriff hat. Befolgen Sie die nachstehenden Schritte, um das Problem zu beheben:

Legen Sie auf der HTML-Seite im object-Tag für die SWF-Datei den folgenden Parameter fest:
<param name="allowScriptAccess" value="always" />
Fügen Sie in der SWF-Datei den folgenden ActionScript-Code ein:
flash.system.Security.allowDomain( sourceDomain )

SecurityErrorSecurityErrorDie vom Container zurückgegebenen Ergebnisdaten. Wenn der Aufruf fehlschlägt, weil beispielsweise die Funktion nicht im Container enthalten ist, die Schnittstelle nicht zur Verfügung steht oder eine Rekursion bzw. ein Sicherheitsproblem (mit einem Netscape- oder Opera-Browser) aufgetreten ist, wird null zurückgegeben und ein Fehler ausgelöst. functionNameStringDer alphanumerische Name der Funktion, die im Container aufgerufen wird. Die Verwendung eines nicht alphanumerischen Dateinamens löst den Laufzeitfehler 2155 aus. Zur Vearbeitung des Fehlers können Sie einen try..catch-Block verwenden. argumentsDie Argumente, die für die Funktion im Container übergeben werden. Sie können beliebig viele durch Komma getrennte Parameter angeben. Diese können einen beliebigen ActionScript-Datentyp aufweisen. Beim Aufrufen einer JavaScript-Funktion werden die ActionScript-Datentypen automatisch in JavaScript-Typen konvertiert. Bei anderen ActiveX-Containern werden die Parameter in der Anforderungsmeldung kodiert. Ruft eine Funktion im Container auf. Ruft eine vom SWF-Container bereitgestellte Funktion auf und übergibt keine oder beliebig viele Argumente. Falls die Funktion nicht zur Verfügung steht, gibt der Aufruf null zurück, ansonsten den Ergebniswert der Funktion. Eine Rekursion ist nicht zulässig in Opera- oder Netscape-Browsern; bei diesen Browsern löst ein rekursiver Aufruf die Antwort null aus. (Rekursion wird für Internet Explorer- und Firefox-Browser unterstützt.)

Wenn es sich bei dem Container um eine HTML-Seite handelt, ruft diese Methode eine JavaScript-Funktion in einem script-Element auf.

Ist der Container dagegen ein anderer ActiveX-Container, löst diese Methode das FlashCall ActiveX-Ereignis mit dem angegebenen Namen aus, das der Container dann verarbeitet.

Wenn der Container das Netscape-Plug-In hostet, können Sie entweder eine benutzerdefinierte Unterstützung für die neue NPRuntime-Schnittstelle programmieren oder ein entsprechendes HTML-Steuerelement einbetten und den Player innerhalb dieses HTML-Steuerelements ausführen. Beim Einbetten einer HTML-Steuerung können Sie mit dem Player über eine JavaScript-Schnittstelle kommunizieren, die den Kontakt zur eigenen Container-Anwendung sicherstellt.

Hinweis: Bei lokalem Inhalt, der in einem Browser ausgeführt wird, kann die Funktion ExternalInterface.call() nur aufgerufen werden, wenn sich die SWF-Datei und die Webseite, in die sie eingebettet ist, (falls vorhanden) in der lokalen vertrauenswürdigen Sicherheits-Sandbox befinden. Sie können eine SWF-Datei daran hindern, diese Methode aufzurufen, indem Sie auf der HTML-Seite, die den SWF-Inhalt enthält, den Parameter allowNetworking der object- und embed-Tags festlegen. Weitere Informationen finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

Hinweis für Flash Player-Anwendungen: In Flash Player 10 und Flash Player 9 mit Update 5 schränken manche Webbrowser diese Methode ein, wenn ein Popupblocker aktiviert ist. In diesem Szenario können Sie diese Methode nur als Reaktion auf ein Benutzerereignis erfolgreich aufrufen, z. B. in einer Ereignisprozedur für ein Mausklick- oder Tastendruckereignis.

Im folgenden Beispiel wird gezeigt, wie Sie mit der ExternalInterface-Klasse (flash.external.ExternalInterface) einen String von Flash Player an den HTML-Container senden können, wo der String mithilfe der JavaScript-Funktion alert() angezeigt wird. Beispiel bereitgestellt von ActionScriptExamples.com. // // Requires: // - A Flash Professional Label component on the Stage with an instance name of "lbl". // - A Flash Professional Button component on the Stage with an instance name of "button". // var xmlResponse:String = "<invoke name=\"isReady\" returntype=\"xml\"><arguments><number>1</number><number>" + stage.stageWidth + "</number><number>" + stage.stageHeight + "</number></arguments></invoke>"; lbl.text = "ExternalInterface.available: " + ExternalInterface.available; lbl.width = 200; button.enabled = ExternalInterface.available; button.addEventListener(MouseEvent.CLICK, button_click); function button_click(evt:MouseEvent):void { ExternalInterface.call("alert", xmlResponse); } marshallExceptions Gibt an, ob die externe Schnittstelle eine Übergabe von ActionScript-Ausnahmen an den aktuellen Browser und von JavaScript-Ausnahmen an den Player versuchen soll.falseBooleanÜbergibt Ausnahmen zwischen AS uns JS. Gibt an, ob die externe Schnittstelle eine Übergabe von ActionScript-Ausnahmen an den aktuellen Browser und von JavaScript-Ausnahmen an den Player versuchen soll. Sie müssen diese Eigenschaft ausdrücklich auf true setzen, um JavaScript-Ausnahmen in ActionScript abzufangen und ActionScript-Ausnahmen in JavaScript abzufangen. Im folgenden Beispiel wird eine ActionScript-Funktion erstellt und mithilfe der addCallback()-Methode beim entsprechenden Browser registriert. Die neue Funktion gibt eine Ausnahme aus, sodass im Browser ausgeführter JavaScript-Code diese abfangen kann. Dieses Beispiel enthält auch eine try..catch-Anweisung, um alle Ausnahmen abzufangen, die vom Browser ausgegeben werden, wenn die Funktion throwit() aufgerufen wird. package { import flash.external.* import flash.net.*; import flash.display.*; import flash.system.System; public class ext_test extends Sprite { function ext_test():void { ExternalInterface.marshallExceptions = true; ExternalInterface.addCallback("g", g); try { ExternalInterface.call("throwit"); } catch(e:Error) { trace(e) } } function g() { throw new Error("exception from actionscript!!!!") } } } available Gibt an, ob dieser Player in einem Container ausgeführt wird, der über eine externe Schnittstelle verfügt.BooleanGibt an, ob der Player in einem Container ausgeführt wird, der über eine externe Schnittstelle verfügt. Gibt an, ob dieser Player in einem Container ausgeführt wird, der über eine externe Schnittstelle verfügt. Wenn die externe Schnittstelle zur Verfügung steht, lautet der Wert dieser Eigenschaft true, ansonsten false.

Hinweis: Überprüfen Sie beim Einsatz der externen API mit HTML stets, dass der HTML-Code vollständig geladen wurde, bevor Sie versuchen, JavaScript-Methoden aufzurufen.

Im folgenden Beispiel wird mithilfe der available-Eigenschaft festgestellt, ob der Player in einem Container ausgeführt wird, der eine externe Schnittstelle anbietet. package { import flash.text.TextField; import flash.display.MovieClip; import flash.external.ExternalInterface; public class extint_test extends MovieClip { public function extint_test() { var isAvailable:Boolean = ExternalInterface.available; var availTxt:TextField = new TextField(); availTxt.text = isAvailable.toString(); addChild(availTxt); } } } objectID Gibt in Internet Explorer das id-Attribut des object-Tags oder in Netscape das name-Attribut des embed-Tags zurück.String Gibt in Internet Explorer das id-Attribut des object-Tags oder in Netscape das name-Attribut des embed-Tags zurück.