首页 > 代码库 > 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()