6.4 Aktionen für die Kommunikation 

Flash bietet zahlreiche Schnittstellen zur Außenwelt. Einige der wichtigsten stellen wir in diesem Kapitel vor. Dazu zählen:

Steuerung des Stand-alone-Players und -Projektors

Aufruf von beliebigen URLs

Laden von SWF-Dateien und von JPEG-Bildern

Laden von Daten wie z.B. den Texten einer Website

Abspielumgebung

Sollten Sie die Abspielumgebung einer Flash-Anwendung beeinflussen wollen, dann benötigen Sie die Aktion fscommand. Diese Aktion sendet Nachrichten an das umgebende Programm, egal ob es sich um einen Webbrowser, Stand-alone-Player, Stand-alone-Projektor, ActiveX-Host (z.B. C++-Programm) oder den Macromedia Director handelt. Wie Sie mit fscommand in einem Webbrowser JavaScripts (Netscape) oder VBScripts (Microsoft) aufrufen, erfahren Sie im Kapitel 24, JavaScript.

Die genaue Arbeitsweise dieser Aktionen legen Sie mit einem Befehl und – falls nötig – einem weiteren Parameter fest. Der Parameter liefert zusätzliche Werte an die Umgebung. Die von Stand-alone-Projektor und -Player unterstützten Befehle finden Sie in der folgenden Tabelle.

Keine Wirkung im Webbrowser

Die Befehle der Aktion fscommand haben seit Flash MX keine Wirkung innerhalb des Webbrowsers. In der Entwicklungsumgebung verhalten sich manche Einstellungen ebenfalls anders als im Stand-alone-Projektor oder -Player.

Hyperlinks

Ein wesentliches Konzept von Websites sind Hyperlinks. Bei Hyperlinks handelt es sich um Verweise zwischen Dokumenten. Flash ist in der Lage, solche Hyperlinks zu verwenden und zu anderen Dokumenten wie z.B. HTML-Seiten zu verweisen. Der dafür notwendige Befehl heißt getURL. Sollten Sie nur Daten austauschen oder möchten eine SWF-Datei laden, dann werfen Sie doch einen Blick auf die Aktionen bzw. die gleichnamigen Movieclip-Methoden loadMovie und loadVariables!

Ist eine Flash-Anwendung beispielsweise sehr groß oder arbeiten mehrere Entwickler gleichzeitig an ihr, dann macht es Sinn, das Projekt in unabhängige Module zu unterteilen, die durch loadMovie oder loadMovieNum verknüpft werden. Wenn Sie z.B. einen Katalog entwickeln, dann ist es häufig von Vorteil, für jedes Produkt eine eigene SWF-Datei zu erstellen, anstatt eine große Gesamtdatei zu liefern. Diese große Datei lässt sich nicht nur schlechter warten, sondern es dauert beim Anwender länger, bis sie geladen ist.

Möchten Sie die Inhalte (wie z.B. Textinformationen) der Flash-Anwendung nicht fest mit dem Film »verdrahten«, dann bieten sich die Aktionen loadVariables und loadVariablesNum an. Diese Aktionen ermöglichen es, dass eine Flash-Anwendung zur Laufzeit Werte einliest. So können Inhalte dynamisch gehalten werden, ohne dass Sie oder Ihr Kunde die SWF-Datei verändern.

6.4.1 fscommand allowScale 

Falls Sie ein Flash-Anwendung beim Abspielen so groß wie möglich skalieren möchten, dann wählen Sie für das fscommand den Befehl allowScale mit dem Parameter true. Um ein Flash-Anwendung in Originalgröße, also bei 100% darzustellen, wählen Sie den Befehl allowScale mit dem Parameter false.

Bemerkung:

Syntax:

fscommand("allowScale", aktiviert);

Parameter:

Beispiel:

// Skaliere die Anwendung so groß wie möglich
fscommand("allowScale", "true");
// Stelle die Anwendung in Originalgröße dar
fscommand("allowScale", "false");

// Skaliere die Anwendung so groß wie möglich
Stage.scaleMode="showAll";
// Stelle die Anwendung in Originalgröße dar
Stage.scaleMode="noScale";

Skalieren im Webbrowser

