BaseAudioContext: метод createPeriodicWave()

Метод createPeriodicWave() интерфейса BaseAudioContext используется для создания PeriodicWave. Эта волна используется для определения периодической формы волны, которая может быть использована для формирования выходного сигнала OscillatorNode.

real

Массив косинусных членов (традиционно A-члены).

imag

Массив синусных членов (традиционно B-члены).

Массивы real и imag должны иметь одинаковую длину, иначе будет выброшено исключение.

constraints Необязательно

Объект-словарь, который определяет, следует ли отключать нормализацию. Если не указано, нормализация включена по умолчанию. Он принимает один параметр:

disableNormalization

Если установлено значение true, нормализация для периодической волны отключена. По умолчанию false.

Объект PeriodicWave.

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

const real = new Float32Array(2);
const imag = new Float32Array(2);
const ac = new AudioContext();
const osc = ac.createOscillator();

real[0] = 0;
imag[0] = 0;
real[1] = 1;
imag[1] = 0;

const wave = ac.createPeriodicWave(real, imag, { disableNormalization: true });

osc.setPeriodicWave(wave);

osc.connect(ac.destination);

osc.start();
osc.stop(2);

Это работает, потому что звук, содержащий только основной тон, по определению является синусоидой.

Здесь мы создаем PeriodicWave с двумя значениями. Первое значение — смещение по оси DC, то есть значение, с которого начинается осциллятор. Значение 0 здесь хорошо, так как оно задает кривую посередине диапазона [-1.0; 1.0]. Второе и последующие значения — синусоидальные и косинусоидальные компоненты, аналогичные результату преобразования Фурье, которое преобразует значения в области времени в значения в области частот. Здесь, с помощью createPeriodicWave(), вы указываете частоты, а браузер выполняет обратное преобразование Фурье, чтобы получить буфер в области времени для частоты осциллятора. В этом примере мы установили только один компонент с полным объёмом (1.0) на основном тоне, поэтому получаем синусоиду. Имейте в виду, что основной тон соответствует частоте осциллятора (которая по умолчанию 440 Hz). Таким образом, изменение частоты осциллятора фактически смещает частоту этой периодической волны вместе с ней.

Коэффициенты преобразования Фурье должны быть заданы в возрастающем порядке (т. е. $\left(a+bi\right)e^{i} , \left(c+di\right)e^{2i} ,\left(f+gi\right)e^{3i}$ и т. д.) и могут быть положительными или отрицательными. Простой способ вручную получить такие коэффициенты (хотя не самый лучший) — использовать графический калькулятор.

• Использование Web Audio API