agedoubleju

Flash bietet uns die Möglichkeit, von außerhalb des Filmes sowohl andere Filme und Bilder wie auch zusätzliche Daten nachzuladen. Die etwas veralteten Funktionen loadVariables und loadVariablesNum sollten dazu aber nicht mehr verwendet werden, da sie asynchron zu anderen Scriptbefehlen laufen und keine eigenen Rückmeldungen dazu liefern, wie der Response eigentlich aussieht.

Schauen wir uns deshalb das aktuelle Übertragungsmedium, die LoadVars-Klasse an:

Die LoadVars-Klasse bietet Flash die Möglichkeit, dynamische Daten in Form von Variablen sowohl an eine externe Quelle zu senden, als auch von einer externen Quelle zu empfangen.

Diese externen Quellen können zum Beispiel Textfiles sein oder serverbasierte Middleware-Scripte wie PHP- oder ASP-Files. Über diese Middleware wiederum können auch Datenbankenabfragen z.B. von mySQL-Datenbanken eingebunden werden.

Die wichtigsten drei Methoden der LoadVars-Klasse sind:
LoadVars.onLoad()
LoadVars.load()
LoadVars.send()
und die Kombination aus den letzten beiden:
LoadVars.sendAndLoad().

Auf die weiteren Methoden wird hier nicht näher eingegangen.

LoadVars.load() lädt externe Variablen aus einem lokalen oder externen Textfile oder einem Server-basierten Middleware-Script, z.B. von einem PHP-File.

Aus dem Text holt sich diese Methode URL-enkodierte Variablen, bzw. vom Script empfängt sie Variablen und wandelt sie in Eigenschaften des LoadVars-Objektes um.

Übergabeparameter für LoadVars.load ist eine URL, d.h. ein String, der den Pfad zu der Quelle - also dem Serverbasierten Script oder dem Textfile - angibt.

Die load-Methode kann allerdings nur den Download einer URL-enkodierten Variable initiieren, Rückgabewerte kann nur die onLoad-Methode erhalten. Der Rückgabewert der onLoad-Methode ist ein Boolean-Wert, also ein true oder false. Mit diesen Werten kann dann überprüft werden, ob der HTTP-Response, also die Antwort des Servers, nicht leer war.

Das bedeutet dann allerdings nicht, dass der übergebene Wert formatiert oder nützlich war, sondern eben nur, dass ein Wert übergeben wurde.

LoadVars.send() funktioniert ähnlich wie der getURL-Befehl. Als Parameter können ein URL-encodierter String, ein Ziel-String und ein HTTP-Methodenstring übergeben werden.

Der Zielstring spezifiziert einen Fensternamen oder Framenamen des Browsers, zu dem Resultate gesendet werden sollen. Es kann aber auch einer der vordefinierten Typen "_blank" für eine leere Browserseite, "_parent" für das derzeitige Frameset, welches den Film enthält, "_top" für das Ersetzen aller Framesets oder "_self" für das derzeitige Fenster gesetzt werden.

Die send-Methode hat gegenüber dem getURL allerdings den Vorteil, dass spezifizierte Variablen als Eigenschaft an ein externes Script übergeben werden können, wobei getURL an einen MC gebunden ist, der die Variablen enthält.

LoadVars.sendAndLoad() konvertiert alle Eigenschaften des loadVars-Objektes in einen URL-enkodierten String und sendet ihn in einem HTTP-Request an eine in der Parameterliste angegebene URL. Genau wie bei der load-Methode erwartet das Objekt dann einen Rückgabewert.

Vorteil gegenüber der send-Methode ist, dass spezielle Variablen als Eigenschaften des Objektes übergeben werden können. Dies ist auch ein großer Vorteil gegenüber Befehlen wie loadVariables und loadVariablesNum, bei denen alle Variablen der aktuellen Zeitleiste übergeben werden. Weiterhin kann anders als bei der send-Methode als HTTP-Methode auch POST genutzt werden.

Schauen wir uns jetzt einmal an, wie die LoadVars-Klasse in der Praxis genutzt wird:

Wir wollen bspw. aus einem Textfile ein Wertepaar laden, der Eintrag im Textfile lautet dann etwa:
, das Textfile hat den Dateinamen "meinFile.txt", das File bitte als Unicode-Format UTF-8 abspeichern. In PHP könnte eine entsprechende Ausgabe so aussehen:
Im Actionscript-Editor legen wir zuerst eine Instanz des LoadVars-Objektes mit new an, da wir nichtstatische Klasse selbst nicht direkt verwenden können:
Danach erstellen wir uns eine Callback-Funktion, die den Response des LoadVars-Objektes aufnimmt:

Als letztes wird das Objekt als HTTP-Request an das Textfile gesendet:

Die Callback-Funktion "geladen" wird danach mit Leben gefüllt, da wir nicht nur einen boolschen Rückgabewert erwarten, sondern auch die HTTP-Antwort mit der gesendeten Variable:
Das komplette Script könnte dann so aussehen:
Wenn alles richtig eingegeben war, bekommt man dann im Testmodus (STRG-ENTER) im Ausgabefenster "empfangene Variable: meinWert";

Da der Response immer ein String ist, sollte eine Numbervariable vor der weiteren Verwendung im Script bspw. mit Number(meineVariable) umgewandelt werden.

Wichtig ist vor allem, dass der weitere Scriptverlauf über die Callback-Funktion "geladen" gesteuert werden sollte, da diese Funktion ja sozusagen im "Hintergrund" solange wartet, bis ein Response erfolgt. Erst in diesem Callback kann auf die Variablen zugegriffen werden, die bspw. dann in einem Textfeld ausgegeben werden sollen. Auch hierzu ein Beispiel:
Wenn mal mehrere Variablen nachgeladen werden sollen, so kann man sich bspw. kommaseparierte Listen im Textfile (oder via PHP) erstellen, in Flash einlesen und ein Array splitten. Dazu wieder ein Beispiel für ein Textfile:
Der onLoad-Callback könnte dann etwa so aussehen (die LoadVars-Initialisierungen ändern sich nicht):
Danach liegen die gesendeten Variablen in _level0.meineVariablen[0],_level0.meineVariablen[1] und _level0.meineVariablen[2].