首页 > 代码库 > WebRTC Demo - getUserMedia()

WebRTC Demo - getUserMedia()

WebRTC介绍

WebRTC提供三类API:

  • MediaStream,即getUserMedia
  • RTCPeerConnection
  • RTCDataChannel

getUserMedia已经由Chrome, Opera和Firefox支持。

RTCPeerConnection目前则由Chrome, Opera和Firefox支持。Chrome和Opera提供的接口名字为webkitRTCPeerConnection,Firefox则命名为mozRTCPeerConnection。

RTCDataChannel则只有Chrome 25, Opera 18和Firefox 22及以上版本才支持。

一个WebRTC应用需要做如下几件事情

  • 获取流(Streaming),包括音频,视频,以及其它数据
  • 获取网络信息,如IP和端口(PORT),并与其它WebRTC Client交换信息,有的时候还需要穿越防火墙或NAT
  • 信令(Signaling),用于报告错误、初始化或关闭会话
  • 交换多媒体以及Client的支持能力信息,比如分辩率、编解码信息等
  • 流通信

 

MediaStream(getUserMedia)

每一个MediaStream都有一个输入(Input)和输出(Output)。输入可以是由navigator.getUserMedia()生成的多媒体流。输出则可以是html5的video元素或者一个RTCPeerConnection。

咱们看一个简单的示例。

index.html文件内容如下:

<!DOCTYPE html><html><head><meta name="keywords" content="WebRTC, HTML5, JavaScript" /><meta name="description" content="WebRTC Demo" /><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0"><meta http-equiv="X-UA-Compatible" content="chrome=1" /><base target="_blank"><title>getUserMedia</title><link rel="stylesheet" href="http://www.mamicode.com/css/main.css" /></head><body><div id="container">  <h1><a href="http://www.mamicode.com/#" title="WebRTC samples homepage">WebRTC samples</a> <span>getUserMedia</span></h1>  <!--video元素,视频将输出到这里--//>  <video autoplay></video>  <p>在video元素中显示<code>getUserMedia()</code>生成的视频流。</p>  <p><code>MediaStream</code>对象<code>window.stream</code>是全局对象。 <code>getUserMedia()</code> callback对window.stream赋值。你可以在控制台中查看他的值。</p><a href="http://www.mamicode.com/#" title="View source for this page on Github" id="viewSource">源代码</a></div><!--getUserMedia示例代码--//><script src="http://www.mamicode.com/js/main.js"></script></body></html>

index.html主要由一个video元素和一个main.js文件构成。video元素负责输出getUserMedia生成的MediaStream;main.js是主要的代码代码逻辑。

main.js文件内容如下:

// 全局变量,inspector的console中可以查看video = document.querySelector("video"); // get video element refconstraints = {audio: false, video: true}; // only need videonavigator.getUserMedia = navigator.getUserMedia || navigator.webkitGetUserMedia || navigator.mozGetUserMedia;/** * successCallback * getUerMedia成功获得一个MediaStream时,会回调此方法 **/function successCallback(stream){  window.stream = stream; // stream available to console  if (window.URL) { // 生成视频流的地址,将其做为video的输入    video.src = http://www.mamicode.com/window.URL.createObjectURL(stream);"navigator.getUserMedia error: ", error);}navigator.getUserMedia(constraints, successCallback, errorCallback);

点击看DEMO。

getUserMedia()方法需要三个参数:

  • 一个约束对象,如main.js中的constraints

  • 一个success callback,成功时,会回调此方法,参数是一个MediaStream

  • 一个error callback,失败时,会回调此方法,参数是一个error对象

MediaStream由id,label,MediaStreamTracks(video tracks和audio tracks)构成。读者可以在console中查看window.stream对象,了解其构成及方法。

在Chrome和Opera中,URL.createObjectURL()方法把一个MediaStream转化为一个Blob Url。这样,Video元素就可以使用此地址作为其输入。

WebRTC Demo - getUserMedia()