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

CKTIS / JavaScript

HTMLMediaElement: čas, hlasitosť a udalosti prehrávania

HTMLMediaElement poskytuje spoločné API pre zvukové a obrazové prvky. Umožňuje čítať stav prehrávania, meniť pozíciu a stlmenie a aktualizovať rozhranie podľa udalostí namiesto predpokladu, že príkaz na prehrávanie okamžite uspel.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

media.currentTime = seconds; media.volume = 0.5; media.muted = true; media.addEventListener("timeupdate", render);

HTMLMediaElement je spoločné rozhranie pre zvukové a obrazové prvky. Ide o webové API definované HTML, nie o funkciu konkrétnej verzie ECMAScriptu. Prítomnosť Node 24 nedokazuje podporu v prehliadači. Základné rozhranie je široko dostupné, ale volume má obmedzenia kompatibility; overte cieľové prehliadače a zariadenia.

HTMLMediaElement.currentTime udáva pozíciu v sekundách. Ak má readyState hodnotu HAVE_NOTHING, ako pri prvku bez zdroja v príklade, priradením sa uloží predvolená pozícia začiatku prehrávania a presun sa nespustí. V ostatných stavoch priradenie vyžiada presun v rámci dostupnej časovej osi. HTMLMediaElement.duration je iba na čítanie: počet sekúnd, NaN, ak nie sú k dispozícii údaje, alebo Infinity pri neurčitom trvaní. Percento priebehu počítajte len pri konečnom kladnom trvaní. HTMLMediaElement.volume prijíma hodnoty od 0 do 1. HTMLMediaElement.muted nezávisle stlmí zvuk bez zmeny uloženej hlasitosti.

Vlastnosti iba na čítanie HTMLMediaElement.paused a HTMLMediaElement.ended označujú stav pozastavenia, respektíve dokončenie prehrávania; nie sú zameniteľné. paused === false nezaručuje postup prehrávania, napríklad počas načítavania do vyrovnávacej pamäte. HTMLMediaElement.error obsahuje null alebo objekt MediaError. Udalosti play a pause oznamujú zmeny stavu, zatiaľ čo metódy play() a pause() vydávajú príkazy. Ošetrite zamietnutie promise z play(), napríklad keď zásady automatického prehrávania prehrávanie zablokujú.

loadedmetadata signalizuje načítanie metadát, durationchange zmenu trvania a emptied vyprázdnenie stavu zdroja — vtedy aktualizujte aj rozhranie. timeupdate používajte na aktualizáciu pozície, nie ako hodinový signál pre snímky: jeho frekvencia závisí od zaťaženia. volumechange sa týka zmien volume alebo muted; ended signalizuje koniec prehrávania. Udalosť error môže signalizovať nielen chybu pri načítaní zdroja, ale aj fatálnu chybu dekódovania po spustení prehrávania. V obslužných funkciách udalostí čítajte aktuálne vlastnosti.

Príklad vytvorí prvok bez zdroja, zaregistruje udalosti a vypíše počiatočný stav. Neprehráva súbor ani netestuje dekódovanie. NaN je zámerne zapísané ako text, aby serializácia JSON zachovala tento rozdiel.

Príklady

const media = document.createElement("audio");
const events = [
  "timeupdate", "loadedmetadata", "durationchange", "emptied",
  "play", "pause", "volumechange", "ended", "error"
];
function snapshot() {
  return JSON.stringify({
    currentTime: media.currentTime,
    duration: Number.isNaN(media.duration) ? "NaN" : String(media.duration),
    volume: media.volume,
    muted: media.muted,
    paused: media.paused,
    ended: media.ended,
    error: media.error === null ? null : media.error.code
  });
}
for (const type of events) {
  media.addEventListener(type, () => console.log(type, snapshot()));
}
console.log(snapshot());

Výsledok

{"currentTime":0,"duration":"NaN","volume":1,"muted":false,"paused":true,"ended":false,"error":null}

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje