Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Události rozhraní HTMLMediaElement

Pomocí devíti událostí zvuku a videa udržuj pozici, délku a ovládací prvky v souladu se stavem přehrávače a rozpoznávej reset, konec přehrávání nebo chybu.

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

Syntaxe

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

HTMLMediaElement je rozhraní prohlížeče společné prvkům audio a video, nikoli součást ECMAScriptu. Pomocí addEventListener() registruj posluchače přímo na mediálním prvku, ideálně před nastavením src: tyto události nebublají k nadřazeným prvkům a nelze je zrušit. V obsluze čti aktuální stav prvku, místo abys ho odvozoval z pořadí událostí.

loadedmetadata znamená, že jsou dostupná metadata, například rozměry videa, nikoli že je vše připraveno k přehrávání. durationchange oznamuje nově zjištěnou nebo upravenou délku: duration je v sekundách, při nedostupných datech má hodnotu NaN a při neohraničeném konci Infinity. emptied znamená, že se stav zdroje resetoval, například při opětovném načtení. Vymaž z rozhraní staré údaje o médiu; samotný reset nemusí vyvolat durationchange.

Při timeupdate čti currentTime v sekundách a aktualizuj ukazatel pozice. Událost může nastat při přehrávání nebo přesunu na jinou pozici; není to časovač s pevnou frekvencí ani signál pro každý snímek. play znamená, že se paused změnilo na false, ne že přehrávání skutečně začalo (playing). pause signalizuje přechod do pozastaveného stavu, ne dočasný nedostatek dat. Při volumechange čti volume i muted: vyvolat ji může změna kterékoli z těchto hodnot.

ended signalizuje dosažení konce, ne běžné pozastavení, ačkoli na konci může nastat také pause. Když je loop nastaveno na true a playbackRate není záporné, ended nenastane. Při error zkontroluj media.error, například media.error?.code; tento MediaError se týká mediálního zdroje. Zamítnutí příslibu z play() ošetři zvlášť: například NotAllowedError může vyplynout z pravidel automatického přehrávání, aniž by vyvolal mediální událost error.

Pří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ýsledek

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ázku jako soubor HTML a otevři ji v prohlížeči, který podporuje PCM WAV a povoluje média z adres `blob:`. Události sleduj ve vývojářské konzoli. Pro přehrávání a pozastavení použij vestavěné ovládací prvky. Ukázka vytvoří tři sekundy ticha bez stahování souboru; načasování i počet událostí se mohou lišit. `Remove demo` odstraní ovládací prvky a uvolní objektové adresy URL.

Související lekce

  • JavaScript · Lekce 28 · Středně pokročilá · Verze: 3

Zdroje