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

CKTIS / JavaScript

Събития на HTMLMediaElement

Използвай девет събития за аудио и видео, за да синхронизираш позицията, продължителността и контролите и да разпознаваш нулиране, край на възпроизвеждането или грешка.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

media.addEventListener(type, (event) => { /* read event.currentTarget here */ });
// type: "timeupdate" | "loadedmetadata" | "durationchange" | "emptied"
//     | "play" | "pause" | "volumechange" | "ended" | "error"

HTMLMediaElement е интерфейс на браузъра, общ за елементите audio и video, а не част от ECMAScript. Регистрирай слушатели с addEventListener() директно върху медийния елемент, по възможност преди да зададеш src: тези събития не се разпространяват нагоре към родителските елементи и не могат да бъдат отменени. В обработчика чети текущото състояние на елемента, вместо да го извеждаш от реда на събитията.

loadedmetadata означава, че метаданни като размерите на видеото са налични, но не и че възпроизвеждането е готово да започне. durationchange сигнализира, че продължителността е установена или обновена: duration е в секунди, има стойност NaN, когато няма данни, и Infinity, когато няма определена крайна граница. emptied означава, че състоянието на ресурса е нулирано, например при презареждане. Изчисти старите данни от интерфейса: самото нулиране не е задължително да предизвика durationchange.

При timeupdate прочети currentTime в секунди, за да обновиш индикатора за позиция. Събитието може да настъпи при възпроизвеждане или преместване до друга позиция; то не е таймер с постоянна честота или сигнал за всеки кадър. play означава, че paused е станало false, а не че възпроизвеждането действително е започнало (playing). pause отбелязва преминаване в състояние на пауза, а не временен недостиг на данни. При volumechange прочети и volume, и muted: промяна на която и да е от двете стойности може да предизвика събитието.

ended отбелязва достигането на края, а не обикновена пауза, макар че накрая може да настъпи и pause. Ако loop е true и playbackRate е неотрицателно, ended не се задейства. При error провери media.error, например media.error?.code; този MediaError се отнася до медийния ресурс. Обработвай отделно отхвърлянето на обещанието от play(): например NotAllowedError може да е вследствие от правилата за автоматично възпроизвеждане, без да се задейства медийно събитие error.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLMediaElement events</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement('div');
  const audio = document.createElement('audio');
  audio.controls = true;
  audio.preload = 'metadata';
  panel.append(audio);

  // Generate three seconds of silence as mono, 8-bit PCM WAV.
  const rate = 8000;
  const samples = 3 * rate;
  const bytes = new Uint8Array(44 + samples);
  const view = new DataView(bytes.buffer);
  const tag = (offset, text) => bytes.set(new TextEncoder().encode(text), offset);
  const u16 = (offset, value) => view.setUint16(offset, value, true);
  const u32 = (offset, value) => view.setUint32(offset, value, true);
  tag(0, 'RIFF'); u32(4, 36 + samples); tag(8, 'WAVE');
  tag(12, 'fmt '); u32(16, 16); u16(20, 1); u16(22, 1);
  u32(24, rate); u32(28, rate); u16(32, 1); u16(34, 8);
  tag(36, 'data'); u32(40, samples); bytes.fill(128, 44);
  const wav = URL.createObjectURL(new Blob([bytes], { type: 'audio/wav' }));
  const bad = URL.createObjectURL(new Blob(['not audio'], { type: 'audio/wav' }));

  const listeners = new AbortController();
  const types = ['timeupdate', 'loadedmetadata', 'durationchange', 'emptied',
    'play', 'pause', 'volumechange', 'ended', 'error'];
  for (const type of types) {
    audio.addEventListener(type, ({ currentTarget: media }) => {
      console.log(type, {
        currentTime: media.currentTime, duration: media.duration,
        paused: media.paused, ended: media.ended,
        volume: media.volume, muted: media.muted,
        errorCode: media.error?.code ?? null
      });
    }, { signal: listeners.signal });
  }

  function button(label, action) {
    const control = document.createElement('button');
    control.type = 'button';
    control.textContent = label;
    control.addEventListener('click', action);
    panel.append(control);
  }
  button('Mute / unmute', () => { audio.muted = !audio.muted; });
  button('Reload', () => { audio.src = wav; });
  button('Load invalid audio', () => { audio.src = bad; });
  button('Remove demo', () => {
    listeners.abort();
    audio.removeAttribute('src');
    audio.load();
    panel.remove();
    URL.revokeObjectURL(wav);
    URL.revokeObjectURL(bad);
  });
  document.body.prepend(panel);
  audio.src = wav;
})();
</script>
</body>
</html>

Резултат

Expected observations, not a fixed transcript (each event name is logged with a state object):
- Initial load: durationchange and loadedmetadata; duration is 3 seconds at loadedmetadata.
- Play, pause, resume, and let the clip finish: play, timeupdate (repeated), pause, play again, and eventually ended. A pause event can also occur at the end.
- Mute / unmute: volumechange; muted toggles.
- Reload after metadata is available: emptied, then fresh durationchange and loadedmetadata.
- Load invalid audio: error with a non-null errorCode; emptied can appear first.

Запази примера като HTML файл и го отвори в браузър, който поддържа PCM WAV и разрешава медийни ресурси с адреси `blob:`. Проследи събитията в конзолата за разработчици. Използвай вградените контроли за възпроизвеждане и пауза. Примерът създава три секунди тишина, без да изтегля файл; моментът и броят на събитията могат да се различават. `Remove demo` премахва контролите и освобождава обектните URL адреси.

Свързани уроци

  • JavaScript · Урок 28 · Средно · Версия: 3

Източници