Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Sicherheit
Zugriff auf geladene Medien als Daten
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Zum Zugriff auf geladene Daten verwenden Sie die Methoden BitmapData.draw(),
BitmapData.drawWithQuality() und SoundMixer.computeSpectrum(). Standardmäßig ist es nicht möglich,
Pixeldaten oder Audiodaten von Grafik- oder Audioobjekten abzurufen, die von Medien, die in einer anderen
Sandbox geladen sind, dargestellt oder abgespielt werden. Sie können jedoch folgende Methoden verwenden, um den
sandboxübergreifenden Zugriff auf solche Daten zu gewähren:
Rufen Sie in dem Inhalt, in dem die gewünschten Daten dargestellt oder abgespielt werden, die
Security.allowDomain()-Methode auf, um den Datenzugriff auf Inhalt in anderen Domänen zu gewähren.
Bei einem geladenen Bild, Sound oder Video fügen Sie dem Server der geladenen Datei eine URL-Richtliniendatei
hinzu. Diese Richtliniendatei muss Zugriff auf die Domäne der SWF-Datei gewähren, die versucht, die Methoden
BitmapData.draw(), BitmapData.drawWithQuality() oder SoundMixer.computeSpectrum() aufzurufen,
um Daten aus der Datei zu extrahieren. Die drawWithQuality-Methode ist in Flash Player 11.3 und höher sowie
AIR 3.3 und höher verfügbar.
In den folgenden Abschnitten finden Sie ausführliche Informationen über den Zugriff auf Bitmap-, Sound- und
Videodaten.
Zugriff auf Bitmap-Daten
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Mit der Methode draw() oder drawWithQuality() (Flash Player 11.3; AIR 3.3) eines BitmapData-Objekts können
Sie die aktuell angezeigten Pixel eines beliebigen Anzeigeobjekts in ein BitmapData-Objekt zeichnen. Dabei kann es
sich um die Pixel eines MovieClip-Objekts, eines Bitmap-Objekts oder eines Anzeigeobjekts handeln. Die folgenden
Bedingungen müssen zutreffen, damit diese Methoden Pixel in das BitmapData-Objekt schreiben:
Handelt es sich bei dem Quellobjekt nicht um eine geladene Bitmap, müssen das Quellobjekt und (bei einem Sprite-
oder MovieClip-Objekt) alle untergeordneten Objekte aus der gleichen Domäne wie das Objekt stammen, das die
draw-Methode aufruft, oder sie müssen sich in einer SWF-Datei befinden, die dem aufrufenden Objekt durch
Aufrufen der Methode Security.allowDomain() zugänglich ist.
Handelt es sich bei dem Quellobjekt um eine geladene Bitmap, muss das Quellobjekt aus der gleichen Domäne wie
das Objekt stammen, das die draw-Methode aufruft, oder der Quellserver muss eine URL-Richtliniendatei
enthalten, die der aufrufenden Domäne Zugriffsrechte erteilt.
Wenn diese Bedingungen nicht erfüllt werden, wird eine SecurityError-Ausnahme ausgelöst.
Wenn Sie das Bild mit der load()-Methode der Loader-Klasse laden, können Sie einen context-Parameter angeben,
bei dem es sich um ein LoaderContext-Objekt handelt. Wenn Sie die checkPolicyFile-Eigenschaft des
LoaderContext-Objekts auf true festlegen, wird in Flash Player auf dem Server, von dem das Bild geladen wird, eine
URL-Richtliniendatei gesucht. Wenn eine Richtliniendatei vorhanden und die Domäne der ladenden SWF-Datei
darin enthalten ist, kann die Datei auf die Daten im Bitmap-Objekt zugreifen. Andernfalls wird der Zugriff verweigert.
Sie können auch eine checkPolicyFile-Eigenschaft in einem Bild angeben, das über ein -Tag in einem
Textfeld geladen wird. Weitere Informationen finden Sie unter „Laden von SWF-Dateien und Bildern mit dem
-Tag in einem Textfeld“ auf Seite 1123.
Letzte Aktualisierung 27.6.2012
1128