WebRTC学习与DEMO资源一览

一. WebRTC学习

1.1   WebRTC现状

本人最早接触WebRTC是在2011年底，
那时Google已经在Android源码中加入了webrtc源码，放在/external/webrtc/，
但是Android并没有用到它，更没有被浏览器使用。
当时试图在Android 2.3（Gingerbread）高通平台的手机上
用H.264 硬件codec替换掉WebRTC缺省使用的VP8软codec，费了不少劲勉强换掉后效果很差只得放弃。

最近得知Google最新版的Chrome for Android已经支持WebRTC，
应老板的要求搭一个手机浏览器上视频通信的demo，
为此在网上搜集各种资料，发现经过一年多的发展，
国内外研究和使用WebRTC的人明显多起来，可用的demo也很多。
在此做一个笔记，留作日后参考。


目前基于WebRTC的开发其实有两个方向，
一个是基于浏览器的WebRTC应用开发，编程语言主要是JavaScript、HTML等，
这也是WebRTC作为HTML5标准的组成部分原本的目的；


另一个是C层面的移植和开发，作为一款非常强大的开源软件，
很多领域的软件项目都可以利用到WebRTC的音视频通信和处理能力，
这些场合的应用程序可能是C语言写的，也不一定与浏览器有关。
本文是属于前一种方向。

1.2 WebRTC基本概念学习

WebRTC的官方资料可以从其官网http://www.webrtc.org/
和W3C网站http://www.w3.org/TR/webrtc/上看到。

学习WebRTC基础知识比较好的网站是《Getting Started with WebRTC》，
网址是http://www.html5rocks.com/en/tutorials/webrtc/basics/，这个也是官网上推荐的。

对浏览器来说，WebRTC其实就是提供了3个API：
. MediaStream (即getUserMedia)，用于获取媒体数据，例如来自摄像头和麦克风的视频流和音频流；
. RTCPeerConnection，用于peer跟peer之间呼叫和建立连接以便传输音视频数据流；
. RTCDataChannel，用于peer跟peer之间传输音视频之外的一般数据。

需要注意的是这几个API的名称在不同浏览器及同一浏览器的不同版本之间略有差异，
比如PeerConnection在FireFox上叫做mozRTCPeerConnection，
而在当前版本的Chrome上叫做webkitRTCPeerConnection，
将来WebRTC标准化完成后会把这些前缀去掉使用统一的名称。

目前网上找到的WebRTC demo都只用到了getUserMedia和RTCPeerConnection这两个API，
另一个API即RTCDataChannel似乎目前还不太成熟。

WebRTC是实现peer to peer的实时通信（可以两个或多个peer之间），
在能够通信前peer跟peer之间必须建立连接，这是RTCPeerConnection的任务，
为此需要借助一个信令服务器（signaling server）来进行，信令包括3种类型的信息：
 . Session control messages: 初始化和关闭通信，及报告错误；
 . Network configuration: 双方的IP地址和端口号（局域网内部IP地址需转换为外部的IP地址）；
 . Media capabilities: 双方的浏览器支持使用何种codecs以及多高的视频分辨率。

WebRTC并未规定使用何种信令机制和消息协议，
象SIP、XMPP、XHR、WebSocket这些技术都可以用作WebRTC的信令通信。

除了信令服务器，peer跟peer建立连接还需要借助另一种服务器
（称为STUN server）实现NAT/Firewall穿越，因为很多peer是处于私有局域网中，
使用私有IP地址，必须转换为公有IP地址才能相互之间传输数据。
这其中涉及到一些专业术语包括STUN、TURN、ICE等，具体的本人还有待学习。
网上找到的WebRTC demo好象都用的是Google提供的STUN server。

peer跟peer之间一旦建立连接就可以直接传输音视频数据流，
并不需要借助第三方服务器中转。

二. WebRTC封装库

WebRTC的目的是为了简化基于浏览器的实时数据通信的开发工作量，
但实际应用编程还是有点复杂，尤其调用RTCPeerConnection必须对如何建立连接、
交换信令的流程和细节有较深入的理解。

因此有高人为我们开发了WebRTC封装库，将WebRTC的调用细节封装起来，包装成更简单的API，
使开发应用程序更简单。
封装库的另一个目的是为了屏蔽不同浏览器之间的差异，例如上面说的API名称的差异。
当然，这些库都是开源的，可以根据自己的需要重新修改。

目前网上找到的有两种WebRTC封装库，
1) webrtc.io，网址是https://github.com/webRTC/webRTC.io，
   上面有详细说明和使用方法，有很多demo使用它；
2) SimpleWebRTC，网址是https://github.com/HenrikJoreteg/SimpleWebRTC，
   貌似比webrtc.io用起来更简单。

三、 WebRTC demo试用

网上可以找到一堆WebRTC demo，在code.google.com上也能找到不少WebRTC应用项目的源码。
有些demo是直接调用WebRTC API开发的，但大多数是调用上述两种WebRTC封装库开发的。
由于WebRTC API的名称在不同浏览器及同一浏览器的不同版本之间存在差异，
所以不是所有demo都能运行在所有浏览器上。

为了找到一个可在公司局域网环境中跑在手机上的WebRTC demo，本人试用了不少demo，
下面选几个有代表性的介绍，其中有两个经修改后已在本人公司的局域网环境中运行成功。

先说一下本人的测试环境：手机上的浏览器是Chrome for Android 26.0.1410.49，
运行在Android 4.1.2上，这个Chrome版本本身是beta版，支持WebRTC但缺省是关闭WebRTC功能的，
需要在chrome://flags中使能WebRTC并重启Chrome，
或者在启动Chrome时增加命令行选项--enable-webrtc。
本人在PC上运行WebRTC的浏览器是Chrome 26.0.1410.43，操作系统是Windows 7。

3.1  http://www.webrtc.org/demo（https://apprtc.appspot.com/）

这是官方的demo，功能很全，
这个网站 https://apprtc.appspot.com/ 不能直接从国内上去，需要才行，
它的源码原来是在https://code.google.com/p/webrtc-samples/上，
现在下不了了。
此demo没有用任何封装库。

这个demo所使用的信令机制使用了XHR和Google App Engine Channel API ，具体我不懂。
在我的公司局域网环境里无法运行该demo。

3.2  爱立信实验室开发的WebRTC demo

据说是第一个基于浏览器的WebRTC视频通信demo，
爱立信为此还开发了一个浏览器用于支持WebRTC，好象也是基于WebKit的，
叫做Bowser browser（当时市场上可能还没有支持WebRTC的浏览器），
该项目网址是https://labs.ericsson.com/apps/bowser。
这个Bowser browser好象只支持Ubuntu 11.04 and 11.10
（见https://labs.ericsson.com/apis/web-real-time-communication/downloads）。

该demo的网址是http://webrtc.labs.ericsson.net:8082。
在我的公司局域网环境里无法运行该demo。

3.3   人脸检测识别

利用WebRTC的getUserMedia从摄像头获取图像进行人脸识别的demo，例如这两个：
http://neave.com/webcam/html5/face/
http://www.raymondcamden.com/demos/2012/mar/29/test1.html
前面这个在PC和手机上的Chrome上都可运行，后面那个不行

3.4   http://www.simpl.info

这个demo演示HTML, CSS and JavaScript的各种feature和使用方法，
包括WebRTC的3个API：
 . getUserMedia、
 . RTCPeerConnection、
 . RTCDataChannel的演示，
但遗憾的是RTCPeerConnection的演示只是本地camera的画面传回给本地，
并没有实现真正的设备之间音视频通信。
该项目的源码在https://github.com/samdutton/simpl。
​

3.5   Framegrabber

这是一个基于WebRTC实现屏幕共享（screensharing）的Chrome扩展，
源码在https://github.com/samdutton/rtcshare，
有关介绍可参考这篇文章：http://blog.sina.com.cn/s/blog_51396f890102es7k.html。
没试用过。

3.6   http://webrtc.dennis.is

这个demo是基于库webrtc.io实现的，是webrtc.io官方的demo，使用WebSocket作为信令手段。
在我的公司局域网环境里无法运行该demo；
在家里无线路由器环境下可成功运行，但只能单向传输视频。

3.7   http://v.kainy.cn

国内牛人做的，相当于是汉化版的http://webrtc.dennis.is，
自然也是基于webrtc.io实现的，但使用的webrtc.io版本较老，
不支持新版本Chrome所使用的API名称webkitRTCPeerConnection，
所以无法在新版本Chrome上运行。
具体介绍在http://blog.kainy.cn/2013/01/webrtc实现的视频聊天室应用/。

3.8   http://conversat.io

这个demo是基于库SimpleWebRTC实现的，是SimpleWebRTC官方的demo，使用WebSocket作为信令手段。

在我的公司局域网环境里无法运行该demo；
在家里无线路由器环境下可成功运行，且可双向传视频，支持多个peer同时视频通信。


经修改后在本人公司局域网成功运行，
试过两个手机和一个笔记本电脑同时视频通信OK。
修改和运行步骤：
1. 从http://www.nodejs.org/download/下载nodejs最新版并安装，
   我是在Windows7 64位上安装的；
2. 在命令行下依次运行如下命令（安装运行signaling server所需的模块）：
npm install express
npm install yetify
npm install getconfig
npm install node-uuid
npm install socket.io


3. 从https://github.com/andyet/signalmaster下载信令服务器源码，
   该信令服务器是SimpleWebRTC缺省使用的，解开该源码后运行node server.js，
   该服务器监听8888端口，通过WebSocket与浏览器通信。


4. 在同一台PC上运行apache server，
   将从http://conversat.io网站扒下来的文件放到该server上
  （可在Chrome浏览器中打开http://conversat.io然后鼠标右键单击在菜单中选
   “另存为”、“网页，全部”即可），修改其中的 index.html 和 simplewebrtc.js，
    将其中 url 改为'http://10.100.156.83:8888'（其中IP地址是我的PC在公司局域网中的IP地址）。


5. 在同一局域网中的其他设备上打开Chrome浏览器，
   地址栏输入http://10.100.156.83，输入相同的room名称（随便起）即可开始多方视频通信，
   也可修改上述index.html中的“var room”一行，设定为固定的room名称，
   就不需要每次在每个设备上手工输入room名称了。

3.9   国内人开发的视频聊天室应用

这个demo是国内人赵书剑开发的视频聊天室，基于webrtc.io实现。
该项目源码和文档下载地址是:
  http://ishare.iask.sina.com.cn/f/35083616.html，
源码在:
  https://github.com/zsj2145676。


1. 从http://ishare.iask.sina.com.cn/f/35083616.html下载webrtc.chatdemo.zip，
解压缩，修改其中public\javascripts\client.js中的rtc.connect一行，
将实际的服务器地址写进去，例如改为：
  rtc.connect("ws://10.100.156.83:8001", room);


2. 安装node.js
从http://www.nodejs.org/download/下载nodejs最新版并安装，
   我是在Windows7 64位上安装的；
在命令行下依次运行如下命令（安装运行signaling server所需的模块）：
npm install express
npm install yetify
npm install getconfig
npm install node-uuid
npm install socket.io


3.运行node app.js，注意该demo本身已包含http server，
  不需要其他的http server,比如apache server


4.在同一局域网中的其他设备上打开Chrome浏览器，
地址栏输入http://10.100.156.83:8000，
输入相同的room名称（随便起）即可开始多方视频通信。
​

我对照做了安装和修改，测试失败，
能看到房间有人进来和退出，但无法进行文件和视频聊天。