ActionScript 3: Timer Klasse

In ActionScript 3 gibt es eine neue Timer-Klasse (flash.utils.Timer), die für zeitbasierte Anwendungszwecke gedacht ist. Ein Timer löst nach einem definierten Zeitintervall ein Event aus. Zusätzlich kann bestimmt werden, ob der Timer „unendlich“ lange läuft oder nach einer bestimmten Anzahl an ausgelösten Events aufhört (z.B. nach 10x in einem Intervall von 500ms).

Ein Timer in ActionScript 3 kann somit die aus ActionScript 2 bekannten Funktion setInterval, setTimeout() oder auch das onEnterFrame-Event ersetzen. (Die Funktionen setInterval/setTimeout sind zwar noch in ActionScript 3 vorhanden, erzeugen jedoch Compiler-Warnungen.)

Für Video-Anwendungen mit AS3 ist die Timer-Klasse – in Verbindung mit NetConnection/NetStream – in folgenden Anwendungsbereichen wichtig:

• Zeitanzeige eines Videos aktualisieren
• Aktualisieren eines Fortschrittsbalken (wie weit ist das Video geladen)
• Seek- bzw. Scrubbar zur Steuerung des Videos aktualisieren
• …

Für ausführliche Beispiele mit ActionScript 2 verweise ich auf „Interaktives Video im Internet mit Flash“ (Kapitel 14: ActionScript-Klassen für die Video-Wiedergabe).

How-to: Timer verwenden

Im folgenden Anschauungsbeispiel wird der Timer dazu genutzt, die aktuelle Zeit eines Videos (NetStream.time) in einem Textfeld anzuzeigen. Beispiel anschauen

Zuerst müssen zwei Klassen importiert werden: flash.utils.Timer und
flash.events.TimerEvent.

[as]
import flash.utils.Timer;
import flash.events.TimerEvent;
[/as]

Daraufhin wird ein neues Objekt mit dem Instanznamen myTimer geschaffen. Der Konstruktor wird mit zwei Parametern ausgestattet: dem Zeitintervall in Millisekunden (notwendig) und der Anzahl der Wiederholungen (optional).

[as]var myTimer:Timer = new Timer(200, 0);[/as]

Im konkreten Beispiel wird der Timer alle 200 Millisekunden ausgelöst. Möchte man, dass der Timer „unendlich“ lange läuft, gibt man als Anzahl der Wiederholungen 0 an oder lässt den Parameter einfach weg. Schreibt man stattdessen eine konkrete Zahl größer als Null, z.B. 15, wieder der Timer genau so oft ausgeführt (also 15x).

Als nächsten Schritt muss ein EventListener hinzugefügt werden. Dieser ist nötig, damit der Timer weiß, welche Funktion jeweils nach dem Auslösen eines Events gestartet werden soll. In Beispiel heißt die Funktion updateDisplay und sorgt dafür, dass die aktuelle Zeit des Videos in einem Textfeld angezeigt wird.

[as]myTimer.addEventListener(„timer“, updateDisplay); [/as]

Um den Timer loslaufen zu lassen, muss er nach dem Anfügen des Eventlistener noch mit myTimer.start() gestartet werden. Ein Timer-Objekt hat übrigens (neben dem Konstruktor) drei Methoden:

• Timer.start(): Startet den Timer.
• Timer.stop(): Stoppt den Timer.
• Timer.reset(): Setzt den Timer wieder in den Ursprungszustand (also auf 0).

Im Folgenden der komplette Beispielcode am Stück. Für die Videowiedergabe mit AS3 gibt’s bereits einen Artikel hier im Blog. Die .fla-Datei zum Beispiel: download.

[as]
// ::::::: Video ::::::

var myVideo:Video = new Video(400,300);
addChild(myVideo);
myVideo.x = 50;
myVideo.y = 50;

var nc:NetConnection = new NetConnection();
nc.connect(null);

var ns:NetStream = new NetStream(nc);
myVideo.attachNetStream(ns);
ns.play(„sand.flv“);

var customClient:Object = new Object(); // neues Objekt für die Meldungen
ns.client = customClient;

// ::::::: Textfield ::::::

import flash.text.TextField;
var tf:TextField = new TextField();
addChild(tf);
tf.width = 200;
tf.x = 50;
tf.y = 20;

// ::::::: Timer ::::::

// Timer Klasse und Events vom Typ „TimerEvent“ importieren
import flash.utils.Timer;
import flash.events.TimerEvent;

var myTimer:Timer = new Timer(200, 0); // neuer Timer: alle 200ms, unendliche Wiederholungen
myTimer.addEventListener(„timer“, updateDisplay); // Eventlistener hinzufügen
myTimer.start();

// Funktion, die vom Timer alle 200ms aufgerufen wird
function updateDisplay(event:TimerEvent):void {
tf.text = „Aktuelle Zeit: “ + ns.time; // Textfeld aktualisieren
}
[/as]

Link: Timer-Klasse (ActionScript 3 Reference)