SampleDataEvent  - AS3

Paquete	flash.events
Clase	public class SampleDataEvent
Herencia	SampleDataEvent Event Object

Este evento tiene dos usos:

• Proporcionar datos de audio generado dinámicamente para un objeto Sound
• Obtener datos de audio para un objeto Microphone

Generación dinámica de audio mediante el objeto Sound Utilice el evento sampleData para reproducir audio generado dinámicamente. En este entorno, el objeto Sound en realidad no contiene únicamente datos de sonido. Actúa como socket para datos de sonido transmitidos en flujo mediante la función asignada como controlador del evento sampleData.

En su función, puede utilizar el método ByteArray.writeFloat() para escribir la propiedad data) del evento que contenga datos de muestra que quiera reproducir.

Si un objeto Sound no ha cargado un archivo MP3, al llamar a su método play(), el objeto comienza a distribuir eventos sampleData y a solicitar muestras de sonido. El objeto Sound sigue enviando eventos a medida que se reproduce el sonido hasta que se detiene el suministro de datos o hasta que se llama al método stop() del objeto SoundChannel.

La latencia del evento varía en función de la plataforma y puede cambiar en futuras versiones de Flash Player o AIR. No depende de una latencia concreta. Se calcula utilizando ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Proporcione entre 2048 y 8192 muestras a la propiedad data del objeto SampleDataEvent. Para obtener el mejor rendimiento, proporcione tantas muestras como sea posible. Cuanto menor sea el número de muestras, más probable será la aparición de interferencias en la reproducción. Este comportamiento puede variar en función de la plataforma y según las situaciones, por ejemplo, al cambiar de tamaño la ventana del navegador. Puede escribir código que funcione en una plataforma cuando se facilitan sólo 2048 muestras, pero el mismo código puede no funcionar del mismo modo en otra plataforma distinta. Si necesita la menor latencia posible, considere la posibilidad de que sea el usuario quien seleccione la cantidad de datos.

Si proporciona menos de 2048 muestras, el objeto Sound reproduce el resto de muestras y detiene el sonido, como si hubiera llegado al final de un archivo de sonido, con lo que se genera un evento complete.

Puede utilizar el método extract() de un objeto Sound para extraer sus datos de sonido, que posteriormente puede escribir en el flujo dinámico para la reproducción.

Cuando se utiliza un evento sampleData con un objeto Sound, los únicos métodos de Sound que permanecen activados son extract() y play(). Llamar a otros métodos o propiedades genera una excepción de "llamada no válida". Todos los métodos y propiedades del objeto SoundChannel siguen activados.

Capturing Microphone audio Utilice el evento sampleData para capturar datos de audio desde un micrófono. Cuando se añade un detector de eventos para el evento sampleData, el micrófono distribuye el evento a medida que están disponibles las muestras de audio.

En la función del controlador de eventos, utilice el método ByteArray.readFloat() para leer la propiedad data del evento, que contiene los datos de muestra. El evento contendrá diversas muestras, por lo que se debe utilizar un bucle loop bucle para leer los datos disponibles:

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

Ver los ejemplos

Elementos de API relacionados