CKTIS / JavaScript
OscillatorNode — generatore di forme d’onda periodiche
OscillatorNode genera una forma d’onda periodica mono. Configurane la forma e la frequenza, collega l’uscita e pianifica avvio e arresto.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new OscillatorNode(context, { type: "sine", frequency: 440, detune: 0 }); oscillator.connect(destination); oscillator.start(when); oscillator.stop(when);OscillatorNode è una sorgente della Web Audio API: non ha ingressi e ha un’uscita mono. Non fa parte di ECMAScript.
type consente di scegliere sine, square, sawtooth o triangle. setPeriodicWave() imposta una forma d’onda personalizzata e custom. frequency (440 Hz per impostazione predefinita) e detune (0 cent) sono oggetti AudioParam; modifica il loro .value oppure pianifica l’automazione. La formula frequency * 2 ** (detune / 1200) calcola la frequenza tenendo conto della scordatura, prima di applicare i limiti. L’oscillatore limita questo valore all’intervallo tra la frequenza di Nyquist negativa e quella positiva.
start(when) e stop(when) usano i secondi sulla linea temporale del contesto. Un nodo non può essere riavviato: creane un altro. L’esempio esegue il rendering offline, senza suono; verifica che l’API sia disponibile nel browser di destinazione.
Esempi
(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);
})();Risultato
1 4800
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.