SampleDataEvent  - AS3

Paket	flash.events
Klasse	public class SampleDataEvent
Vererbung	SampleDataEvent Event Object

Dieses Ereignis hat zwei Verwendungen:

• Um dynamisch generierte Audiodaten für ein Sound-Objekt bereitzustellen
• Um Audiodaten für ein Microphone-Objekt abzurufen

Dynamisches Generieren von Audio mit dem Sound-Objekt Verwenden Sie das sampleData-Ereignis, um dynamisch generiertes Audio abzuspielen. In dieser Umgebung enthält das Sound-Objekt keine Sounddaten an sich. Es fungiert stattdessen als Socket für Sounddaten, die zum Objekt gestreamt werden. Das Streamen erfolgt mittels einer Funktion, die Sie dem sampleData Ereignis zuweisen.

Sie verwenden in Ihrer Funktion die ByteArray.writeFloat()-Methode, um in die data-Eigenschaft des Ereignisses zu schreiben, die die Beispieldaten, die Sie abspielen möchten, enthält.

Wenn ein Sound-Objekt keine MP3-Datei geladen hat und Sie seine play()-Methode aufrufen, setzt das Objekt sampleData-Ereignisse ab, um Soundsamples anzufordern. Das Sound-Objekt fährt während der Wiedergabe damit fort, Ereignisse abzusetzen, bis Sie keine Daten mehr bereitstellen oder bis die stop()-Methode des SoundChannel-Objekts aufgerufen wird.

Die Wartezeit des Ereignisses unterscheidet sich von Plattform zu Plattform und kann sich in zukünftigen Versionen von Flash Player oder AIR ändern. Verlassen Sie sich nicht auf eine bestimmte Wartezeit. Berechnen Sie sie stattdessen mit ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Stellen Sie der data-Eigenschaft des SampleDataEvent-Objekts zwischen 2048 und 8192 Samples bereit. Um die beste Leistung zu erzielen, stellen Sie so viele Beispiele wie möglich zur Verfügung. Je weniger Beispiele Sie zur Verfügung stellen, desto wahrscheinlicher ist es, dass während des Abspielens Knackgeräusche und Ähnliches auftritt. Dies kann von Plattform zu Plattform unterschiedlich sein und in verschiedenen Situationen auftreten, zum Beispiel wenn die Browsergröße verändert wird. Wenn Sie Code schreiben, der mit nur 2.048 Beispielen auf einer Plattform funktioniert, kann es vorkommen, dass derselbe Code auf einer anderen Plattform nicht so gut funktioniert. Wenn Sie die geringst mögliche Wartezeit benötigen, überlegen Sie sich, ob Sie die Menge der Daten vom Benutzer auswählen lassen.

Wenn Sie weniger als 2.048 Samples bereitstellen, spielt das Sound-Objekt die verbleibenden Samples ab und stoppt dann die Wiedergabe, als wäre das Ende der Sounddatei erreicht, und generiert ein complete-Ereignis.

Sie können die extract()-Methode eines Sound-Objekts verwenden, um seine Sounddaten zu extrahieren, die Sie dann in den dynamischen Stream für die Wiedergabe schreiben können.

Wenn Sie das sampleData-Ereignis mit einem Sound-Objekt verwenden, sind als weitere Sound-Methoden nur noch extract() und play() aktiviert. Das Aufrufen anderer Methoden oder Eigenschaften verursacht eine Ausnahme aufgrund eines ungültigen Aufrufs („invalid call“). Alle Methoden und Eigenschaften des SoundChannel-Objekts sind nach wie vor aktiviert.

Erfassen von Mikrofonaudio Verwenden Sie das sampleDataEreignis, um Audiodaten von einem Mikrofon zu erfassen. Wenn Sie einen Ereignis-Listener für das sampleData-Ereignis hinzufügen, setzt das Microphone-Objekt das Ereignis ab, sobald Audiosamples verfügbar sind.

Verwenden Sie in der Ereignisprozedurfunktion die ByteArray.readFloat()-Methode, um die data-Eigenschaft des Ereignisses zu lesen, die die Sampledaten enthält. Das Ereignis enthält mehrere Samples, deshalb sollten Sie eine while-Schleife verwenden, um die verfügbaren Daten zu lesen:

var soundBytes:ByteArray = new ByteArray();
 while(event.data.bytesAvailable)
 {
      var sample:Number = event.data.readFloat();
      soundBytes.writeFloat(sample);
 }

Beispiele anzeigen

Verwandte API-Elemente