Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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