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

CKTIS / JavaScript

Udalosti rozhrania HTMLMediaElement

Pomocou deviatich udalostí zvuku a videa synchronizuj pozíciu, trvanie a ovládacie prvky a rozpoznaj obnovenie stavu zdroja, koniec prehrávania alebo chybu.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

media.addEventListener(type, (event) => { /* read event.currentTarget here */ });
// type: "timeupdate" | "loadedmetadata" | "durationchange" | "emptied"
//     | "play" | "pause" | "volumechange" | "ended" | "error"

HTMLMediaElement je rozhranie prehliadača spoločné pre prvky audio a video, nie súčasť ECMAScriptu. Pomocou addEventListener() pridaj poslucháče priamo na mediálny prvok, najlepšie pred nastavením src: tieto udalosti neprebublávajú k nadradeným prvkom a nemožno ich zrušiť. V obsluhe čítaj aktuálny stav prvku namiesto toho, aby si ho odvodzoval z poradia udalostí.

loadedmetadata znamená, že sú dostupné metadáta, napríklad rozmery videa, nie že je všetko pripravené na prehrávanie. durationchange oznamuje novo zistené alebo upravené trvanie: duration je v sekundách, pri chýbajúcich dátach má hodnotu NaN a pri neohraničenom konci Infinity. emptied znamená, že stav zdroja bol vynulovaný, napríklad pri opätovnom načítaní. Odstráň z rozhrania staré údaje o médiu; samotné vynulovanie nemusí vyvolať durationchange.

Pri timeupdate čítaj currentTime v sekundách a aktualizuj ukazovateľ pozície. Udalosť môže nastať pri prehrávaní alebo pri presune na inú pozíciu; nie je to časovač s pevnou frekvenciou ani signál pre každú snímku. play znamená, že paused sa zmenilo na false, nie že sa prehrávanie už začalo (playing). pause oznamuje prechod do stavu pozastavenia, nie dočasný nedostatok dát. Pri volumechange čítaj volume aj muted: zmena ktorejkoľvek hodnoty môže vyvolať udalosť.

ended oznamuje dosiahnutie konca, nie obyčajné pozastavenie, hoci na konci sa môže vyskytnúť aj pause. Ak je loop nastavené na true a playbackRate nie je záporné, ended nenastane. Pri error skontroluj media.error, napríklad media.error?.code; tento MediaError sa týka mediálneho zdroja. Zamietnutie prísľubu z play() spracuj samostatne: napríklad NotAllowedError môže vyplývať z pravidiel automatického prehrávania bez vyvolania mediálnej udalosti error.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLMediaElement events</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement('div');
  const audio = document.createElement('audio');
  audio.controls = true;
  audio.preload = 'metadata';
  panel.append(audio);

  // Generate three seconds of silence as mono, 8-bit PCM WAV.
  const rate = 8000;
  const samples = 3 * rate;
  const bytes = new Uint8Array(44 + samples);
  const view = new DataView(bytes.buffer);
  const tag = (offset, text) => bytes.set(new TextEncoder().encode(text), offset);
  const u16 = (offset, value) => view.setUint16(offset, value, true);
  const u32 = (offset, value) => view.setUint32(offset, value, true);
  tag(0, 'RIFF'); u32(4, 36 + samples); tag(8, 'WAVE');
  tag(12, 'fmt '); u32(16, 16); u16(20, 1); u16(22, 1);
  u32(24, rate); u32(28, rate); u16(32, 1); u16(34, 8);
  tag(36, 'data'); u32(40, samples); bytes.fill(128, 44);
  const wav = URL.createObjectURL(new Blob([bytes], { type: 'audio/wav' }));
  const bad = URL.createObjectURL(new Blob(['not audio'], { type: 'audio/wav' }));

  const listeners = new AbortController();
  const types = ['timeupdate', 'loadedmetadata', 'durationchange', 'emptied',
    'play', 'pause', 'volumechange', 'ended', 'error'];
  for (const type of types) {
    audio.addEventListener(type, ({ currentTarget: media }) => {
      console.log(type, {
        currentTime: media.currentTime, duration: media.duration,
        paused: media.paused, ended: media.ended,
        volume: media.volume, muted: media.muted,
        errorCode: media.error?.code ?? null
      });
    }, { signal: listeners.signal });
  }

  function button(label, action) {
    const control = document.createElement('button');
    control.type = 'button';
    control.textContent = label;
    control.addEventListener('click', action);
    panel.append(control);
  }
  button('Mute / unmute', () => { audio.muted = !audio.muted; });
  button('Reload', () => { audio.src = wav; });
  button('Load invalid audio', () => { audio.src = bad; });
  button('Remove demo', () => {
    listeners.abort();
    audio.removeAttribute('src');
    audio.load();
    panel.remove();
    URL.revokeObjectURL(wav);
    URL.revokeObjectURL(bad);
  });
  document.body.prepend(panel);
  audio.src = wav;
})();
</script>
</body>
</html>

Výsledok

Expected observations, not a fixed transcript (each event name is logged with a state object):
- Initial load: durationchange and loadedmetadata; duration is 3 seconds at loadedmetadata.
- Play, pause, resume, and let the clip finish: play, timeupdate (repeated), pause, play again, and eventually ended. A pause event can also occur at the end.
- Mute / unmute: volumechange; muted toggles.
- Reload after metadata is available: emptied, then fresh durationchange and loadedmetadata.
- Load invalid audio: error with a non-null errorCode; emptied can appear first.

Ulož ukážku ako súbor HTML a otvor ju v prehliadači, ktorý podporuje PCM WAV a povoľuje médiá z adries `blob:`. Udalosti sleduj vo vývojárskej konzole. Na prehrávanie a pozastavenie použi vstavané ovládacie prvky. Ukážka vytvorí tri sekundy ticha bez sťahovania súboru; načasovanie a počet udalostí sa môžu líšiť. `Remove demo` odstráni ovládacie prvky a uvoľní objektové adresy URL.

Súvisiace lekcie

  • JavaScript · Lekcia 28 · Stredne pokročilá · Verzia: 3

Zdroje