MediaStream

MediaStream - медіа потік.

Синтаксис:

var stream = new MediaStream();
var stream = new MediaStream(stream);
var stream = new MediaStream(tracks);

Параметри:

straem - змінна якій містить/присвоюється об'єкт MediaStream.

tracks - масив об'єктів MediaStreamTrack.

Опис:

MediaStream об'єкт який представляє собою медіа потік. Найчастіше отримується за допомогою метода MediaDevices.getUserMedia().

Медіа потік зазвичай це зовнішнє джерело медіа такі як мікрофон, камера.

Медіа потік складається з декількох доріжок (траків) - об'єктів MediaStreamTrack. Доріжка це носій медіа який містить аудіо або відео. Доріжок у медіа потоці може бути одна або декілька. Зазвичай медіа потік складається з одної адіо доріжки, або двох доріжок аудіо і відео.

MediaStream

MediaStream.active - чи активований медіа потік.
MediaStream.ended - чи досягнуто кінця медіа потоку.
MediaStream.id - ідентифікатор медіа потоку.

MediaStream

MediaStream.addTrack() - додає нову доріжку до медіа потоку.
MediaStream.clone() - повертає клон об'єкта MediaStream.
MediaStream.getTracks() - усі доріжки (об'єкти MediaStreamTrack) медіа потоку.
MediaStream.getVideoTracks() - усі відео доріжки (об'єкти MediaStreamTrack в яких властивість kind дорівнює "video") медіа потоку.
MediaStream.getAudioTracks() - усі аудіо доріжки (об'єкти MediaStreamTrack в яких властивість kind дорівнює "audio") медіа потоку.
MediaStream.getTrackById() - повертає доріжку за вказаним ідентифікатором.
MediaStream.removeTrack() - видаляє доріжку з медіа потоку.
addEventListener() - додає подію до об'єкта.
removeEventListener - видаляє подію з об'єкта.

MediaStream

MediaStream.onaddtrack - додано доріжку до медіа потоку.
MediaStream.onremovetrack - видалено доріжку з медіа потоку.
MediaStream.onactive - медіа потік активний.
MediaStream.oninactive - медіа потік не активний.

За політикою безпеки деякі браузери дозволяють використання (отримання) медіа потоку лише з протоколів https.

У браузері Chrome якщо протокол не HTTPS (захищений SSL) тоді виникне помилка: "Cannot read property 'getUserMedia' of undefined". Тому рекомендовано використовувати протокол HTTPS для сайту з використанням getUserMedia.

Приклад:

var stream=new MediaStream;
alert( stream );

navigator.mediaDevices.getUserMedia({audio:true}).then(function(stream){
	alert(stream);
});

Кількість об'єктів MediaStreamTrack у медіа потоці:

navigator.mediaDevices.getUserMedia({audio:true, video:true}).then(function(stream){
	var tracks=stream.getTracks();
	alert('кількість доріжок у медіа потоці: '+tracks.length);
});

Відтворення відео з камери:

navigator.mediaDevices.getUserMedia({audio:true, video:true}).then(function(stream){
	var video=document.getElementById('video');
	video.srcObject=stream;
	video.play();
});