База знанияИзпитен център
BGБългарски
Избери език13

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}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници