CKTIS / JavaScript
AudioContext: geluid van een media-element analyseren en afspelen
Leid het geluid van een audio- of video-element via een analysator naar de uitvoer en regel de audiograaf los van het afspelen van de media.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const ctx = new AudioContext();
const analyser = ctx.createAnalyser();
const source = ctx.createMediaElementSource(mediaElement); // HTMLMediaElement
source.connect(analyser);
analyser.connect(ctx.destination);
// In an async handler for a user action:
await Promise.all([ctx.resume(), mediaElement.play()]);
const state = ctx.state;Roep de methoden aan op een instantie van AudioContext, niet op de constructor. De instantie erft createAnalyser(), state en destination van BaseAudioContext. createAnalyser() neemt geen argumenten en retourneert een AnalyserNode die golfvorm en spectrum beschikbaar maakt zonder het doorgelaten signaal te wijzigen. Gebruik voor golfvormsamples een Uint8Array met lengte fftSize; frequencyBinCount is het aantal frequentiebanden en is de helft van fftSize.
createMediaElementSource(element) verwacht een bestaand HTMLMediaElement (audio of video), geen URL. De methode retourneert een MediaElementAudioSourceNode en leidt het geluid van het element om naar de graaf. Verbind de bron met de analysator en de analysator met ctx.destination: deze alleen-lezen eigenschap geeft de AudioDestinationNode, de einduitvoer van de realtimecontext. Een analysator kan ook zonder uitgangsverbinding meten, maar die route is dan niet hoorbaar. Hergebruik het bronknooppunt: hetzelfde element opnieuw koppelen veroorzaakt InvalidStateError, en het loskoppelen van het knooppunt heft de koppeling met het element niet op.
resume() neemt geen argumenten en hervat de klok en de verwerking van de graaf, niet het afspelen van het element. De geretourneerde Promise wordt vervuld zodra de context wordt hervat en afgewezen als deze gesloten is. OfflineAudioContext.resume() is een aparte methode om offline rendering te hervatten. Roep in de handler van een echte klik zowel resume() als element.play() aan vóór de eerste await; handel afwijzingen zoals NotAllowedError van play() af. Pauzeer de media met element.pause().
De alleen-lezen eigenschap state beschrijft de context: running betekent dat de graaf actief is, suspended dat deze gepauzeerd is (ook door autoplaybeleid), closed is definitief en interrupted duidt op een externe onderbreking die per browser anders wordt afgehandeld. Volg statechange; running garandeert geen hoorbaar geluid. Het bronknooppunt geeft stilte voor media die zonder CORS-toestemming vanaf een andere origin zijn geladen. Stel voor een openbaar bestand van een andere origin element.crossOrigin = 'anonymous' vóór src in en configureer de CORS-headers van de server. Dit zijn webplatform-API’s, geen onderdelen van ECMAScript 2024; de ondersteuning verschilt per runtime. Wanneer je de context niet meer nodig hebt, geeft close() de audioresources van het systeem vrij.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Play and analyse</title>
</head>
<body>
<button id="play" type="button">Play and analyse</button>
<script>
(() => {
function makeTone() {
const rate = 8000;
const wav = new Uint8Array(44 + rate);
const view = new DataView(wav.buffer);
const text = (offset, value) => wav.set(new TextEncoder().encode(value), offset);
// One second of mono, unsigned 8-bit PCM in a WAV container.
text(0, 'RIFF');
view.setUint32(4, 36 + rate, true);
text(8, 'WAVEfmt ');
view.setUint32(16, 16, true);
view.setUint16(20, 1, true);
view.setUint16(22, 1, true);
view.setUint32(24, rate, true);
view.setUint32(28, rate, true);
view.setUint16(32, 1, true);
view.setUint16(34, 8, true);
text(36, 'data');
view.setUint32(40, rate, true);
for (let i = 0; i < rate; i++) {
wav[44 + i] = 128 + Math.round(12 * Math.sin(2 * Math.PI * 440 * i / rate));
}
return new Blob([wav], { type: 'audio/wav' });
}
const button = document.getElementById('play');
button.addEventListener('click', async () => {
button.disabled = true;
const media = new Audio();
let ctx;
let url;
try {
ctx = new AudioContext();
const analyser = ctx.createAnalyser();
analyser.fftSize = 1024;
const source = ctx.createMediaElementSource(media);
source.connect(analyser);
analyser.connect(ctx.destination);
const finished = new Promise((resolve) => {
media.onended = () => resolve(true);
media.onerror = () => resolve(false);
});
url = URL.createObjectURL(makeTone());
media.src = url;
await Promise.all([ctx.resume(), media.play()]);
const samples = new Uint8Array(analyser.fftSize);
analyser.getByteTimeDomainData(samples);
console.log(`state=${ctx.state}; samples=${samples.length}`);
if (!(await finished)) throw new Error('Media failed during playback');
} catch (error) {
console.error(error);
} finally {
media.pause();
media.removeAttribute('src');
media.load();
if (url !== undefined) URL.revokeObjectURL(url);
if (ctx && ctx.state !== 'closed') {
await ctx.close().catch((error) => console.error(error));
}
}
}, { once: true });
})();
</script>
</body>
</html>Resultaat
state=running; samples=1024
Sla het voorbeeld op als `index.html` en open het in de browser via een lokale HTTP-server. Open de ontwikkelaarsconsole en klik op de pagina op `Play and analyse`. Als Web Audio en PCM-WAV worden ondersteund, afspelen is toegestaan en er geen onderbreking is, verwacht je een korte toon en `state=running; samples=1024`. De WAV wordt lokaal gegenereerd. Het getal is de arraylengte, niet het aantal samples dat ongelijk is aan nul. Herlaad de pagina om het te herhalen.
Gerelateerde lessen
- JavaScript · Les 34 · Gevorderd · Versie: 4
Bronnen
- BaseAudioContext: createAnalyser() method
- AudioContext: createMediaElementSource() method
- AudioContext: resume() method
- BaseAudioContext: state property
- BaseAudioContext: destination property
- AnalyserNode
- AnalyserNode: getByteTimeDomainData() method
- OfflineAudioContext: resume() method
- AudioContext: close() method
- Using the Web Audio API
- HTML Living Standard — Media elements: play()
- ECMAScript 2024 Language Specification — Promise.all