SampleDataEvent  - AS3

Pacchetto	flash.events
Classe	public class SampleDataEvent
Ereditarietà	SampleDataEvent Event Object

Questo evento viene utilizzato in due modi:

• per fornire dati audio generati dinamicamente per un oggetto Sound;
• per ottenere dati audio per un oggetto Microphone.

Generazione dinamica dell'audio tramite l'oggetto Sound Utilizzate l'evento sampleData per riprodurre in modo dinamico l'audio generato. In questo ambiente, l'oggetto Sound non contiene in effetti dati audio. Agisce invece come socket per i dati audio ricevuti in streaming utilizzando la funzione assegnata come gestore per l'evento sampleData.

Nella funzione, utilizzate il metodo ByteArray.writeFloat() per scrivere nella proprietà data dell'evento, che contiene i dati campionati da riprodurre.

Se un oggetto Sound non ha caricato un file MP3, quando chiamate il relativo metodo play(), l'oggetto inizia a inviare eventi sampleData, richiedendo campionamenti audio. L'oggetto Sound continua a inviare eventi durante la riproduzione del suono finché non interrompete l'invio di dati o finché non chiamate il metodo stop().

La latenza dell'evento varia da piattaforma a piattaforma e potrebbe cambiare nelle versioni future di Flash Player o AIR. Evitate dipendenze da una latenza specifica. Calcolatela invece utilizzando ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Fornite da 2048 a 8192 campionamenti alla proprietà data dell'oggetto SampleDataEvent. Per ottenere risultati ottimali, fornite il maggior numero possibile di campionamenti. Con un numero di campionamenti limitato, è più probabile che durante la riproduzione si verifichino schiocchi e clic. Questo comportamento può variare da piattaforma a piattaforma e verificarsi in diverse situazioni, ad esempio quando si ridimensiona il browser. Potreste scrivere codice con solo 2048 campionamenti che funziona correttamente su una piattaforma, ma che non funziona altrettanto bene quando viene eseguito su una piattaforma diversa. Se avete l'esigenza di utilizzare la più bassa latenza possibile, considerate la possibilità di rendere la quantità di dati selezionabile dall'utente.

Se fornite meno di 2048 campionamenti, l'oggetto Sound riproduce i campionamenti rimanenti e interrompe la riproduzione come se fosse stata raggiunta la fine di un file audio, generando un evento complete.

Potete utilizzare il metodo extract() di un oggetto Sound per estrarre i relativi dati audio, che potete quindi scrivere nel flusso dinamico per la riproduzione.

Quando usate l'evento sampleData con un oggetto Sound, gli unici altri metodi Sound attivati sono extract() e play(). La chiamata a qualsiasi altro metodo o proprietà genera un'eccezione di "chiamata non valida". Tutti i metodi e le proprietà dell'oggetto SoundChannel continuano a essere abilitati.

Cattura dell'audio del microfono Utilizzate l'evento sampleData per catturare i dati audio da un microfono. Quando aggiungete un listener di eventi per l'evento sampleData, l'oggetto Microphone invia l'evento quando i campionamenti audio diventano disponibili.

Nella funzione del gestore di eventi, utilizzate il metodo ByteArray.writeFloat() per leggere la proprietà data dell'evento, che contiene i dati campionati. L'evento conterrà più campionamenti, quindi dovete utilizzare un ciclo while per leggere i dati disponibili:

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

Vedere gli esempi

Altre informazioni

Elementi API correlati