CKTIS / JavaScript
AudioContext : analyser et restituer le son d’un élément multimédia
Acheminez le son d’un élément audio ou vidéo vers la sortie via un analyseur, et distinguez le traitement du graphe de la lecture du média.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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;Appelez les méthodes sur une instance d’AudioContext, pas sur le constructeur. Elle hérite de createAnalyser(), state et destination depuis BaseAudioContext. Sans argument, createAnalyser() renvoie un AnalyserNode qui fournit la forme d’onde et le spectre sans modifier le signal transmis. Pour les échantillons de la forme d’onde, utilisez un Uint8Array de longueur fftSize ; frequencyBinCount compte les cases du spectre et vaut la moitié de fftSize.
createMediaElementSource(element) accepte un HTMLMediaElement existant (audio ou video), pas une URL. La méthode renvoie un MediaElementAudioSourceNode et redirige le son de l’élément vers le graphe. Reliez la source à l’analyseur, puis l’analyseur à ctx.destination : cette propriété en lecture seule donne l’AudioDestinationNode, la sortie finale du contexte temps réel. L’analyseur peut mesurer le signal sans connexion en sortie, mais ce chemin est alors inaudible. Réutilisez le nœud source : associer de nouveau le même élément déclenche InvalidStateError, et déconnecter le nœud ne supprime pas l’association.
Sans argument, resume() relance l’horloge et le traitement du graphe, pas la lecture de l’élément. La méthode renvoie une Promise qui se résout à la reprise du contexte et est rejetée si celui-ci est fermé. OfflineAudioContext.resume() est une méthode distincte pour reprendre un rendu hors ligne. Dans le gestionnaire d’un véritable clic, appelez resume() et element.play() avant le premier await ; gérez les rejets tels que NotAllowedError de play(). Utilisez element.pause() pour mettre le média en pause.
La propriété state, en lecture seule, décrit le contexte : running indique que le graphe traite le signal, suspended qu’il est en pause (notamment en raison des règles de lecture automatique), closed est définitif et interrupted signale une interruption externe dont la gestion varie selon le navigateur. Surveillez statechange ; running ne garantit pas un son audible. Le nœud source produit du silence pour un média d’une autre origine chargé sans autorisation CORS. Pour un fichier public d’une autre origine, définissez element.crossOrigin = 'anonymous' avant src et configurez les en-têtes CORS du serveur. Ces API appartiennent à la plateforme web, pas à ECMAScript 2024 ; leur prise en charge varie selon l’environnement. Quand le contexte n’est plus nécessaire, close() libère ses ressources audio système.
Exemples
<!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>Résultat
state=running; samples=1024
Enregistrez l’exemple sous `index.html` et ouvrez-le dans un navigateur via un serveur HTTP local. Ouvrez la console de développement, puis cliquez sur `Play and analyse` dans la page. Si Web Audio et le WAV PCM sont pris en charge, que la lecture est autorisée et qu’il n’y a pas d’interruption, attendez-vous à un son bref et à `state=running; samples=1024`. Le WAV est généré localement. Le nombre indique la longueur du tableau, pas le nombre d’échantillons non nuls. Rechargez la page pour recommencer.
Leçons associées
- JavaScript · Leçon 34 · Avancé · Version : 4
Sources
- 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