MediaStreamTrack: метод stop()

Метод stop() интерфейса MediaStreamTrack останавливает поток.

Нет.

None (undefined).

Вызов stop() сообщает пользовательскому агенту, что источник потока — будь то файлы, сетевые потоки или локальная камера или микрофон — больше не нужен объекту MediaStreamTrack. Поскольку несколько потоков могут использовать один и тот же источник (например, если два вкладки используют микрофон устройства), сам источник не останавливается немедленно. Вместо этого он отсоединяется от потока, а сам объект потока останавливается. Когда ни один поток не использует источник, источник может быть полностью остановлен.

Сразу после вызова stop(), свойство readyState устанавливается в значение ended. Обратите внимание, что событие ended в этой ситуации не будет сгенерировано.

В этом примере показана функция, которая останавливает видеопоток, вызывая stop() для каждого потока в заданном элементе <video>.

function stopStreamedVideo(videoElem) {
  const stream = videoElem.srcObject;
  const tracks = stream.getTracks();

  tracks.forEach((track) => {
    track.stop();
  });

  videoElem.srcObject = null;
}

Для этого используется получение потока видеоэлемента из его свойства srcObject. Затем список потоков в потоке получает метод getTracks(). Далее, для перебора списка потоков используется forEach() и вызывается метод stop() каждого потока.

Наконец, srcObject устанавливается в значение null для разрыва связи с объектом MediaStream, чтобы он мог быть освобожден.

• MediaStreamTrack, интерфейс, к которому он принадлежит.
• MediaStreamTrack.readyState
• ended