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
- HTMLMediaElement - Web APIs | MDN
- HTMLMediaElement: currentTime property - Web APIs | MDN
- HTMLMediaElement: duration property - Web APIs | MDN
- HTMLMediaElement: volume property - Web APIs | MDN
- HTMLMediaElement: timeupdate event - Web APIs | MDN
- HTMLMediaElement: volumechange event - Web APIs | MDN
- HTMLMediaElement: paused property - Web APIs | MDN
- HTMLMediaElement: ended property - Web APIs | MDN
- HTMLMediaElement: error property - Web APIs | MDN
- HTMLMediaElement: play() method - Web APIs | MDN