Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Programmieren von Anzeigeobjekten
Festlegen des Ladekontexts
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Wenn Sie eine externe Datei über die load()- oder loadBytes()-Methode der Loader-Klasse in Flash Player oder
AIR laden, können Sie optional einen context-Parameter angeben. Bei diesem Parameter handelt es sich um ein
LoaderContext-Objekt.
Die LoaderContext-Klasse umfasst drei Eigenschaften, mit denen Sie den Kontext definieren können, wie der geladene
Inhalt verwendet werden kann:
checkPolicyFile: Verwenden Sie diese Eigenschaft nur beim Laden einer Bilddatei (nicht beim Laden einer
SWF-Datei). Wenn Sie diese Eigenschaft auf true festlegen, sucht der Loader auf dem Ursprungsserver nach einer
Richtliniendatei (siehe „Kontrolloptionen für Websites (Richtliniendateien)“ auf Seite 1111). Dies ist nur dann
notwendig, wenn Inhalte aus anderen Domänen stammen als die SWF-Datei, in der das Loader-Objekt enthalten
ist. Wenn der Server Zugriff auf die Loader-Domäne gewährt, kann ActionScript aus SWF-Dateien in der Loader-
Domäne auf Daten im geladenen Bild zugreifen. Anders ausgedrückt, Sie können mit dem Befehl
BitmapData.draw() auf Daten im geladenen Bild zugreifen.
Beachten Sie, dass eine SWF-Datei aus einer anderen Domäne als das Loader-Objekt Security.allowDomain()
aufrufen kann, um eine bestimmte Domäne zuzulassen.
securityDomain: Verwenden Sie diese Eigenschaft nur beim Laden einer SWF-Datei (nicht beim Laden eines
Bilds). Dies ist nur dann notwendig, wenn eine SWF-Datei aus einer anderen Domäne stammt als die Datei, die
das Loader-Objekt enthält. Wenn Sie diese Option angeben, sucht Flash Player nach einer Richtliniendatei. Ist eine
vorhanden, können SWF-Dateien aus Domänen, die in der domänenübergreifenden Richtliniendatei enthalten
sind, auf den geladenen SWF-Inhalt verweisen (Cross-Scripting). Sie können
flash.system.SecurityDomain.currentDomain als Parameter angeben.
applicationDomain: Verwenden Sie diese Eigenschaft nur beim Laden einer SWF-Datei, die in ActionScript 3.0
geschrieben wurde (nicht beim Laden eines Bilds oder einer SWF-Datei, die in ActionScript 1.0 oder 2.0
geschrieben wurde). Beim Laden der Datei können Sie festlegen, ob die Datei in die gleiche Anwendungsdomäne
wie die des Loader-Objekts aufgenommen werden soll, indem Sie den Parameter applicationDomain auf
flash.system.ApplicationDomain.currentDomain einstellen. Durch Einfügen der geladenen SWF-Datei in
die gleiche Anwendungsdomäne können Sie direkt auf die zugehörigen Klassen zugreifen. Dies ist insbesondere
beim Laden einer SWF-Datei von Nutzen, die eingebettete Medien enthält, auf die Sie über denen zugewiesenen
Klassennamen zugreifen können. Weitere Informationen finden Sie unter „Verwenden von
Anwendungsdomänen“ auf Seite 157.
Im Folgenden ist ein Beispiel für die Suche nach einer Richtliniendatei aufgeführt, wenn eine Bitmap aus einer anderen
Domäne geladen wird:
var context:LoaderContext = new LoaderContext();
context.checkPolicyFile = true;
var urlReq:URLRequest = new URLRequest("http://www.[your_domain_here].com/photo11.jpg");
var ldr:Loader = new Loader();
ldr.load(urlReq, context);
Im Folgenden ist ein Beispiel für die Suche nach einer Richtliniendatei aufgeführt, wenn eine SWF-Datei aus einer
anderen Domäne geladen wird, um diese Datei in der gleichen Sicherheits-Sandbox wie das Loader-Objekt zu
platzieren. Darüber hinaus fügt der Code die Klassen in der geladenen SWF-Datei der gleichen Anwendungsdomäne
wie das Loader-Objekt hinzu:
Letzte Aktualisierung 27.6.2012
214