MediaSource

MediaSource – это интерфейс Media Source Extensions API для предоставления интерактивного источника медиаданных объектам типа HTMLMediaElement.

Конструктор

MediaSource()

Создает и возвращает новый объект MediaSource не имеющий подключенных буферов данных.

Свойства

Наследует свойства родительского интерфейса , EventTarget.

MediaSource.sourceBuffers Только для чтения

Возвращает объект типа SourceBufferList  содержащий список объектов типа SourceBuffer , связанных непосредственно с текущим MediaSource.

MediaSource.activeSourceBuffers Только для чтения

Возвращает объект типа SourceBufferList содержащий подмножество объектов типа SourceBuffer хранящих в себе другие объекты типа SourceBuffers — список объектов, предоставляющих доступ к выбранному видео, доступным аудиодорожкам, текстовым данным и тд.

MediaSource.readyState Только для чтения

Возвращает enum, отображающий состояние текущего MediaSource-объекта, будь то отсутствие подключения к медиа-элементу(closed), подключенный и готовый к передаче объектов типа SourceBuffer (open), или подключенный, но с завершенным потоком MediaSource.endOfStream() (ended.)

MediaSource.duration

Возвращает или устанавливает продолжительность предоставляемых медиаданных.

Методы

Наследует свойства родительского интерфейса, EventTarget.

MediaSource.addSourceBuffer()

Создает новый объект типа SourceBuffer, с указанным  MIME-типом и добавляет в список MediaSource's SourceBuffers.

MediaSource.removeSourceBuffer()

Удаляет указанный SourceBuffer из списка SourceBuffers, связанного с текущим MediaSource-объектом.

MediaSource.endOfStream()

Сигнализирует об окончании потока.

Статичные методы

MediaSource.isTypeSupported()

Возвращает значение Boolean, поясняющее, поддерживается ли клиентом полученный MIME-тип  — если это так, то можно успешно создать объект типа SourceBuffer для этого MIME-типа.

Примеры

Нижеприведенный простой пример подгружает видео фрагмент за фрагментом так скоро, как может, воспроизводя их "как только так сразу". Этот пример был написан Nick Desaulniers и может быть просмотрен здесь в виде демо (также вы можете загрузить исходный код для дальнейшего изучения.)

var video = document.querySelector('video');

var assetURL = 'frag_bunny.mp4';
// Need to be specific for Blink regarding codecs
// ./mp4info frag_bunny.mp4 | grep Codec
var mimeCodec = 'video/mp4; codecs="avc1.42E01E, mp4a.40.2"';

if ('MediaSource' in window && MediaSource.isTypeSupported(mimeCodec)) {
  var mediaSource = new MediaSource();
  //console.log(mediaSource.readyState); // closed
  video.src = URL.createObjectURL(mediaSource);
  mediaSource.addEventListener('sourceopen', sourceOpen);
} else {
  console.error('Unsupported MIME type or codec: ', mimeCodec);
}

function sourceOpen (_) {
  //console.log(this.readyState); // open
  var mediaSource = this;
  var sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
  fetchAB(assetURL, function (buf) {
    sourceBuffer.addEventListener('updateend', function (_) {
      mediaSource.endOfStream();
      video.play();
      //console.log(mediaSource.readyState); // ended
    });
    sourceBuffer.appendBuffer(buf);
  });
};

function fetchAB (url, cb) {
  console.log(url);
  var xhr = new XMLHttpRequest;
  xhr.open('get', url);
  xhr.responseType = 'arraybuffer';
  xhr.onload = function () {
    cb(xhr.response);
  };
  xhr.send();
};

Specifications

Browser compatibility

[1] Available after switching the about:config preference media.mediasource.enabled to true. In addition, support was limited to a whitelist of sites, for example YouTube, Netflix, and other popular streaming sites. The whitelist was removed and Media Source Extensions was enabled by default in 42+ for all sites.

[2] Only works on Windows 8+.

See also

• SourceBuffer
• SourceBufferList