wild-rtc
v0.1.0
Published
webrtc with wilddog support
Downloads
2
Readme
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文档。