wild-rtc

lib-js-wildRTC

使用 Wilddog 实现的实时音视频聊天库.可使用 test.html 来测试。

引入WildRTC SDK

使用gulp搭建测试环境

下载代码到本地，并进入lib-js-wildRTC目录

git clone https://github.com/WildDogTeam/lib-js-wildRTC.git

安装 gulp，在ubuntu下使用命令

sudo npm install gulp

安装依赖

sudo npm install uglify-js
sudo npm install gulp-uglify
sudo npm install gulp-browserify
sudo npm install gulp-rename
sudo npm install gulp-connect
sudo npm install wild-peerconnection

打包成一个 js。打包后会在 lib 下生成 WildRTC.js。

gulp build

建立测试环境

gulp test

这会在本地 https://localhost:8080 建立一个 webserver，可以访问 test.html 或用户自己建立的网页。

使用 WildRTC

创建引用

要使用 WildRTC，必须先创建 WildDog 引用并登录：

var ref = new Wilddog("https://<appId>.wilddogio.com/");
ref.authAnonymously();
ref.onAuth(function(auth) {
    if (auth != null) {
        var rtc = new WildRTC(ref);
    }
}

---

加入会话

创建 WildRTC 引用之后，就可以通过join(callback) 进入会话：

wildRTC.join(callback(err));

---

监听远端媒体流

可以使用on(type,callback,cancelCallback)的事件监听来获取远端的媒体流。

wildRTC.on("stream_added",function(WildStream){
	console.log(WildStream.getId());	//结果会在 console 中打印出远端 WildStream 的 Id
})

回调函数的参数是一个 WildStream 对象类型，调用它的getStream()函数得到媒体流。上边这个例子中，stream_added这个事件会在每次收到远端 WildStream 时被触发。

同时，我们还提供stream_removed事件，用来监听远端停止发送 WildStream 的事件，并在回调函数中提供停止发送的远端WildStream 。

---

获取本地媒体流

我们提供getLocalStream(options,callback,cancelCallback)来获取本地媒体流。

wildRTC.getLocalStream(options,function(WildStream){
	console.log(WildStream.getId());	//结果会在 console 中打印出远端WildStream的Id
}, function(err){
	console.log(err);			//打印错误日志。
})

options 内容为设置获取媒体流的规格，为JSON 字符串。可以传入{"video":true|false, "audio":true|false}来设置video和audio的开启情况。回调函数中的参数为 WildStream 对象类型。

---

向远端发送媒体流

拿到WildStream后，通过addStream(wildStream)向远端其他用户发送媒体流。

wildRTC.addStream(wildStream);

---

媒体流与页面绑定

WildStream对象提供bindToDOM(elementId)快速将媒体流与页面绑定。

wildStream.bindToDOM('self_view');

更多详细接口见 docs 下的API文档。