Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Stanje in čas predvajanja: paused, muted, currentTime in duration

Ločeno preverjajte stanje premora in utišanja, nastavite položaj predvajanja v sekundah ter ločite znano trajanje od vrednosti `NaN` in `Infinity`.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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 in duration so lastnosti primerkov HTMLMediaElement, ki so na voljo pri elementih audio in video. Spadajo v spletno platformo, ne v sam ECMAScript, zato ne predpostavljajte, da so na voljo v okolju brez DOM-a.

paused je logična vrednost samo za branje. Za nov element velja paused === true. Namesto prirejanja vrednosti lastnosti paused pokličite pause() ali play(). Obljuba, ki jo vrne play(), je lahko zavrnjena, na primer če brskalnik blokira samodejno predvajanje. paused === false še ne pomeni, da se položaj premika: element lahko čaka na podatke.

muted je logična vrednost za branje in pisanje, ki označuje trenutno stanje utišanja zvoka. media.muted = true utiša zvočni izhod, false pa izklopi utišanje. Utišanje ni isto kot premor ali nastavitev volume na nič. defaultMuted odraža atribut HTML muted, ki določa privzeto in ne trenutnega stanja utišanja.

currentTime vrne položaj predvajanja na časovnici medija v sekundah, tudi v delih sekunde. Preden so metapodatki na voljo, prireditev shrani zahtevani začetni položaj; pozneje sproži premik na drug položaj. NaN in neskončne vrednosti sprožijo TypeError. Dejanski položaj se lahko razlikuje od zahtevanega: preverite razpone seekable, zlasti pri prenosih v živo, in uporabite seeked, da zaznate konec premika.

duration je samo za branje. Končna številska vrednost je čas konca na časovnici medija v sekundah, torej trajanje, če se časovnica začne pri nič. NaN pomeni, da trajanje še ni na voljo; Infinity pomeni, da medij nima znanega konca. Vrednost preberite ob loadedmetadata in jo osvežite ob durationchange. Na časovnici, ki se začne pri nič, izračunajte currentTime / duration samo, če velja Number.isFinite(duration) && duration > 0.

Primeri

<!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>

Rezultat

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

Primer shranite kot datoteko HTML, jo odprite v brskalniku in preverite izpis v konzoli. Element nima vira: `2.5` je shranjeni začetni položaj, ne rezultat premika ali predvajanja. Element ostane v premoru in `duration` ostane `NaN`.

Povezane lekcije

  • JavaScript · Lekcija 28 · Srednja · Različica: 3

Viri