CKTIS / JavaScript
AudioContext: анализ и възпроизвеждане на звук от медиен елемент
Насочи звука от елемент audio или video към изхода през анализатор и управлявай аудиографа отделно от възпроизвеждането на медията.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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;Извиквай методите върху инстанция на AudioContext, а не върху конструктора. Инстанцията наследява createAnalyser(), state и destination от BaseAudioContext. Методът createAnalyser() не приема аргументи и връща AnalyserNode, който предоставя формата на вълната и спектъра, без да променя преминаващия сигнал. За пробите от формата на вълната използвай Uint8Array с дължина fftSize; frequencyBinCount е броят на честотните интервали и е равен на половината от fftSize.
createMediaElementSource(element) приема съществуващ HTMLMediaElement (audio или video), а не URL. Връща MediaElementAudioSourceNode и пренасочва звука на елемента към графа. Свържи източника с анализатора, а него — с ctx.destination: това свойство само за четене връща AudioDestinationNode, крайния изход на контекста в реално време. Анализаторът може да измерва и без връзка на изхода си, но тогава този път не се чува. Използвай отново същия възел източник: повторното обвързване на същия елемент предизвиква InvalidStateError, а разкачването на възела не премахва обвързването.
resume() не приема аргументи и възобновява часовника и обработката на графа, а не възпроизвеждането на елемента. Връща Promise, който се изпълнява при възобновяване на контекста и се отхвърля, ако той е затворен. OfflineAudioContext.resume() е отделен метод за възобновяване на рендирането извън реално време. В обработчика на действително щракване извикай resume() и element.play() преди първото await; обработи отхвърлянията, например NotAllowedError от play(). За пауза на медията използвай element.pause().
Свойството state е само за четене и описва контекста: running означава, че графът обработва звук, suspended е пауза (включително поради правилата за автоматично възпроизвеждане), closed е окончателно състояние, а interrupted означава външно прекъсване, което браузърите обработват различно. Следи statechange; running не гарантира чуваем звук. Възелът източник извежда тишина за медия, заредена от друг произход без разрешение чрез CORS. За публичен файл от друг произход задай element.crossOrigin = 'anonymous' преди src и настрой CORS заглавките на сървъра. Това са API на уеб платформата, а не част от ECMAScript 2024; поддръжката зависи от средата. Когато контекстът вече не ти трябва, close() освобождава системните му аудиоресурси.
Примери
<!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>Резултат
state=running; samples=1024
Запази примера като `index.html` и го отвори в браузър през локален HTTP сървър. Отвори конзолата за разработчици и щракни върху `Play and analyse` на страницата. Ако Web Audio и PCM WAV се поддържат, възпроизвеждането е разрешено и няма прекъсване, очаквай кратък тон и `state=running; samples=1024`. WAV се създава локално. Числото е дължината на масива, а не броят на ненулевите проби. Презареди страницата, за да повториш.
Свързани уроци
- JavaScript · Урок 34 · Напреднало · Версия: 4
Източници
- 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