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

Язык версии :

ActionScript 3.0

Версии среды выполнения:

Flash Player 10

Отправляется при запросе проигрывателем новых аудиоданных.

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

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

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

Время ожидания события варьируется от платформы к платформе и может измениться в будущих версиях Flash Player. Рекомендуется вычислять время ожидания, а не полагаться на указанную величину. Для вычисления времени ожидания в ActionScript используйте формулу: ((SampleDataEvent.position/44.1) — SoundChannelObject.position).

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

Если указать менее 2048 образцов, Flash Player воспроизведет оставшиеся образцы и остановит звук, как-будто был достигнут конец аудиофайла, создав событие SoundComplete.

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

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

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

См. также

---

var mySound:Sound = new Sound();
function sineWaveGenerator(event:SampleDataEvent):void {
    for ( var c:int=0; c<8192; c++ ) {
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
    }
}

mySound.addEventListener(Event.SAMPLE_DATA,sineWaveGenerator);
mySound.play();