SampleDataEvent  - AS3

Paket	flash.events
Klass	public class SampleDataEvent
Arv	SampleDataEvent Event Object

Händelsen har två användningsområden:

• Tillhandahålla dynamiskt genererade ljuddata för ett Sound-objekt
• Hämta ljuddata för ett Microphone-objekt

Generera ljud dynamiskt med Sound-objektet Använd händelsen sampleData för att spela ljud som genereras dynamiskt. I den här miljön innehåller Sound-objektet inte ljuddata. I stället fungerar den som en socket för ljuddata som börjar flöda till den när den funktion som du har tilldelat som hanterare av sampleData-händelsen används.

I din funktion använder du metoden ByteArray.writeFloat() för att skriva till händelsens data-egenskap som innehåller de samplade data som du vill spela.

När du anropar metoden play() för ett Sound-objekt och Sound-objektet inte har läst in en MP3-fil, börjar objektet skicka sampleData-händelser som begär ljudsamples. Sound-objektet fortsätter att skicka händelser när ljudet spelas upp tills data inte längre tillhandahålls eller tills metoden stop() anropas för SoundChannel-objektet.

Händelsens tidsfördröjning kan variera från plattform till plattform och kan ändras i framtida versioner av Flash Player eller AIR. Förlita dig inte på en särskild tidsfördröjning. Beräkna den stället med ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Tillhandahåll mellan 2 048 och 8 192 samplingar för data-egenskapen i SampleDataEvent-objektet. Ju fler samplingar, desto bättre prestanda. Ju färre samplingar, desto mer troligt är det att störningar inträffar under uppspelning. Det här beteendet är olika på olika plattformar och inträffar i olika situationer, till exempel när webbläsare ändrar storlek. Du kan skriva kod som fungerar på en plattform när du använder 2 048 samplingar, men samma kod kanske inte fungerar lika bra när den körs på en annan plattform. Om du kräver lägsta möjliga tidsfördröjning bör du överväga att göra mängen data valbar för användaren.

Om du har färre än 2 048 samplingar spelar Sound-objektet återstående samplingar. Sedan stoppas ljudet som om slutet på ljudfilen vore nådd och en complete-händelse genereras.

Du kan använda metoden extract() i ett Sound-objekt för att extrahera ljuddata som du sedan kan skriva till den dynamiska strömmen för uppspelning.

När du använder en sampleData-händelse med ett Sound-objekt är de enda Sound-metoder som aktiveras extract() och play(). Anrop av andra metoder eller egenskaper resulterar i undantaget ”invalid call”. Alla metoder och egenskaper för SoundChannel-objektet är fortfarande aktiverade.

Hämta mikrofonljud Använd händelsen sampleData när du vill hämta ljuddata från en mikrofon. När du lägger till en händelseavlyssnare för sampleData-händelsen skickar Microphone-objektet händelsen så fort ljudsamplingar är tillgängliga.

Använd ByteArray.readFloat()-metoden i händelseavlyssnarfunktionen för att läsa händelsens data)-egenskap som innehåller samplade data. Händelsen innehåller flera samplingar, därför bör du använda en while-slinga för att läsa tillgängliga data:

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

Visa exemplen

Relaterade API-element