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

CKTIS / JavaScript

HTMLMediaElement: `paused` a udalosti `play`, `pause`, `ended` a `error`

Rozlišujte aktuálny stav prehrávania, udalosti a výsledok volania `play()`. Naučte sa rozpoznať pozastavenie, prirodzený koniec prehrávania a chybu zdroja.

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

Syntax

media.paused
media.ended
media.error
media.play() // Promise<void>
media.pause() // undefined
media.addEventListener("play", listener)
media.addEventListener("pause", listener)
media.addEventListener("ended", listener)
media.addEventListener("error", listener)

HTMLMediaElement je rozhranie webovej platformy pre zvukové a video prvky, nie súčasť ECMAScriptu. Logická vlastnosť media.paused je iba na čítanie a spočiatku má hodnotu true. Hodnota false znamená, že prvok nie je pozastavený, ale nedokazuje, že prehrávanie postupuje: prvok môže čakať na údaje.

play() sa pokúsi spustiť alebo obnoviť prehrávanie. Vracia prísľub, ktorý sa splní pri úspešnom spustení prehrávania alebo sa pri neúspechu zamietne, napríklad s chybou NotAllowedError, keď požiadavku blokujú pravidlá automatického prehrávania. Pri zmene paused z true na false sa udalosť play zaradí do frontu. Nie je to playing, ktorá signalizuje spustenie alebo obnovenie po čakaní na údaje. pause() vracia undefined a nespôsobí ďalšiu zmenu stavu, ak je prvok už pozastavený. Udalosť pause nastane po prechode do pozastaveného stavu.

ended signalizuje koniec prehrávania, nie obyčajné pozastavenie. Pri prirodzenom konci prehrávania dopredu môže pause predchádzať udalosti ended aj bez volania pause(). Ak platí loop === true a playbackRate je nezáporné, udalosť ended nenastane. Logická vlastnosť media.ended vyjadruje stav, nie udalosť.

Tieto štyri udalosti zachytávajte priamo na prvku: nebublajú stromom DOM a nemožno ich zrušiť. Udalosť error signalizuje chybu zdroja, napríklad pri načítaní alebo dekódovaní. Skontrolujte media.error: ide o MediaError s vlastnosťou code alebo o null, ak nie je zaznamenaná žiadna chyba. Zamietnutie prísľubu z play() ošetrite samostatne; samotné zablokovanie automatického prehrávania nie je chybou zdroja.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Media playback events</title>
</head>
<body>
  <audio id="media"></audio>
  <button id="start" type="button">Run media demo</button>
  <script>
    (() => {
      // Build one second of silent, unsigned 8-bit mono PCM WAV.
      const rate = 8000;
      const wav = new Uint8Array(44 + rate);
      const view = new DataView(wav.buffer);
      const text = (offset, value) => {
        for (let i = 0; i < value.length; i++) wav[offset + i] = value.charCodeAt(i);
      };
      text(0, "RIFF");
      view.setUint32(4, wav.length - 8, 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);
      wav.fill(128, 44);

      const media = document.getElementById("media");
      const start = document.getElementById("start");
      media.addEventListener("play", () => console.log(`play: paused=${media.paused}`));
      media.addEventListener("pause", () => console.log(`pause: paused=${media.paused}`));
      media.addEventListener("ended", () => {
        console.log(`ended: ended=${media.ended}`);
        media.src = "data:text/plain,not-a-media-file";
      }, { once: true });
      media.addEventListener("error", () => console.log(`error: code=${media.error?.code}`));

      start.addEventListener("click", async () => {
        start.remove();
        console.log(`paused=${media.paused}`);
        media.src = `data:audio/wav;base64,${btoa(String.fromCharCode(...wav))}`;
        try {
          await media.play();
        } catch (error) {
          console.log(`play() rejected: ${error.name}`);
        }
      }, { once: true });
    })();
  </script>
</body>
</html>

Výsledok

paused=true
play: paused=false
pause: paused=true
ended: ended=true
error: code=4

Uložte príklad ako `media-demo.html` a otvorte ho v prehliadači. Otvorte konzolu prehliadača a kliknite na `Run media demo`. Očakávaná postupnosť predpokladá podporu PCM WAV, povolené adresy `data:` pre médiá a neprerušené prehrávanie. Po jednej sekunde ticha vyvolá prirodzený koniec udalosť `pause` pred `ended`; až potom kód nastaví zámerne neplatný zdroj. Ak sa prísľub z `play()` zamietne, skontrolujte názov chyby a neočakávajte celú postupnosť.

Súvisiace lekcie

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

Zdroje