多方视频通话
功能介绍
多方视频通话时,根据当前业务场景合理设置视频编码参数,可以在较低的带宽占用下实现流畅清晰的音视频沟通,下面将针对几种常见场景进行介绍。
1.一对一
- 画中画布局示例图:
视频通话中,画中画布局指视频图像布局上有重叠。只需控制ui组件的父盒子z-index属性即可

常用于如双人视频聊天场景,双方通常都希望看到对方比较清晰的视频,此时可以使用较高的视频编码分辨率,比如720P或480P。
- 示例代码:
//在json中声明SDK组件,需定位到对应目录
{
"usingComponents": {
"RTCVideoPlayer": "/utils/RTCSDK/components/RTCVideoPlayer/RTCVideoPlayer",
"RTCVideoPusher": "/utils/RTCSDK/components/RTCVideoPusher/RTCVideoPusher",
"RTCAudioPlayer": "/utils/RTCSDK/components/RTCAudioPlayer/RTCAudioPlayer",
}
}
<!--wxml代码-->
<view class="father">
<!-- 组件宽高会根据父元素宽高继承 -->
<!-- 音视频推流组件 userInfo传入成员信息,config传入配置信息,debug是否开启调式,详细请参考组件文档 -->
<RTCVideoPusher class="video-pusher" config='{{RTCVideoPusher}}'></RTCVideoPusher>
<RTCVideoPlayer class="video-player" config='{{RTCVideoPlayer}}'></RTCVideoPlayer>
</view>
<!-- 音频拉流组件 -->
<RTCAudioPlayer config='{{RTCAudioPlayer}}'></RTCAudioPlayer>
.father {
width: 100vw;
height: 100vh;
position: relative;
}
.father .video-pusher {
position: absolute;
z-index: 2;
bottom: 0;
right: 0;
width: 234rpx;/* 宽高比为9:16 */
height: 416rpx;
}
.father .video-player {
width: 100%;
height: 100%;
}
//js部分:
//音视频推流组件配置
const RTCVideoPusher = {
aspect: '9:16', // 宽高比,可选值有 3:4, 9:16
muted: false, //默认静音,此属性不支持动态修改,如需开关麦克风请调用api
enableCamera: true, //默认打开摄像头,此属性不支持动态修改,如需开关摄像头请调用api
}
//视频拉流组件配置
const RTCVideoPlayer = {
userId: 'remoteUserID', // 观看用户的userId
objectFit: 'fillCrop', // 填充模式,可选值有 contain,fillCrop
}
//音频拉流组件
const RTCAudioPlayer = {
soundMode: 'speaker', // 声音输出方式,有效值为 speaker(扬声器)、ear(听筒)
autoPauseIfNavigate: false, // 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放
autoPauseIfOpenNative: false, // 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放
}
this.setData({
RTCVideoPusher,
RTCVideoPlayer,
RTCAudioPlayer
});
相关组件请参考:
2.多方视频
- 多方视频示例图:

常用于在线教育场景,老师的视频画面比较大,可以使用较高的分辨率比如720P,下面学生的视频画面比较小,应采用较低的视频编码分辨率,比如360P或256P。
- 示例代码:
//在json中声明SDK组件,需定位到对应目录
{
"usingComponents": {
"RTCVideoPlayer": "/utils/RTCSDK/components/RTCVideoPlayer/RTCVideoPlayer",
"RTCVideoPusher": "/utils/RTCSDK/components/RTCVideoPusher/RTCVideoPusher",
"RTCAudioPlayer": "/utils/RTCSDK/components/RTCAudioPlayer/RTCAudioPlayer",
}
}
<!-- wxml代码 -->
<view class='father'>
<view wx:for='{{list}}' wx:key='userId' class='video {{item.mainVideo ? "mainVideo":""}}'>
<!-- 组件宽高会根据父元素宽高继承 -->
<!-- 音视频推流组件 userInfo传入成员信息,config传入配置信息,debug是否开启调式,详细请参考组件文档 -->
<RTCVideoPusher wx:if='{{item.isMyVideo}}' config='{{RTCVideoPusher}}'></RTCVideoPusher>
<RTCVideoPlayer wx:else config='{{item}}'></RTCVideoPlayer>
</view>
<!-- 音频拉流组件 -->
<RTCAudioPlayer config='{{RTCAudioPlayer}}'></RTCAudioPlayer>
</view>
/* css代码 */
.father {
padding-top: 75vh;
position: relative;
}
.father .video {
float: left;
width: 33.333%;
height: 25vh;
}
.father .video.mainVideo {
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 75vh;
}
//视频拉流组件配置
const RTCVideoPusher = {
aspect: '9:16', // 宽高比,可选值有 3:4, 9:16
muted: false, //默认静音,此属性不支持动态修改,如需开关麦克风请调用api
enableCamera: true, //默认打开摄像头,此属性不支持动态修改,如需开关摄像头请调用api
}
//视频拉流组件配置
const RTCVideoPlayer = {
objectFit: 'fillCrop', // 填充模式,可选值有 contain,fillCrop
}
//音频拉流组件
const RTCAudioPlayer = {
soundMode: 'speaker', // 声音输出方式,有效值为 speaker(扬声器)、ear(听筒)
}
let list = [];
RTCSDK.GetAllMembers().forEach(member => {
//假设老师的userID为teacher,需要放入指定的盒子
if (member.userID === 'teacher') {
member.mainVideo = true;
}
//用于区分是不是自己的信息,后续去渲染推流组件还是拉流组件
if (member.userID === 'myUserId') {
member.isMyVideo = true;
}
list.push(Object.assign(RTCVideoPlayer, {
userId: member.userID
}));
});
this.setData({
RTCVideoPusher,
RTCVideoPlayer,
RTCAudioPlayer,
list,
});
相关API请参考:
相关结构定义请参考:
相关组件请参考: