Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

AudioContext: analýza a prehrávanie zvuku z multimediálneho prvku

Presmeruj zvuk z prvku audio alebo video cez analyzátor na výstup a odlíš spracovanie v grafe Web Audio od prehrávania samotného média.

Verzia: 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;

Metódy volaj na inštancii AudioContext, nie na konštruktore. Inštancia dedí createAnalyser(), state a destination z BaseAudioContext. createAnalyser() bez argumentov vráti AnalyserNode, ktorý sprístupňuje časový priebeh a spektrum bez zmeny prechádzajúceho signálu. Pre vzorky časového priebehu použi Uint8Array s dĺžkou fftSize; frequencyBinCount je počet pásiem spektra a rovná sa polovici fftSize.

createMediaElementSource(element) prijíma existujúci HTMLMediaElement (audio alebo video), nie URL. Vráti MediaElementAudioSourceNode a presmeruje zvuk prvku do grafu. Pripoj zdroj k analyzátoru a analyzátor k ctx.destination: táto vlastnosť len na čítanie poskytuje AudioDestinationNode, konečný výstup kontextu v reálnom čase. Analyzátor môže merať aj bez pripojeného výstupu, no táto cesta potom nie je počuteľná. Používaj ten istý zdrojový uzol: opätovné priradenie toho istého prvku vyvolá InvalidStateError a odpojením uzla sa priradenie nezruší.

resume() bez argumentov obnoví chod hodín a spracovanie grafu, nie prehrávanie prvku. Vráti Promise, ktorý sa splní po obnovení kontextu a bude zamietnutý, ak je kontext zatvorený. OfflineAudioContext.resume() je samostatná metóda na obnovenie offline vykresľovania zvuku. V obsluhe skutočného kliknutia zavolaj resume() aj element.play() pred prvým await; ošetri zamietnutia, napríklad NotAllowedError z play(). Na pozastavenie média použi element.pause().

Vlastnosť state je len na čítanie a opisuje kontext: running znamená, že graf spracúva zvuk, suspended označuje pozastavenie (aj v dôsledku pravidiel automatického prehrávania), closed je trvalý stav a interrupted označuje vonkajšie prerušenie, ktoré prehliadače riešia rôzne. Sleduj statechange; running nezaručuje počuteľný zvuk. Zdrojový uzol vydáva ticho pri médiu načítanom z iného pôvodu bez povolenia CORS. Pre verejný súbor z iného pôvodu nastav element.crossOrigin = 'anonymous' pred src a nakonfiguruj hlavičky CORS na serveri. Sú to API webovej platformy, nie súčasti ECMAScriptu 2024; podpora závisí od prostredia. Keď kontext už nepotrebuješ, close() uvoľní jeho systémové zvukové prostriedky.

Príklady

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

Výsledok

state=running; samples=1024

Ulož príklad ako `index.html` a otvor ho v prehliadači cez lokálny server HTTP. Otvor vývojársku konzolu a na stránke klikni na `Play and analyse`. Ak prehliadač podporuje Web Audio a PCM WAV, prehrávanie je povolené a nič ho nepreruší, očakávaj krátky tón a `state=running; samples=1024`. WAV sa vytvorí lokálne. Číslo je dĺžka poľa, nie počet nenulových vzoriek. Pokus zopakuješ obnovením stránky.

Súvisiace lekcie

  • JavaScript · Lekcia 34 · Pokročilá · Verzia: 4

Zdroje