Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

AudioContext — un grafo di elaborazione audio

AudioContext gestisce un grafo audio in tempo reale. Collega sorgenti, analisi e uscita; per avviare l’elaborazione potrebbe essere necessaria un’interazione dell’utente.

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

const context = new AudioContext();
const analyser = context.createAnalyser();
const source = context.createMediaElementSource(mediaElement);
source.connect(analyser);
analyser.connect(context.destination);
await context.resume();
console.log(context.state);

AudioContext è un’API del browser, non fa parte di ECMAScript. Se context è un’istanza di AudioContext, la chiamata context.createAnalyser() crea un analizzatore. Il metodo di istanza createAnalyser() e le proprietà di istanza state e destination sono ereditati da BaseAudioContext. context.destination è l’uscita finale del grafo.

La chiamata context.createMediaElementSource(mediaElement) su un’istanza di AudioContext reindirizza l’audio di un elemento multimediale nel grafo. Conserva la sorgente creata: associare di nuovo lo stesso elemento è un errore. Le risorse di altre origini senza un’autorizzazione CORS adeguata producono silenzio.

Dopo un’interazione dell’utente, chiama resume() sull’istanza di AudioContext (ad esempio, context.resume()) e attendi che la promise restituita si risolva. La proprietà state indica lo stato del contesto. resume() non avvia la riproduzione dell’elemento multimediale. Al termine, usa close(). L’esempio analizza intenzionalmente il silenzio. Verifica la disponibilità dell’API nel browser di destinazione; Node 24 non la dimostra.

Esempi

const button = document.createElement('button');
button.textContent = 'Run';
document.body.append(button);

button.onclick = async () => {
  button.disabled = true;
  let context;
  try {
    context = new AudioContext();
    const media = new Audio();
    const source = context.createMediaElementSource(media);
    const analyser = context.createAnalyser();
    source.connect(analyser);
    analyser.connect(context.destination);
    await context.resume();
    const samples = new Float32Array(analyser.fftSize);
    analyser.getFloatTimeDomainData(samples);
    console.log(context.state);
    console.log(samples.every(value => value === 0));
  } catch (error) {
    console.error(error);
  } finally {
    if (context) await context.close();
    button.disabled = false;
  }
};

Risultato

running
true

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.

Fonti