Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Arbeiten mit Sounds
Überwachen der Wiedergabe
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Ihrer Anwendung muss wissen, wann ein Sound beendet ist, sodass ein weiterer Sound wiedergegeben oder bestimmte
Ressourcen freigegeben werden können, die für die abgeschlossene Wiedergabe verwendet wurden. Die
SoundChannel-Klasse löst ein Event.SOUND_COMPLETE-Ereignis aus, nachdem ein Sound vollständig wiedergegeben
wurde. Ihre Anwendung kann auf dieses Ereignis überwachen und eine entsprechende Aktion ausführen. Betrachten
Sie dazu den folgenden Beispielcode:
import flash.events.Event;
import flash.media.Sound;
import flash.net.URLRequest;
var snd:Sound = new Sound();
var req:URLRequest = new URLRequest("smallSound.mp3");
snd.load(req);
var channel:SoundChannel = snd.play();
channel.addEventListener(Event.SOUND_COMPLETE, onPlaybackComplete);
public function onPlaybackComplete(event:Event)
{
trace("The sound has finished playing.");
}
Die SoundChannel-Klasse löst während der Wiedergabe keine Fortschrittereignisse aus. Um den Fortschritt der
Wiedergabe zu melden, muss Ihre Anwendung einen eigenen Timermechanismus einrichten und die Position des
Sound-Abspielkopfs verfolgen.
Zur Berechnung des Prozentsatzes, der von einem Sound wiedergegeben wurde, können Sie den Wert der
SoundChannel.position-Eigenschaft durch die Länge der Sounddaten dividieren, die bereits wiedergegeben
wurden:
var playbackPercent:uint = 100 * (channel.position / snd.length);
Jedoch meldet dieser Code nur dann den genauen Prozentsatz der wiedergegebenen Sounddaten, wenn die Datei
vollständig geladen war, bevor die Wiedergabe gestartet wurde. Die Sound.length-Eigenschaft zeigt die Größe der
aktuell geladenen Sounddaten, nicht die tatsächliche Größe der gesamten Sounddatei an. Um den Fortschritt bei der
Wiedergabe eines Streaming-Sounds zu verfolgen, der noch geladen wird, muss Ihre Anwendung die tatsächliche
Größe der gesamten Sounddatei schätzen und diesen Wert in den Berechnungen verwenden. Sie können die
tatsächliche Länge der Sounddaten mithilfe der bytesLoaded- und bytesTotal-Eigenschaften des Sound-Objekts
schätzen. Dazu wird z. B. der folgende Code verwendet:
var estimatedLength:int =
Math.ceil(snd.length / (snd.bytesLoaded / snd.bytesTotal));
var playbackPercent:uint = 100 * (channel.position / estimatedLength);
Mit dem folgenden Code wird eine größere Sounddatei geladen und als Timermechanismus das
Event.ENTER_FRAME-Ereignis verwendet, um den Fortschritt bei der Wiedergabe anzuzeigen. Der Code meldet
regelmäßig den Prozentsatz der wiedergegebenen Sounddaten, der aus dem Wert für die aktuelle Position dividiert
durch die Gesamtlänge der Sounddaten berechnet wird:
Letzte Aktualisierung 27.6.2012
480