Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

AudioContext: analiza in predvajanje zvoka iz predstavnostnega elementa

Preusmeri zvok elementa audio ali video prek analizatorja na izhod ter loči obdelavo v zvočnem grafu od predvajanja same predstavnosti.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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;

Metode kliči na primerku AudioContext, ne na konstruktorju. Primerek podeduje createAnalyser(), state in destination od BaseAudioContext. createAnalyser() brez argumentov vrne AnalyserNode, ki omogoča dostop do oblike vala in spektra, ne da bi spremenil signal, ki teče skozenj. Za vzorce oblike vala uporabi Uint8Array dolžine fftSize; frequencyBinCount je število frekvenčnih razredov in je polovica fftSize.

createMediaElementSource(element) sprejme obstoječi HTMLMediaElement (audio ali video), ne naslova URL. Vrne MediaElementAudioSourceNode in zvok elementa preusmeri v graf. Poveži vir z analizatorjem, tega pa z ctx.destination: ta lastnost samo za branje vrne AudioDestinationNode, končni izhod konteksta za sprotno obdelavo. Analizator lahko meri tudi, če njegov izhod ni povezan, vendar zvok na tej poti tedaj ni slišen. Znova uporabi isto izvorno vozlišče: ponovna vezava istega elementa sproži InvalidStateError, odklop vozlišča pa vezave ne razveljavi.

resume() brez argumentov ponovno zažene uro in obdelavo grafa, ne predvajanja elementa. Vrne Promise, ki se izpolni, ko se kontekst nadaljuje, in je zavrnjena, če je zaprt. OfflineAudioContext.resume() je ločena metoda za nadaljevanje obdelave zvoka brez sprotnega predvajanja. V obravnavalniku dejanskega klika pokliči resume() in element.play() pred prvim await; obravnavaj zavrnitve, na primer NotAllowedError iz play(). Za premor predvajanja uporabi element.pause().

Lastnost state je samo za branje in opisuje kontekst: running pomeni, da graf obdeluje zvok, suspended pomeni premor (tudi zaradi pravil samodejnega predvajanja), closed je dokončno stanje, interrupted pa označuje zunanjo prekinitev, ki jo brskalniki obravnavajo različno. Spremljaj statechange; running ne zagotavlja slišnega zvoka. Če se predstavnost naloži iz drugega izvora brez dovoljenja CORS, izvorno vozlišče oddaja tišino. Pri javni datoteki iz drugega izvora nastavi element.crossOrigin = 'anonymous' pred src in na strežniku nastavi glave CORS. To so API-ji spletne platforme, ne del ECMAScripta 2024; podpora se razlikuje glede na izvajalno okolje. Ko konteksta ne potrebuješ več, close() sprosti njegove sistemske zvočne vire.

Primeri

<!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>

Rezultat

state=running; samples=1024

Shrani primer kot `index.html` in ga odpri v brskalniku prek lokalnega strežnika HTTP. Odpri razvijalsko konzolo in na strani klikni `Play and analyse`. Če sta Web Audio in PCM WAV podprta, predvajanje je dovoljeno in ni prekinitve, pričakuj kratek ton in `state=running; samples=1024`. WAV se ustvari lokalno. Število je dolžina polja in ne število neničelnih vzorcev. Za ponovitev znova naloži stran.

Povezane lekcije

  • JavaScript · Lekcija 34 · Napredna · Različica: 4

Viri