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

CKTIS / JavaScript

Stav a čas přehrávání: paused, muted, currentTime a duration

Zjišťujte stav pozastavení a ztlumení odděleně, nastavujte pozici přehrávání v sekundách a rozlišujte známou dobu trvání od hodnot `NaN` a `Infinity`.

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

Syntaxe

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 jsou vlastnosti instancí HTMLMediaElement, které jsou dostupné na prvcích audio a video. Patří k webové platformě, nikoli k samotnému ECMAScriptu. V prostředí bez DOM s nimi proto nepočítejte.

paused je logická hodnota pouze pro čtení. Nový prvek má paused === true. Místo přiřazování do paused volejte pause() a play(). Příslib vrácený metodou play() může být zamítnut, například pokud prohlížeč blokuje automatické přehrávání. paused === false samo o sobě neznamená, že se pozice posouvá: prvek může čekat na data.

muted je logická hodnota pro čtení i zápis, která udává aktuální stav ztlumení. media.muted = true ztlumí zvukový výstup; false ztlumení vypne. Ztlumení není totéž jako pozastavení nebo nastavení volume na nulu. defaultMuted odráží atribut HTML muted, který určuje výchozí, nikoli aktuální stav ztlumení.

currentTime vrací pozici přehrávání na časové ose média v sekundách včetně zlomků sekund. Před načtením metadat přiřazení uloží požadovanou počáteční pozici; po jejich načtení zahájí skok na jinou pozici. NaN a nekonečné hodnoty vyvolají TypeError. Skutečná pozice se může od požadované lišit: zkontrolujte rozsahy seekable, zejména u živých přenosů, a dokončení skoku zjistěte pomocí události seeked.

duration je pouze pro čtení. Konečná hodnota je koncový čas na časové ose média v sekundách, tedy délka, pokud osa začíná na nule. NaN znamená, že doba trvání zatím není dostupná; Infinity znamená, že médium nemá známý konec. Hodnotu načtěte při loadedmetadata a aktualizujte při durationchange. Na ose začínající nulou počítejte currentTime / duration, jen pokud platí Number.isFinite(duration) && duration > 0.

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

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

Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a zkontrolujte výstup v konzoli. Prvek nemá zdroj: `2.5` je uložená počáteční pozice, nikoli výsledek skoku nebo přehrávání. Prvek zůstává pozastavený a `duration` zůstává `NaN`.

Související lekce

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

Zdroje