База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

AudioContext — граф за обработка на звук

AudioContext управлява аудиограф в реално време. Свързва източници, анализ и изход; стартирането на обработката може да изисква взаимодействие с потребителя.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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 е API на браузъра, а не част от ECMAScript. Ако context е екземпляр на AudioContext, извикването на context.createAnalyser() създава анализатор. Методът на екземпляра createAnalyser() и свойствата му state и destination се наследяват от BaseAudioContext. context.destination е крайният изход на графа.

Извикването на context.createMediaElementSource(mediaElement) върху екземпляр на AudioContext пренасочва звука на мултимедиен елемент към графа. Запазете създадения източник: повторното свързване на същия елемент е грешка. Ресурси от друг произход без подходящо разрешение за CORS произвеждат тишина.

След взаимодействие с потребителя извикайте метода resume() на екземпляра на AudioContext (например context.resume()) и изчакайте върнатото обещание да се изпълни. Свойството state показва състоянието на контекста. resume() не стартира възпроизвеждането на мултимедийния елемент. Когато приключите, използвайте close(). Примерът умишлено анализира тишина. Проверете дали API е наличен в целевия браузър; Node 24 не потвърждава това.

Примери

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;
  }
};

Резултат

running
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници