SampleDataEvent  - AS3

Pacote	flash.events
Classe	public class SampleDataEvent
Herança	SampleDataEvent Event Object

Este evento tem dois usos:

• Fornecer dados de áudio gerado dinamicamente de um objeto Som
• Adquirir dados de áudio de um objeto Microfone

Áudio gerado dinamicamente, usando o objeto Som Use o evento sampleData para jogar o áudio gerado dinamicamente. Nesse ambiente, o objeto Sound não contém realmente dados de som. Em vez disso, ele atua como um soquete para dados de som que estão sendo transmitidos por meio do uso da função que você atribui ao evento sampleData.

Na sua função, use o método ByteArray.writeFloat() para gravar na propriedade data) do evento, que contém os dados de amostra que deverão ser reproduzidos.

Se um objeto Som não carregou um arquivo MP3, quando você invoca o seu play() método o despacho de partidas de objeto sampleData eventos, solicitando amostras sólidas. O objeto Som continua para enviar eventos conforme o som é reproduzido até que você interrompa o fornecimento de dados, ou até que o método parar() do objeto de SoundChannel é chamado.

A latência do evento varia de uma plataforma para outra e pode mudar em versões futuras do Flash Player ou AIR. Não dependa de uma latência específica. Em vez disso, calcule-o utilizando ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Forneça entre 2048 e 8192 amostras à propriedade dados propriedade do objeto de SampleDataEvent. Para obter um desempenho ideal, forneça o máximo possível de amostras. Quanto menos amostras forem fornecidas, maior será a probabilidade de ocorrerem cliques e estalos durante a reprodução. Esse comportamento pode diferir em várias plataformas e pode ocorrer em diversas situações, por exemplo, no redimensionamento do navegador. Você pode gravar o código que funciona em uma plataforma quando fornece somente 2.048 amostras, mas o mesmo código não funcionará tão bem quando for executado em outra plataforma. Se precisar da menor latência possível, pense na possibilidade de tornar o volume de dados selecionável para o usuário.

Se você fornecer menos de 2.048 amostras, o objeto Sound reproduzirá as amostras restantes e interromperá o som como se tivesse atingido o final de um arquivo de som, gerando um evento complete.

Você pode usar o método extracto() de um objeto Som para extrair os seus dados de som e, desse modo, gravar à corrente dinâmica da reprodução de gravação.

Quando você usa o evento sampleData com um objeto Sound, os únicos métodos Sound ativados são extract() e play(). Chamar qualquer outro método ou propriedade resultará em uma exceção de "chamada inválida". Todos os métodos e propriedades do objeto SoundChannel continuam ativados.

Capturando áudio de Microfone Use o evento sampleData para capturar dados áudio de um microfone. Quando você adiciona um ouvinte de eventos ao evento sampleData, o Microfone despacha o evento conforme as amostras de áudio ficam disponíveis.

Na função de treinador de evento, use o método ByteArray.readFloat() para ler a propriedade dados) do evento, que contém os dados escolhidos. O evento conterá múltiplas amostras, portanto você deve usar um loop enquanto para ler os dados disponíveis:

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

Veja os exemplos

Elementos da API relacionados