SampleDataEvent  - AS3

Pakket	flash.events
Klasse	public class SampleDataEvent
Overerving	SampleDataEvent Event Object

Deze gebeurtenis heeft twee functies:

• Dynamisch gegenereerde audiogegevens leveren voor een Sound-object
• Audiogegevens ophalen voor een Microphone-object

Audio dynamisch genereren met het Sound-object Met de sampleData-gebeurtenis kunt u dynamisch gegenereerde audio afspelen. In deze omgeving bevat het object Sound geen geluidgegevens. In plaats hiervan fungeert het als een socket voor geluidsgegevens die ernaar worden gestreamd door de functie die u toewijst als handler voor de sampleData-gebeurtenis.

In uw functie gebruikt u de methode ByteArray.writeFloat() om te schrijven naar de eigenschap data van de gebeurtenis waarin de gesampelde gegevens bevat zijn opgenomen die u wilt afspelen.

Als een Sound-object geen MP3-bestand heeft geladen en u de methode play() aanroept, begint het object met het verzenden van sampleData-gebeurtenissen en met het aanvragen van geluidssamples. Het Sound-object gaat tijdens het afspelen van het geluid door met het verzenden van gebeurtenissen, totdat u ophoudt met het aanleveren van gegevens of totdat de methode stop() van het SoundChannel-object wordt aangeroepen.

De vertraging van gebeurtenissen varieert per platform en kan veranderen in toekomstige versies van Flash Player of AIR Zorg ervoor dat u niet afhankelijk bent van een bepaalde vertraging. U kunt de vertraging het beste berekenen met ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Zorg ervoor dat u tussen de 2048 en 8192 samples levert aan de eigenschap data van het SampleDataEvent-object. U krijgt de beste resultaten als u zoveel mogelijk samples aanlevert. Hoe minder samples u aanlevert, des te groter de kans op ongewenste geluiden en onderbrekingen tijdens het afspelen. Dit gedrag verschilt per platform en kan in verschillende situaties optreden, bijvoorbeeld wanneer u de afmetingen van de browser wijzigt. Uw code kan goed werken op het ene platform wanneer u slechts 2048 samples aanlevert, maar diezelfde code kan mindere resultaten geven op een ander platform. Als u de kleinst mogelijke vertraging nodig hebt, kunt u overwegen om de hoeveelheid gegevens door de gebruiker te laten selecteren.

Als u minder dan 2048 samples aanlevert, worden de resterende samples door het Sound-object afgespeeld en het geluid gestopt alsof het einde van een geluidsbestand is bereikt, waarbij een gebeurtenis complete wordt gegenereerd.

Met de methode extract() van een Sound-object kunt u geluidsgegevens extraheren en schrijven naar de dynamische stream voor afspelen.

Als u de gebeurtenis sampleData gebruikt met een Sound-object, worden alleen de Sound-methoden extract() en play() ingeschakeld. Als u andere methoden of eigenschappen aanroept, resulteert dit in de uitzondering 'ongeldige aanroep'. Alle methoden en eigenschappen van het object SoundChannel blijven ingeschakeld.

Geluid van een microfoon vastleggen Met de gebeurtenis sampleData kunt u de audiogegevens van een microfoon vastleggen. Wanneer u een gebeurtenislistener toevoegt voor de sampleData-gebeurtenis, wordt de gebeurtenis door de microfoon verzonden zodra de audiosamples beschikbaar komen.

Met de methode ByteArray.readFloat() van de gebeurtenishandlerfunctie kunt u de eigenschap data) van de gebeurtenis lezen. Hierin staan de gesampelde gegevens. De gebeurtenis bevat meerdere samples. U kunt de beschikbare gegevens het beste met een while-lus lezen:

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

Bekijk de voorbeelden

Verwante API-elementen