CKTIS / JavaScript
HTMLMediaElement: време, сила на звука и събития при възпроизвеждане
HTMLMediaElement предоставя общия API за аудио и видео елементи. Чрез него можете да четете състоянието на възпроизвеждане, да променяте позицията и заглушаването и да обновявате интерфейса въз основа на събития, вместо да приемате, че команда за възпроизвеждане е изпълнена веднага.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
media.currentTime = seconds; media.volume = 0.5; media.muted = true; media.addEventListener("timeupdate", render);HTMLMediaElement е общият интерфейс за аудио и видео елементи. Това е уеб API, дефиниран от HTML, а не функция на конкретно издание на ECMAScript. Наличието на Node 24 не доказва поддръжка в браузър. Основният интерфейс е широко достъпен, но volume има ограничения за съвместимост; проверете целевите браузъри и устройства.
HTMLMediaElement.currentTime показва позицията в секунди. Когато readyState има стойност HAVE_NOTHING, както при елемента без източник в примера, присвояването запазва началната позиция по подразбиране за възпроизвеждане, без да започва преместване. В останалите състояния присвояването заявява преместване в рамките на наличната времева линия. HTMLMediaElement.duration е само за четене: секунди, NaN, когато няма налични данни, или Infinity при неопределена продължителност. Изчислявайте процента на напредък само при крайна положителна продължителност. HTMLMediaElement.volume приема стойности от 0 до 1. HTMLMediaElement.muted заглушава звука независимо, без да променя запазената сила на звука.
Свойствата само за четене HTMLMediaElement.paused и HTMLMediaElement.ended показват съответно състояние на пауза и край на възпроизвеждането; те не са взаимозаменяеми. paused === false не гарантира напредък, например по време на буфериране. HTMLMediaElement.error съдържа null или обект MediaError. Събитията play и pause съобщават за промени в състоянието, докато методите play() и pause() подават команди. Обработвайте отхвърлянето на promise от play(), например когато правилата за автоматично възпроизвеждане го блокират.
loadedmetadata сигнализира за заредени метаданни, durationchange — за промяна в продължителността, а emptied — за изпразнено състояние на ресурса; тогава обновете и интерфейса. Използвайте timeupdate за обновяване на позицията, но не като часовник за кадри: честотата му зависи от натоварването. volumechange се отнася до промени в volume или muted; ended сигнализира за край на възпроизвеждането. Събитието error може да сигнализира не само за грешка при зареждане на ресурса, но и за фатална грешка при декодиране, след като възпроизвеждането е започнало. Четете текущите свойства в обработчиците на събития.
Примерът създава елемент без източник, регистрира събития и извежда началното състояние. Той не възпроизвежда файл и не проверява декодирането. NaN умишлено се представя като текст, така че JSON сериализацията да запази това разграничение.
Примери
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());Резултат
{"currentTime":0,"duration":"NaN","volume":1,"muted":false,"paused":true,"ended":false,"error":null}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- 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