Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Arbeiten mit Sounds
Laden von externen Sounddateien
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Jede Instanz der Sound-Klasse dient dazu, eine bestimmte Soundressource zu laden und deren Wiedergabe
auszulösen. Ein Sound-Objekt kann nicht von einer Anwendung wiederverwendet werden, um mehrere Sounds zu
laden. Wenn die Anwendung eine neue Soundressource laden möchte, muss sie ein neues Sound-Objekt erstellen.
Wenn Sie eine kleine Sounddatei laden (beispielsweise einen Klick-Sound, der an eine Schaltfläche angehängt werden
soll), kann Ihre Anwendung ein neues Sound-Objekt erstellen und dieses die Sounddatei automatisch laden lassen.
Dies wird im folgenden Code gezeigt:
var req:URLRequest = new URLRequest("click.mp3");
var s:Sound = new Sound(req);
Der Sound()-Konstruktor benötigt als ersten Parameter ein URLRequest-Objekt. Wenn ein Wert für den
URLRequest-Parameter angegeben wird, lädt das neue Sound-Objekt automatisch die angegebene Soundressource.
In allen außer in den einfachsten Fällen sollte Ihre Anwendung den Ladevorgang des Sounds überwachen und auf
Fehler während des Ladens achten. Angenommen, der Klick-Sound ist relativ groß, so ist er eventuell noch nicht
vollständig geladen, wenn der Benutzer auf die Schaltfläche klickt, die den Sound auslöst. Der Versuch, einen nicht
geladenen Sound wiederzugeben, führt zu einem Laufzeitfehler. Bevor also Benutzer eine Aktion ausführen, die eine
Soundwiedergabe auslöst, sollte gewartet werden, bis der Sound vollständig geladen ist.
Ein Sound-Objekt löst während des Ladens eines Sounds verschiedener Ereignisse aus. Ihre Anwendung kann auf
diese Ereignisse überwachen, um den Ladevorgang zu verfolgen und so sicherzustellen, dass der Sound vollständig
geladen ist, bevor die Wiedergabe gestartet wird. In der folgenden Tabelle sind die Ereignisse aufgeführt, die von
einem Sound-Objekt ausgelöst werden können:
Ereignis Beschreibung
open (Event.OPEN) Wird direkt vor dem Beginn des Sound-Ladevorgangs ausgelöst.
progress (ProgressEvent.PROGRESS) Wird regelmäßig während des Sound-Ladevorgangs ausgelöst, wenn die Daten aus einer Datei
oder einem Stream empfangen werden.
id3 (Event.ID3) Wird ausgelöst, wenn für einen MP3-Sound ID3-Daten zur Verfügung stehen.
complete (Event.COMPLETE) Wird ausgelöst, wenn alle Daten der Soundressource geladen wurden.
ioError (IOErrorEvent.IO_ERROR) Wird ausgelöst, wenn eine Sounddatei nicht gefunden werden kann oder der Ladeprozess
unterbrochen wird, bevor alle Sounddaten empfangen wurden.
Im folgenden Code wird gezeigt, wie ein Sound wiedergegeben wird, nachdem er vollständig geladen wurde:
Letzte Aktualisierung 27.6.2012
471