Die ActionScript 3.0-Soundarchitektur ist leistungsfähig, aber komplex. Anwendungen, die nur einfache Funktionen zum Laden und zur Wiedergabe von Sounds umfassen müssen, können mithilfe einer Klasse erstellt werden, die einige der komplexen Funktionen ausblendet, und nur einen einfachen Satz von Methoden aufruft und Ereignissen bereitstellt. In der Welt des Softwaredesigns wird eine solche Klasse als
facade
(Fassade) bezeichnet.
Die SoundFacade-Klasse stellt eine einfache Schnittstelle für die folgenden Aufgaben bereit:
-
Laden von Sounddateien mithilfe eines Sound-Objekts, eines SoundLoaderContext-Objekts und der SoundMixer-Klasse
-
Wiedergabe von Sounddateien mithilfe eines Sound-Objekts und eines SoundChannel-Objekts
-
Auslösen von Ereignissen zum Wiedergabefortschritt
-
Unterbrechen und Fortsetzen der Soundwiedergabe mithilfe eines Sound-Objekts und eines SoundChannel-Objekts
Die SoundFacade-Klasse versucht, den wichtigsten Teil der Funktionsmerkmale der ActionScript-Soundklassen bei geringerer Komplexität bereitzustellen.
Im folgenden Code wird die Deklaration der Klasse, der Klasseneigenschaften und der
SoundFacade()
-Konstruktormethode gezeigt:
public class SoundFacade extends EventDispatcher
{
public var s:Sound;
public var sc:SoundChannel;
public var url:String;
public var bufferTime:int = 1000;
public var isLoaded:Boolean = false;
public var isReadyToPlay:Boolean = false;
public var isPlaying:Boolean = false;
public var isStreaming:Boolean = true;
public var autoLoad:Boolean = true;
public var autoPlay:Boolean = true;
public var pausePosition:int = 0;
public static const PLAY_PROGRESS:String = "playProgress";
public var progressInterval:int = 1000;
public var playTimer:Timer;
public function SoundFacade(soundUrl:String, autoLoad:Boolean = true,
autoPlay:Boolean = true, streaming:Boolean = true,
bufferTime:int = -1):void
{
this.url = soundUrl;
// Sets Boolean values that determine the behavior of this object
this.autoLoad = autoLoad;
this.autoPlay = autoPlay;
this.isStreaming = streaming;
// Defaults to the global bufferTime value
if (bufferTime < 0)
{
bufferTime = SoundMixer.bufferTime;
}
// Keeps buffer time reasonable, between 0 and 30 seconds
this.bufferTime = Math.min(Math.max(0, bufferTime), 30000);
if (autoLoad)
{
load();
}
}
Die SoundFacade-Klasse erweitert die EventDispatcher-Klasse, sodass sie eigene Ereignisse auslösen kann. Zunächst deklariert der Klassencode Eigenschaften für ein Sound- und ein SoundChannel-Objekt. Außerdem speichert die Klasse den URL-Wert der Sounddatei und eine
bufferTime
-Eigenschaft, die beim Streamen des Sounds verwendet werden. Weiterhin akzeptiert sie einige boolesche Parameterwerte, die sich auf das Verhalten beim Laden und bei der Wiedergabe auswirken:
-
Der
autoLoad
-Parameter weist das Objekt an, dass der Sound geladen werden soll, sobald dieses Objekt erstellt wurde.
-
Der
autoPlay
-Parameter gibt an, dass die Soundwiedergabe beginnen soll, sobald ausreichend Daten geladen wurden. Handelt es sich um einen Streaming-Sound, beginnt die Wiedergabe, sobald ausreichend Daten geladen wurden. Die erforderliche Datenmenge wird mit der Eigenschaft
bufferTime
vorgegeben.
-
Der
streaming
-Parameter gibt an, dass die Wiedergabe dieser Sounddatei beginnen kann, wenn das Laden der Daten vollständig abgeschlossen wurde.
Der
bufferTime
-Parameter hat einen Standardwert von -1. Wenn die Konstruktormethode einen negativen Wert im
bufferTime
-Parameter erfasst, stellt sie die
bufferTime
-Eigenschaft auf den Wert
SoundMixer.bufferTime
ein. Damit kann die Anwendung den globalen
SoundMixer.bufferTime
-Wert als Standardwert annehmen.
Wenn der
autoLoad
-Parameter auf
true
gesetzt ist, ruft die Konstruktormethode unmittelbar die folgende
load()
-Methode auf, um das Laden der Sounddatei zu starten:
public function load():void
{
if (this.isPlaying)
{
this.stop();
this.s.close();
}
this.isLoaded = false;
this.s = new Sound();
this.s.addEventListener(ProgressEvent.PROGRESS, onLoadProgress);
this.s.addEventListener(Event.OPEN, onLoadOpen);
this.s.addEventListener(Event.COMPLETE, onLoadComplete);
this.s.addEventListener(Event.ID3, onID3);
this.s.addEventListener(IOErrorEvent.IO_ERROR, onIOError);
this.s.addEventListener(SecurityErrorEvent.SECURITY_ERROR, onIOError);
var req:URLRequest = new URLRequest(this.url);
var context:SoundLoaderContext = new SoundLoaderContext(this.bufferTime, true);
this.s.load(req, context);
}
Die
load()
-Methode erstellt ein neues Sound-Objekt und fügt Listener für alle wichtigen Soundereignisse hinzu. Dann weist sie das Sound-Objekt an, die Sounddatei zu laden. Dabei verwendet sie ein SoundLoaderContext-Objekt, um den
bufferTime
-Wert zu übergeben.
Da die
url
-Eigenschaft geändert werden kann, können mit einer SoundFacade-Instanz verschiedene Sounddateien nacheinander wiedergegeben werden: Ändern Sie einfach die
url
-Eigenschaft und rufen Sie die
load()
-Methode auf – die neue Sounddatei wird geladen.
Die folgenden drei Ereignis-Listener-Methoden zeigen, wie das SoundFacade-Objekt den Ladefortschritt verfolgt und dann entscheidet, wann der Sound wiedergegeben wird:
public function onLoadOpen(event:Event):void
{
if (this.isStreaming)
{
this.isReadyToPlay = true;
if (autoPlay)
{
this.play();
}
}
this.dispatchEvent(event.clone());
}
public function onLoadProgress(event:ProgressEvent):void
{
this.dispatchEvent(event.clone());
}
public function onLoadComplete(event:Event):void
{
this.isReadyToPlay = true;
this.isLoaded = true;
this.dispatchEvent(evt.clone());
if (autoPlay && !isPlaying)
{
play();
}
}
Die
onLoadOpen()
-Methode wird ausgeführt, wenn das Laden des Sounds beginnt. Wenn der Sound im Streaming-Modus wiedergegeben werden kann, stellt die
onLoadComplete()
-Methode das
isReadyToPlay
-Flag direkt auf
true
ein. Das
isReadyToPlay
-Flag legt fest, ob die Anwendung die Soundwiedergabe starten kann, eventuell als Reaktion auf eine Benutzeraktion wie das Klicken auf die Wiedergabe-Schaltfläche. Die SoundChannel-Klasse verwaltet die Pufferung der Sounddaten, es ist also nicht erforderlich, explizit zu überprüfen, ob ausreichend Daten geladen wurden, bevor die
play()
-Methode aufgerufen wird.
Die
onLoadProgress()
-Methode wird während des Ladeprozesses in regelmäßigen Abständen ausgeführt. Sie sendet einfach einen Klon ihres ProgressEvent-Objekts für den Code, der dieses SoundFacade-Objekt verwendet.
Nachdem die Sounddaten vollständig geladen wurden, wird die
onLoadComplete()
-Methode ausgeführt, die bei Bedarf die
play()
-Methode für nicht gestreamte Sounds aufruft. Die
play()
-Methode wird im Folgenden gezeigt.
public function play(pos:int = 0):void
{
if (!this.isPlaying)
{
if (this.isReadyToPlay)
{
this.sc = this.s.play(pos);
this.sc.addEventListener(Event.SOUND_COMPLETE, onPlayComplete);
this.isPlaying = true;
this.playTimer = new Timer(this.progressInterval);
this.playTimer.addEventListener(TimerEvent.TIMER, onPlayTimer);
this.playTimer.start();
}
}
}
Die
play()
-Methode ruft die
Sound.play()
-Methode auf, wenn der Sound bereit zur Wiedergabe ist. Das resultierende SoundChannel-Objekt wird in der
sc
-Eigenschaft gespeichert. Dann erstellt die
play()
-Methode ein Timer-Objekt, das in regelmäßigen Abständen Wiedergabefortschrittsereignisse auslöst.
