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
- 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