WilddogVideoRoom

wilddogVideo 是 WilddogVideoRoom SDK 的主入口，不能直接创建 WilddogVideoRoom 实例，必须要通过 wilddogVideo.room(roomId) 方式获取。
WilddogVideoRoom 表示一个多人的视频会话，多个用户可以加入同一个 Room 进行音视频通话。

属性

roomId

定义

var roomInstance = wilddogVideo.room(roomId)

说明

Room 的唯一标识。

方法

connect

定义

roomInstance.connect();

说明

加入 Room。

disconnect

定义

roomInstance.disconnect();

说明

离开 Room。

publish

定义

roomInstance.publish(localStream,function(error){
     if(error == null){
     	console.log('publish success');
     	localStream.attach(localEl);
     }
});

说明

发布本地媒体流。发布成功后会触发其他客户端的 stream_added 事件。

参数

参数名	说明
localStream	本地媒体流。LocalStream

unpublish

定义

roomInstance.unpublish(roomStream,function (error) {
     if(error == null){
          console.log('unpublish success');
     }
})

说明

取消发布本地媒体流。取消发布成功会触发其他客户端的 stream_removed 事件。

参数

参数名	说明
roomStream	远端媒体流。 RoomStream

定义

roomInstance.subscribe(roomStream,function (error) {
    if(error == null){
        console.log('subscribe success');
    }
})

说明

订阅在 stream_added 事件中获取的远端媒体流。订阅成功会触发本地的 stream_received 事件。

参数

参数名	说明
roomStream	远端媒体流 RoomStream

unsubscribe

定义

roomInstance.unsubscribe(roomStream,function (error) {
    if(error == null){
        console.log('unsubscribe success');
    }
})

说明

取消订阅指定的远端媒体流。

参数

参数名	说明
roomStream	远端媒体流 RoomStream

startRecording()

定义

roomInstance.startRecording(callback);

说明

使用默认录制布局并且开始服务端录制功能。

startRecording(options)

说明

设置录制布局并且开始服务端录制功能。

定义

roomInstance.startRecording(options,callback) ;

参数

选项	类型	说明	示例
fps	number	视频帧率 (fps)	15
bitrate	number	比特率 (bps)	300
canvasWidth	number	视频宽度 (<=1920)	960
canvasHeight	number	视频高度 (<=1080)	640
bgColor	number	背景颜色 (十六进制)	0xffffff
streams	Object	媒体流布局	{ “627620748239984100”: {“left”: 0 , “top”: 100, “width”: 300, “height”: 300, “zOrder”: 0-255}

对于每路需要录制的流的参数配置:

选项	类型	说明	示例
streamId	string	流ID，在一个room中，每一路流都有一个唯一流ID	627620748239984100
left	number	此路视频流相对左侧坐标	0
top	number	此路视频流相对顶部坐标	0
width	number	此路视频宽度	100
height	number	此路视频高度	150
zOrder	number	图像叠放层次顺序，高层次将遮挡低层次图像。该值越小，则叠放层次越低，该值越大，则叠放层次越高,从小到大绘制(0-255)	8

示例

var options = {
    "fps":10,
    "canvasWidth":1000,
    "canvasHeight":1000,
    "streams": {
        "627620748239984100":{"left":0,"top":100,"width":300,"height":300,"zOrder":1},
        "627620748239984101":{"left":0,"top":100,"width":300,"height":300,"zOrder":2}
    }
}
//其中"627620748239984100","627620748239984101"为具体的streamId，可以从localStream和roomStream对象中获取
roomInstance.startRecording(options,function(url,error) {
    if (error == null) {
        console.log(url)
    }
}) ;

stopRecording

定义

room.stopRecording(callback);

说明

结束服务端录制功能。

上次更新：2018-06-21