Um das Skalieren im Webbrowser zu beeinflussen, stehen innerhalb der Einstellungen für Veröffentlichungen im Register HTML weitere Parameter bereit.

6.4.2 fscommand exec 

02_Programmierung\ fscommand\ exec.fla

Um eine Anwendung aufzurufen, wählen Sie für die Aktion fscommand den Befehl exec. Als weiteren Parameter geben Sie in den Namen der Anwendung an.

Bemerkung:

Syntax:

fscommand("exec", anwendung);

Parameter:

Beispiel:

// Starte Anwendung
fscommand("exec", "notepad.exe");

Einschränkungen des fscommand exec

Das Starten einer externen Anwendung aus einem Stand-alone-Projektor heraus unterliegt zahlreichen Einschränkungen. Macromedia hat diese zum Teil erst in Flash MX eingebaut, um den Missbrauch zu verhindern (http://www.macromedia.com/support/flash/ts/documents/Stand-alone_update.htm). Flash-Anwendungen, die Sie über das Internet betrachten, können grundsätzlich keine Anwendungen auf Ihrem Rechner aufrufen! Bei Flash-Anwendungen in einem Stand-alone-Projektor oder -Player muss die Anwendung sich seit Flash MX unterhalb desselben Verzeichnisses im Ordner fscommand befinden. Den Ordnernamen geben Sie nicht mit an. Der Name der Anwendung darf nur Buchstaben, Zahlen, Klammern, den Unterstrich und den Punkt enthalten.

6.4.3 fscommand fullScreen 

02_Programmierung\ fscommand\ 3DInteraktion.fla

Falls eine Flash-Anwendung als Bildschirmschoner oder als eigenständige Anwendung außerhalb des Webbrowsers abspielt, wird häufig ein Vollbildmodus erwartet. Diesen erreichen Sie über die Aktion fscommand("fullScreen", "true");. Zurück in den Fenstermodus gelangen Sie über fscommand("full Screen", "false");. Der Befehl fullscreen funktioniert im Stand-alone-Projektor und Stand-alone-Player, aber nicht im Webbrowser oder in der Entwicklungsumgebung.

Bemerkung:

Syntax:

fscommand("fullScreen", aktiviert);

Parameter:

Beispiel:

// Stelle die Anwendung im Vollbild dar
fscommand("fullScreen", "true");
// Stelle die Anwendung in einem Fenster dar
fscommand("fullScreen", "false");

6.4.4 fscommand quit 

Um einen Stand-alone-Projektor oder -Player zu beenden, wählen Sie den Befehl quit für die Aktion fscommand.

Bemerkung:

Syntax:

fscommand("quit");

Parameter:

Beispiel:

// Beende die Anwendung
fscommand("quit");

Beenden im Webbrowser

Um eine Flash-Anwendung im Webbrowser zu beenden, gibt es die JavaScript-Anweisung window.close();, die Sie gemeinsam mit der getURL-Aktion anwenden können:

getURL("javascript:window.close();");

Diese Anweisung zeigt eine Meldung und schließt dann das zugehörige Browser-Fenster.

6.4.5 fscommand showMenu 

Um das Kontextmenü des Stand-alone-Projektors oder Players zu reduzieren, verwenden Sie die Aktion fscommand mit dem Befehl showMenu.

Bemerkung:

Syntax:

fscommand("showMenu", aktiviert);

Parameter:

Beispiel:

// Reduziere das Kontextmenü
Stage.showMenu=false;

Kontextmenü im Webbrowser

Um das Kontextmenü im Webbrowser zu beeinflussen, steht innerhalb der Einstellungen für Veröffentlichungen im Register HTML der Parameter Menü anzeigen bereit.

6.4.6 fscommand trapAllKeys 

Einige Tastenkombinationen werden vom Stand-alone-Projektor und -Player abgefangen. Dazu zählen (Strg)/(ď)+(F) für den Vollbildmodus und (Strg)/(ď)+(Q) zum Beenden. Die Aktion fscommand gemeinsam mit dem Befehl trapAllKeys und dem Parameter true verhindert dies und leitet die Tastatureingaben direkt an die Flash-Anwendung weiter. Bis auf wenige Tastenkombinationen wie z.B. (Alt)+ (F4) bzw. (†)+(Q) zum Beenden lässt sich ein Stand-alone-Projektor oder -Player so nicht mehr ungewollt beeinflussen.

Bemerkung:

Syntax:

fscommand("trapAllKeys", aktiviert);

Parameter:

Beispiel:

// Deaktiviere Tastenbefehle des Flash-Players
fscommand("trapAllKeys", "true");

Tastenkürzel-Problem

Die Aktionen fscommand trapAllKeys kann dazu führen, dass Tastaturbefehle zum Kopieren und Einfügen ((Strg)/(ď)+(C) und (Strg)/(ď)+(V)) nicht mehr funktionieren.

6.4.7 getURL 

02_Programmierung\ fscommand\ geturl

getURL ruft die angegebene URL auf. In der Regel wechseln Sie mit dieser Aktion zu einem anderen HTML-Dokument. Aber auch andere URLs sind erlaubt. Dazu zählt jedes Protokoll, das der installierte Webbrowser versteht. Erlaubt sind neben http beispielsweise mailto, und javascript.

Bemerkung:

Syntax:

getURL(url);
getURL(url, fenster);
getURL(url, fenster, versenden);

Parameter:

Falls Sie selber HTML-Dokumente entwickeln, können Sie als Fenster auch den Namen eines HTML-Frames angeben. Falls Sie nichts angeben, wird wie bei _self das aktuelle Fenster (bzw. der aktuelle Frame) als Ziel verwendet.

Um an die angegebene Adresse Werte zu übermitteln, geben Sie als dritten Parameter eine passende Methode an. Sie bestimmen, ob die aktuellen Variablen nicht, mit der GET- oder mit der POST-Methode versendet werden sollen. Bei der GET-Methode können Sie die Werte – je nach Webbrowser – in der URL-Zeile ablesen. Bei der POST-Methode werden die Werte nicht zusammen mit der URL, sondern separat übertragen, wodurch deutlich größere Informationsmengen möglich sind. Die POST-Methode ist zwar in den meisten Fällen die bessere Wahl, hat aber auch Nachteile: Manch eine Firewall und der Internet Explorer 4.5 unter Mac OS kommen nicht damit zurecht.

Falls Sie Werte ermitteln und innerhalb Flash weiter verarbeiten möchten, dann sollten Sie eine andere Methode wie z.B. die Aktion loadVariables verwenden, um Daten an einen Server zu schicken.

Beispiel:

getURL("meineseite.html");
getURL("meineseite.html", "_blank");
getURL("meineseite.html", "_blank", "POST");

getURL versendet auch E-Mails. Die meisten Browser unterstützen das Erzeugen einer E-Mail über die URL. Dass es sich bei der angegebenen Adresse um eine E-Mail handelt, erkennt der Browser an dem vorangestellten mailto. Diesem folgt die Adresse.

meinButton.onRelease = function () {
   // E-Mail versenden
   getURL("mailto:buch@flashforum.de");
};

Optional kann auch der Name des Empfängers angegeben werden. Dann muss die Adresse aber in Klammern (<>) stehen. Je nach Browser lassen sich mit & noch weitere Angaben wie subject, cc, body usw. verknüpfen. Die zusätzlichen Angaben werden durch ein ? von der Adresse getrennt.

meinButton.onRelease = function () {
   // E-Mail versenden
   getURL("mailto:Sascha Wolter<buch@flashforum.de>?subject=
    Flash MX Buch&body=E-Mail mit getURL");
};

Protokolle

Neben den vom Browser unterstützten Protokollen wie http, https, ftp, mailto, javascript usw. versteht die Aktion getURL auch Flash-eigene Befehle wie print (siehe Aktionen zum Drucken auf Seite 136) und fscommand. Anstelle von fscommand("allowScale", "true"); können Sie beispielsweise auch getURL("fscommand:allowScale", "true"); schreiben.

6.4.8 loadMovie 

Die Aktionen loadMovie lädt andere SWF-Dateien bzw. JPEG-Bilder in einen Movieclip. Das Laden einer SWF-Datei bewirkt, dass der Flash Player mehrere Anwendungen bzw. Bilder gleichzeitig anzeigt oder zwischen verschiedenen Flash-Anwendungen hin und her wechselt, ohne extra ein neues HTML-Dokument zu benötigen. Um eine geladene Anwendung wieder zu entfernen, wählen Sie die Aktion unloadMovie.

Bemerkung:

Syntax:

loadMovie(url, ziel);
loadMovie(url, ziel, versenden);

Parameter:

Beispiel:

// Lade SWF-Datei
loadMovie("meinFilm.swf", "meinMovieClip");
loadMovie("meinFilm.swf", "meinMovieClip", "POST");
// Alternative Methode seit Flash 5
meinMovieClip.loadMovie("meinFilm.swf");
meinMovieClip.loadMovie("meinFilm.swf", "POST");

loadMovie("meinbild.jpg", "meinMovieClip");
meinMovieClip.loadMovie("meinbild.jpg");

Ausrichten, positionieren und skalieren

Falls Sie mehrere Anwendungen abspielen möchten, ist es am einfachsten, für alle Dateien die gleichen Dokumenteigenschaften (Bildrate und Format) zu verwenden. Auf diese Weise können Sie das Design und die Abspielgeschwindigkeit besser planen. Flash richtet unterschiedlich große Dateien immer an der linken oberen Ecke der Datei in Stufe null (Hauptfilm bzw. _level0) aus. Um die Position, Größe und Drehung einfacher zu bestimmen, geben Sie einen Movieclip anstelle einer Stufe als Ziel an.

6.4.9 loadMovieNum 

Die Aktion loadMovieNum lädt andere SWF-Dateien bzw. JPEG-Bilder in eine Stufe (engl. Level). Das Laden einer SWF-Datei bewirkt, dass der Flash Player mehrere Anwendungen gleichzeitig anzeigt oder zwischen verschiedenen Flash-Dateien hin und her wechselt, ohne extra ein neues HTML-Dokument zu benötigen. Um eine geladene Datei wieder zu entfernen, wählen Sie die Aktion unloadMovieNum.

Bemerkung:

Syntax:

loadMovieNum(url, stufe);
loadMovieNum(url, stufe, versenden);

Parameter:

Beispiel:

// Lade SWF-Datei
loadMovieNum("meinFilm.swf", 1);
loadMovieNum("meinFilm.swf", 1, "POST");
// Alternative Methode seit Flash 5 (nur bei bereits existierender Stufe)
_level1.loadMovie("meinFilm.swf");
_level1.loadMovie("meinFilm.swf", "POST");

loadMovieNum("meinbild.jpg", 1);
_level1.loadMovie("meinbild.jpg");

Der Hauptfilm oder _level0

Eine Ausnahme bildet die Stufe null: In die Stufe null wird immer die erste Flash-Datei geladen, die dann die Bildrate, Hintergrundfarbe und die Abmessungen bestimmt. Wenn Sie eine SWF-Datei in die nullte Stufe laden, setzt Flash alle Werte zurück und löscht auch den Inhalt anderer Stufen.

6.4.10 loadVariables 

02_Programmierung\fscommand\loadVariables

Die Aktion loadVariables lädt Daten in die Flash-Anwendung oder einen Movieclip ein und erzeugt passende Variablen zur weiteren Verarbeitung.

Bemerkung:

Syntax:

loadVariables(url, ziel);
loadVariables(url, ziel, versenden);

Parameter:

Beispiel:

loadVariables("meinText.txt", "meinMovieClip");
loadVariables("meinText.txt ", "meinMovieClip", "POST");
// Alternative seit Flash 5
meinMovieClip.loadVariables("meinText.txt");
meinMovieClip.loadVariables("meinText.txt ", "POST");

application/x-www-urlformencoded

Die Daten, die von Flash-Anwendungen geladen werden, müssen im Format application/x-www-urlformencoded vorliegen. D.h. die Inhalte müssen als Variablen in der Form variable1=wert1&variable2=wert2 übergeben werden. Dabei sollten Sie unbedingt darauf achten, dass keine Leerzeichen, Zeilenumbrüche oder HTML-Tags integriert werden. Diese Sonderzeichen müssen durch die Prozentschreibweise dargestellt werden: Für einen Zeilenumbruch verwenden Sie z.B. %0D. Als URL können Sie in Flash jederzeit auch ein Server-Skript angeben. Es ist dabei für Flash unerheblich, welche Sprache auf der Serverseite eingesetzt wird. Es zählt nur, was als Ergebnis vom Server zurück zur Flash-Anwendung gesendet wird. Diese Daten müssen das richtige Format haben. Für den Test hat es sich als nützlich erwiesen, die serverseitigen Skripte erst einmal über ein normales HTML-Formular zu testen. Das gelieferte Ergebnis können Sie sich dann im Browser anschauen und dort den Quelltext auf eventuell unerwünschte Zeichen überprüfen.

Das folgende Beispiel lädt eine Textdatei ein und stellt den Inhalt in Flash dar. Die hier gewählte Schreibweise ist übrigens auch noch mit älteren Flash-Versionen wie z.B. Flash 4 kompatibel.

Text laden

Um einen Text in Ihrer Anwendung darzustellen, benötigen Sie einen Textblock, der dynamisch ist. Diese Einstellung für den Texttyp nehmen Sie für einen markierten Textblock im Eigenschafteninspektor vor.

Damit Sie in dem Textblock den geladenen Text darstellen können, benötigt dieser eine Variable wie z.B. content. Die Variable legen Sie für einen markierten Textblock ebenfalls im Eigenschafteninspektor im Feld var fest.

Verwenden Sie eine Schaltfläche, und weisen Sie dieser im ersten Schlüsselbild der Hauptzeitleiste das folgende Skript zu, damit der Text geladen und angezeigt wird.

btn_loadText.onRelease = function () {
   loadVariables("text.txt", "");
}

Bitte beachten Sie, dass für die Aktion als Ort »Ziel« ohne weitere Angaben verwendet wird. Dies führt dazu, dass die Daten an die Stelle geladen werden, an der sowohl die Schaltfläche als auch der Textblock platziert sind. Alternativ hätten Sie auch loadVariablesNum("text.txt", 0) schreiben können.

Erstellen Sie eine Textdatei mit der Bezeichnung, die Sie für das Laden als URL angegeben haben. Beginnen Sie die Textdatei mit dem Namen der Variablen für den Textblock und einem Gleichzeichen. Alle folgenden Zeichen werden dann dieser Variablen zugewiesen und nach dem Einlesen in Flash im Textblock angezeigt:

content=Hier könnten Ihre Daten stehen!

Leider sind einige Sonderzeichen nicht erlaubt. Für einen Zeilenumbruch benötigen Sie beispielsweise die Zeichenkette %0D. Um auf Nummer sicher zu gehen, bietet sich somit die folgende Schreibweise für den Inhalt an (bei Unicode kann auf die URL-Encodierung meist verzichtet werden):

content=Hier%20k%C3  %B6nnten%20Ihre%20Daten%20stehen%21

6.4.11 loadVariablesNum 

Die Aktion loadVariablesNum lädt Daten in eine Flash-Anwendung in einer Stufe (engl. Level) und erzeugt passende Variablen zur weiteren Verarbeitung.

Bemerkung:

Syntax:

loadVariablesNum(url, stufe);
loadVariablesNum(url, stufe, versenden);

Parameter:

Beispiel:

loadVariablesNum("meinText.txt", 0);
loadVariablesNum("meinText.txt ", 0, "POST");
// Alternative seit Flash 5
_level0.loadVariables("meinText.txt");
_level0.loadVariables("meinText.txt ", "POST");

6.4.12 unloadMovie 

Die Aktion unloadMovie verwenden Sie, um mit loadMovie geladene Flash Player-Dateien wieder zu entfernen.

Bemerkung:

Syntax:

unloadMovie(ziel);

Parameter:

Beispiel:

unloadMovie("meinMovieClip");
// Alternative seit Flash 5
meinMovieClip.unloadMovie();

6.4.13 unloadMovieNum 

Die Aktion unloadMovieNum verwenden Sie, um mit loadMovieNum geladene Flash Player-Dateien wieder zu entfernen.

Bemerkung:

Syntax:

unloadMovieNum(stufe);

Parameter:

Beispiel:

unloadMovieNum(1);
// Alternative seit Flash 5
_level1.unloadMovie();