Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

OscillatorNode — generator przebiegu okresowego

OscillatorNode generuje monofoniczny przebieg okresowy. Ustaw jego kształt i częstotliwość, połącz wyjście oraz zaplanuj start i zatrzymanie.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

new OscillatorNode(context, { type: "sine", frequency: 440, detune: 0 }); oscillator.connect(destination); oscillator.start(when); oscillator.stop(when);

OscillatorNode to źródło Web Audio API: nie ma wejść, a jego wyjście jest monofoniczne. Nie jest częścią ECMAScript.

type wybiera sine, square, sawtooth lub triangle. setPeriodicWave() ustawia własny przebieg i custom. frequency (domyślnie 440 Hz) i detune (0 centów) są obiektami AudioParam; zmieniaj ich .value lub planuj automatyzację. Wzór frequency * 2 ** (detune / 1200) daje częstotliwość po uwzględnieniu odstrojenia, ale przed ograniczeniem. Oscylator ogranicza tę wartość do przedziału od ujemnej do dodatniej częstotliwości Nyquista.

start(when) i stop(when) używają sekund osi czasu kontekstu. Węzła nie można uruchomić ponownie — utwórz nowy. Przykład renderuje offline, bez dźwięku; sprawdź dostępność API w docelowej przeglądarce.

Przykłady

(async () => {
  const context = new OfflineAudioContext(1, 4800, 48000);
  const oscillator = new OscillatorNode(context, {
    type: "sine",
    frequency: 440
  });
  oscillator.connect(context.destination);
  oscillator.start(0);
  oscillator.stop(0.1);
  const buffer = await context.startRendering();
  console.log(buffer.numberOfChannels, buffer.length);
})();

Wynik

1 4800

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła