开箱即用的 WebRTC 开发环境

栏目: 后端 · 前端 · 发布时间: 7年前

内容简介：开箱即用的 WebRTC 开发环境

本文是 Piasy 原创，发表于 https://blog.piasy.com ，请阅读原文支持原创 https://blog.piasy.com/2017/06/17/out-of-the-box-webrtc-dev-env/

在刚刚落幕的 WWDC17 上，苹果为我们带来了一个不小的惊喜 —— 其浏览器内核WebKit将正式支持 WebRTC，而未来基于 WebKit 内核的苹果浏览器，比如macOS High Sierra、iOS 11 中的 Safari 浏览器和Safari 技术预览版 32，都将使用到 WebRTC 技术。

—— 苹果终于入伙 WebRTC

适逢我也正在倒腾一些 WebRTC 的东西，万事开头难，搞事情最怕的就是开始的拦路虎，编译环境、demo 工程、Server 如何部署，这三个问题（尤其是最后一个）想必会浇灭很多朋友的热情之火。经过近两周的不懈奋斗，我总算把这几头拦路虎一一解决，今天我就在这里把这一套开箱即用的 WebRTC 开发环境分享给大家。

注意：这里我假设大家具备 Docker 的基本使用能力，如不具备，请自行搜索相关教程。

WebRTC 编译环境

一开始我是用的 webrtc-build-scripts 这个工具，它利用的是 Vagrant，为了和后面的其他工具统一，我就基于它构建了一个 Docker 镜像： piasy/webrtc-build 。

首先是 pull 镜像：

docker pull piasy/webrtc-build

然后就是运行 Docker 镜像了：

docker run --rm \
  -e ENABLE_SHADOW_SOCKS=false \
  -v <path to place webrtc source>:/webrtc \
  -t -i piasy/webrtc-build

单纯对 webrtc-build-scripts 做一层封装肯定没啥意思，针对国情，我在 Docker 镜像里面加上了使用 Shadowsocks 代理的支持，上面的命令不启用 Shadowsocks 代理，如需启用，则运行下面的命令：

docker run --rm \
  -e ENABLE_SHADOW_SOCKS=true \
  -e SHADOW_SOCKS_SERVER_ADDR=<your shadowsocks server ip> \
  -e SHADOW_SOCKS_SERVER_PORT=<your shadowsocks server port> \
  -e SHADOW_SOCKS_ENC_METHOD=<your shadowsocks encrypt method> \
  -e SHADOW_SOCKS_ENC_PASS=<your shadowsocks encrypt password> \
  -v <path to place webrtc source>:/webrtc \
  -t -i piasy/webrtc-build

不过现在还有两点小瑕疵：

proxychains 在 Docker 镜像中还有问题，所以 Shadowsocks 代理暂时不能用；
目前只能编译 Android 环境，iOS 的我还没搞过；

请大家保持关注 :)

编译命令

# 安装相关依赖
install_dependencies

# 下载 WebRTC 代码
get_webrtc

# 编译 WebRTC 代码
build_apprtc

更多编译指令，可以参考 webrtc-build-scripts 和 WebRTC 项目官网。

命令行使用 Shadowsocks 代理

在这里顺便分享一下如何在命令行挂上 Shadowsocks 代理：

sudo apt-get install python-pip
sudo pip install shadowsocks
sudo apt-get install proxychains

wget https://download.libsodium.org/libsodium/releases/LATEST.tar.gz
tar zxf LATEST.tar.gz && cd libsodium*
./configure && make && make install

# 修复关联
echo /usr/local/lib > /etc/ld.so.conf.d/usr_local_lib.conf && ldconfig

/etc/shadowsocks.json 配置内容：

{
"server":"server-ip",
"server_port":8000,
"local_address": "127.0.0.1",
"local_port":1080,
"password":"your-password",
"timeout":600,
"method":"aes-256-cfb"
}

~/.proxychains/proxychains.conf 配置内容：

strict_chain
proxy_dns
remote_dns_subnet 224
tcp_read_time_out 15000
tcp_connect_time_out 8000
localnet 127.0.0.0/255.0.0.0
quiet_mode

[ProxyList]
socks5  127.0.0.1 1080

执行下述命令之后，命令行程序就会使用 Shadowsocks 代理了：

sudo sslocal -c /etc/shadowsocks.json -d start
proxychains bash

Android demo 工程

Android demo 可以利用上面的 WebRTC 源码编译出 APK，但我们如何查阅代码、调试代码呢？最好自然是有一个 Android Studio 工程了，这里为大家送上： AppRTC-Android 。

这个项目其实就是把相关路径的源码摘出来，并把编译完成的 so 库文件也拿出来，放到了一个 Android Studio 工程中，相关源码路径：

AppRTC-Server

AppRTC 是 WebRTC 的一个 demo 应用，它需要和 Server 配合才能运行。这个 Server 的搭建是最令人头疼的了，不过不用担心，咱这不是有开箱即用的工具嘛： piasy/apprtc-server 。

pull 镜像：

docker pull piasy/apprtc-server

运行 Docker 镜像：

docker run --rm \
  -p 8080:8080 -p 8089:8089 -p 3478:3478 -p 3033:3033 \
  --expose=59000-65000 \
  -e PUBLIC_IP=<server public IP> \
  -v <path to constants.py>:/apprtc_configs \
  -t -i piasy/apprtc-server

运行之后，在 Android demo 的设置界面中，把 Server 地址设置为 http://<server public IP>:8080 ，demo 即可成功跨网视频通话。很多人自己部署完服务器之后发现，只能在同一 WiFi 下通话，跨 WiFi 就不行了。大家放心，咱们可没这个问题 :)

AppRTC-Server 部署简介

开箱即用当然好，不过这里我也把构建过程中遇到的一些问题分享出来，希望对大家有所帮助。

AppRTC 需要三个 Server：

Room Server: 负责处理加入房间、获取配置等请求；
Signal Server: 长连接服务器，用于聊天过程中实时下发信息；
TURN/STUN Server: 打洞服务器，用于 NAT 打洞；

Room Server 和 Signal Server 都在 apprtc 这个项目中，部署说明很详细，需要注意的是关于 TURN/STUN Server 的配置问题：

AppRTC Android demo 中，会尝试从房间配置中读取 pc_config 域，以取得 TURN/STUN Server 信息；如果没有获取到，就会向配置中的 ice_server_url 指向的服务器获取 TURN/STUN Server 信息。但 apprtc 的配置说明中，让我们把 TURN/STUN Server 配置写在 TURN_SERVER_OVERRIDE 中，这是不行的，因为客户端的逻辑并不会读取 TURN_SERVER_OVERRIDE 这个域，此外 Android demo 读取 pc_config 的代码中，无法正确把 TURN Server 的用户名解析出来，所以我们不得不自己搭一个 ICE Server，尽管这会多一次网络请求，不过用于测试也没啥问题。最后，这里是示例的 constants.py 地址。

因此我们还需要第四个 Server：ICE Server。它用于下发 TURN/STUN Server 配置信息，代码如下（nodejs）：

var express = require('express')
var crypto = require('crypto')
var app = express()

var hmac = function (key, content) {
  var method = crypto.createHmac('sha1', key)
  method.setEncoding('base64')
  method.write(content)
  method.end()
  return method.read()
}

app.get('/iceconfig', function (req, resp) {
  var query = req.query
  var key = '4080218913'
  var time_to_live = 600
  var timestamp = Math.floor(Date.now() / 1000) + time_to_live
  var turn_username = timestamp + ':ninefingers'
  var password = hmac(key, turn_username)

  return resp.send({
    iceServers: [
      {
        urls: [
          'turn:ICE_SERVER_ADDR:3478?transport=udp',
          'turn:ICE_SERVER_ADDR:3478?transport=tcp',
          'turn:ICE_SERVER_ADDR:3479?transport=udp',
          'turn:ICE_SERVER_ADDR:3479?transport=tcp'
        ],
        username: turn_username,
        credential: password
      }
    ]
  })
})

app.listen('3033', function () {
  console.log('server started')
})

几点说明：

这里面有两个配置写死了： key = '4080218913' ，用户名 ninefingers ，它们都是在部署 Coturn 时配置的；
username / credential 并不是 Coturn 创建用户的 username/password，而是按照上述逻辑计算出来的值，否则 Coturn 会报错 401 Unauthorized；
上面的 ICE Server 部署之后，Android demo 请求时会报 404，最终定位是因为 demo 用 HttpURLConnection 时设置了 connection.setDoOutput(true); ，注释掉就好了，详见这个 commit ；

四个 Server 都部署好之后，就可以开心的开始视频聊天啦！

最后再解释一下 Docker 镜像开放的端口：

8080 用于 Room Server；
8089 用于 Signal Server；
3033 用于 ICE Server；
3478 和 59000-65000 用于 TURN/STUN Server；

← Previous Post

以上所述就是小编给大家介绍的《开箱即用的 WebRTC 开发环境》，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对码农网的支持！

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

Think Python

Allen B. Downey / O'Reilly Media / 2012-8-23 / GBP 29.99

Think Python is an introduction to Python programming for students with no programming experience. It starts with the most basic concepts of programming, and is carefully designed to define all terms ......一起来看看《Think Python》这本书的介绍吧!

码农工具