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

CKTIS / JavaScript

Stav a čas prehrávania: paused, muted, currentTime a duration

Zisťujte stav pozastavenia a stlmenia samostatne, nastavujte pozíciu prehrávania v sekundách a rozlišujte známe trvanie od hodnôt `NaN` a `Infinity`.

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

Syntax

media.paused              // boolean, read-only
media.muted               // boolean, read/write
media.muted = true        // mute the audio output
media.currentTime         // number in seconds, read/write
media.currentTime = 12.5  // request a position on the media timeline
media.duration            // number in seconds, read-only; may be NaN or Infinity

paused, muted, currentTime a duration sú vlastnosti inštancií HTMLMediaElement dostupné na prvkoch audio a video. Patria k webovej platforme, nie k samotnému ECMAScriptu. V prostredí bez DOM preto s nimi nepočítajte.

paused je booleovská hodnota iba na čítanie. Pre nový prvok platí paused === true. Namiesto priraďovania do paused volajte pause() a play(). Prísľub vrátený metódou play() môže byť zamietnutý, napríklad ak prehliadač blokuje automatické prehrávanie. paused === false samo osebe neznamená, že pozícia napreduje: prvok môže čakať na údaje.

muted je booleovská hodnota na čítanie aj zápis, ktorá udáva aktuálny stav stlmenia zvuku. media.muted = true stlmí zvukový výstup; false stlmenie vypne. Stlmenie nie je to isté ako pozastavenie ani nastavenie volume na nulu. defaultMuted odráža atribút HTML muted, ktorý určuje predvolený, nie aktuálny stav stlmenia.

currentTime vracia pozíciu prehrávania na časovej osi média v sekundách vrátane zlomkov sekundy. Pred načítaním metadát priradenie uloží požadovanú počiatočnú pozíciu; po ich načítaní spustí presun na inú pozíciu. NaN a nekonečné hodnoty vyvolajú TypeError. Skutočná pozícia sa môže líšiť od požadovanej: skontrolujte rozsahy seekable, najmä pri živých prenosoch, a dokončenie presunu zistite pomocou udalosti seeked.

duration je iba na čítanie. Konečná hodnota je čas konca na osi média v sekundách, čiže trvanie, ak sa os začína nulou. NaN znamená, že trvanie zatiaľ nie je k dispozícii; Infinity znamená, že médium nemá známy koniec. Hodnotu načítajte pri loadedmetadata a aktualizujte pri durationchange. Na osi začínajúcej nulou počítajte currentTime / duration, len ak platí Number.isFinite(duration) && duration > 0.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Media playback state and time</title>
</head>
<body>
  <script>
    const media = document.createElement("video");
    console.log(`currentTime=${media.currentTime}`);

    media.muted = true;
    media.currentTime = 2.5;

    console.log(
      `paused=${media.paused}, muted=${media.muted}, ` +
      `currentTime=${media.currentTime}, duration=${media.duration}`
    );
  </script>
</body>
</html>

Výsledok

currentTime=0
paused=true, muted=true, currentTime=2.5, duration=NaN

Uložte príklad ako súbor HTML, otvorte ho v prehliadači a skontrolujte výstup v konzole. Prvok nemá zdroj: `2.5` je uložená počiatočná pozícia, nie výsledok presunu ani prehrávania. Prvok zostáva pozastavený a `duration` zostáva `NaN`.

Súvisiace lekcie

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

Zdroje