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

CKTIS / JavaScript

HTMLMediaElement: čas, glasnost in dogodki predvajanja

HTMLMediaElement ponuja skupni API za zvočne in video elemente. Omogoča branje stanja predvajanja, spreminjanje položaja in utišanja ter posodabljanje vmesnika na podlagi dogodkov, namesto da bi predpostavili, da je ukaz za predvajanje takoj uspel.

Različica: 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 je skupni vmesnik za zvočne in video elemente. Gre za spletni API, ki ga določa HTML, ne pa za funkcijo določene izdaje ECMAScripta. Prisotnost Node 24 ne dokazuje podpore v brskalniku. Osnovni vmesnik je široko dostopen, vendar ima volume omejitve združljivosti; preverite ciljne brskalnike in naprave.

HTMLMediaElement.currentTime podaja položaj v sekundah. Če ima readyState vrednost HAVE_NOTHING, kot pri elementu brez vira v primeru, dodelitev vrednosti shrani privzeti položaj za začetek predvajanja, ne da bi sprožila premik. V drugih stanjih dodelitev vrednosti zahteva premik znotraj razpoložljive časovnice. HTMLMediaElement.duration je samo za branje: sekunde, NaN, kadar podatki niso na voljo, ali Infinity pri nedoločeni dolžini. Odstotek napredka izračunajte le pri končni, pozitivni dolžini. HTMLMediaElement.volume sprejema vrednosti od 0 do 1. HTMLMediaElement.muted neodvisno utiša zvok, ne da bi spremenil shranjeno glasnost.

Lastnosti samo za branje HTMLMediaElement.paused in HTMLMediaElement.ended označujeta stanje premora oziroma konec predvajanja; nista zamenljivi. paused === false ne zagotavlja napredovanja, na primer med medpomnjenjem. HTMLMediaElement.error vsebuje null ali objekt MediaError. Dogodka play in pause sporočata spremembe stanja, metodi play() in pause() pa izdata ukaza. Obravnavajte zavrnitev promise, ki ga vrne play(), na primer kadar pravilnik samodejnega predvajanja blokira predvajanje.

loadedmetadata označuje naložene metapodatke, durationchange spremembo dolžine, emptied pa izpraznjeno stanje vira — takrat posodobite tudi vmesnik. timeupdate uporabite za posodobitev položaja, ne pa kot uro sličic: njegova pogostost je odvisna od obremenitve. volumechange zadeva spremembe volume ali muted; ended označuje konec predvajanja. Dogodek error lahko sporoči ne le napako pri nalaganju vira, temveč tudi usodno napako pri dekodiranju po začetku predvajanja. V obravnavalnikih dogodkov preberite trenutne lastnosti.

Primer ustvari element brez vira, registrira dogodke in izpiše začetno stanje. Datoteke ne predvaja in ne preverja dekodiranja. NaN je namenoma predstavljen kot besedilo, da serializacija JSON ohrani to razliko.

Primeri

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}

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri