CKTIS / JavaScript
HTMLMediaElement: vrijeme, glasnoća i događaji reprodukcije
HTMLMediaElement pruža zajednički API za audio i video elemente. Omogućuje čitanje stanja reprodukcije, promjenu položaja i isključivanje zvuka te ažuriranje sučelja na temelju događaja, umjesto pretpostavke da je naredba za reprodukciju odmah uspjela.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
media.currentTime = seconds; media.volume = 0.5; media.muted = true; media.addEventListener("timeupdate", render);HTMLMediaElement zajedničko je sučelje za audio i video elemente. Riječ je o web API-ju koji definira HTML, a ne o značajci određene verzije ECMAScripta. Sama prisutnost Nodea 24 ne dokazuje podršku u pregledniku. Osnovno sučelje široko je dostupno, ali volume ima ograničenja kompatibilnosti; provjerite ciljane preglednike i uređaje.
HTMLMediaElement.currentTime daje položaj u sekundama. Kada readyState ima vrijednost HAVE_NOTHING, kao kod elementa bez izvora u primjeru, dodjelom vrijednosti pohranjuje se zadani početni položaj reprodukcije bez pokretanja pomaka. U ostalim stanjima dodjela vrijednosti traži pomak unutar dostupne vremenske crte. HTMLMediaElement.duration dostupan je samo za čitanje: broj sekundi, NaN kada podaci nisu dostupni ili Infinity za neodređeno trajanje. Postotak napretka izračunajte samo za konačno, pozitivno trajanje. HTMLMediaElement.volume prihvaća vrijednosti od 0 do 1. HTMLMediaElement.muted neovisno isključuje zvuk bez promjene pohranjene glasnoće.
Svojstva samo za čitanje HTMLMediaElement.paused i HTMLMediaElement.ended označavaju stanje pauze, odnosno završetak reprodukcije; nisu zamjenjiva. paused === false ne jamči napredovanje, primjerice tijekom međuspremanja. HTMLMediaElement.error sadrži null ili objekt MediaError. Događaji play i pause javljaju promjene stanja, dok metode play() i pause() izdaju naredbe. Obradite odbijanje promisea iz play(), primjerice kada pravila automatske reprodukcije blokiraju reprodukciju.
loadedmetadata označava učitane metapodatke, durationchange promjenu trajanja, a emptied ispražnjeno stanje resursa — tada osvježite i sučelje. timeupdate služi za ažuriranje položaja, ali ne kao sat za sličice: učestalost ovisi o opterećenju. volumechange se odnosi na promjene svojstava volume ili muted; ended označava kraj reprodukcije. Događaj error može signalizirati ne samo pogrešku pri učitavanju resursa nego i fatalnu pogrešku pri dekodiranju nakon početka reprodukcije. U rukovateljima događaja pročitajte trenutačna svojstva.
Primjer stvara element bez izvora, registrira događaje i ispisuje početno stanje. Ne reproducira datoteku niti provjerava dekodiranje. NaN je namjerno prikazan kao tekst kako bi JSON serijalizacija sačuvala tu razliku.
Primjeri
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());Rezultat
{"currentTime":0,"duration":"NaN","volume":1,"muted":false,"paused":true,"ended":false,"error":null}Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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