SampleDataEvent  - AS3

Пакет	flash.events
Класс	public class SampleDataEvent
Наследование	SampleDataEvent Event Object

Это событие может применяться двумя способами:

• для предоставления динамически создаваемых аудиоданных объекту Sound;
• для получения данных от объекта Microphone.

Динамическое создание аудио с помощью объекта Sound. Используйте событие sampleData для воспроизведения динамически создаваемого аудио. В данной среде объект Sound на самом деле не содержит звуковых данных. Вместо этого он выполняет функцию сокета для потока звуковых данных, направляемых ему при помощи функции, назначенной в качестве обработчика события sampleData.

В функции используется метод ByteArray.writeFloat() для записи в свойство data события, которое содержит отобранные для воспроизведения данные.

Если объект Sound не загрузил файл MP3, то при вызове его метода play() объект начинает отправлять события sampleData, запрашивая образцы звука. Объект Sound продолжает отправлять события в процессе воспроизведения звука, пока не прекращается передача данных или пока не будет вызван метод stop() объекта SoundChannel.

Время ожидания события варьируется от платформы к платформе и может измениться в будущих версиях Flash Player или AIR. Не следует привязывать программу к определенному времени ожидания. Вместо этого его следует вычислять по формуле ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Предоставьте от 2048 до 8192 образцов для свойства data объекта SampleDataEvent. Для лучшей производительности укажите как можно больше образцов. Чем меньше образцов вы укажете, тем больше вероятность возникновения звуковых помех во время воспроизведения. Однако этот принцип действует по-разному на разных платформах, и помехи могут возникнуть в различных ситуациях, например при изменении размера браузера. Вы можете написать код, который будет работать на одной платформе с 2048 образцами, но это не значит, что этот код будет работать так же хорошо на другой платформе. Если вам требуется как можно меньший период ожидания, предоставьте пользователям возможность выбирать объем данных.

Если указать менее 2048 образцов, объект Sound воспроизведет оставшиеся образцы и остановит звук, как будто был достигнут конец аудиофайла, создав событие complete

С помощью метода extract() объекта Sound можно извлечь его аудиоданные, которые затем можно записать в динамический поток для воспроизведения.

При использовании прослушивателя события sampleData с объектом Sound единственными доступными методами класса Sound являются extract() и play(). Вызов любых других методов или свойств приводит к возникновению исключения «недопустимый вызов». Все методы и свойства объекта SoundChannel остаются доступными.

Захват аудио из объекта Microphone Используйте событие sampleData для захвата аудиоданных с микрофона. При добавлении прослушивателя для события sampleData объект Microphone отправляет это событие, когда становятся доступны образцы звука.

В функции обработчика событий следует использовать метод ByteArray.readFloat() для чтения свойства data, содержащего данные образца. Событие будет содержать несколько образцов, поэтому следует использовать цикл while для чтения доступных данных.

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

Посмотреть примеры

Дополнительно

Связанные элементы API