多方视频通话
功能介绍
多方视频通话时,根据当前业务场景合理设置视频编码参数,可以在较低的带宽占用下实现流畅清晰的音视频沟通,下面将针对几种常见场景进行介绍。
1.一对一
- 画中画布局示例图:

常用于如双人视频聊天场景,双方通常都希望看到对方比较清晰的视频,此时可以使用较高的视频编码分辨率,比如 720P 或 480P。
import { View, StyleSheet } from 'react-native';
import { CrVideoView, type CrUsrVideoId } from '@cr/react-native-rtc';
// 视频组件:通过 usrVideoId prop 自动绑定用户摄像头
function VideoComponent({
usrVideoId,
}: {
usrVideoId: CrUsrVideoId;
}) {
return (
<CrVideoView
usrVideoId={usrVideoId}
scaleType={0}
style={styles.video}
/>
);
}
const styles = StyleSheet.create({
video: { flex: 1 },
small: { position: 'absolute', right: 0, bottom: 0, width: 160, height: 90 },
});
// 使用:画中画布局
function PIPLayout() {
const myUserID = 'myUserID';
const otherUserID = 'otherUserID';
// 用户摄像头信息,-1表示观看默认摄像头
const myUsrVideoId: CrUsrVideoId = { userId: myUserID, videoID: -1 };
const usrVideoId: CrUsrVideoId = { userId: otherUserID, videoID: -1 };
return (
<View style={{ flex: 1 }}>
<VideoComponent usrVideoId={myUsrVideoId} />
<View style={styles.small}>
<VideoComponent usrVideoId={usrVideoId} />
</View>
</View>
);
}
// 打开摄像头 (在 videoDevChanged 之后调用)
await CrSDK.instance.openVideo(myUserID);
// 打开麦克风 (在 audioDevChanged 之后调用)
await CrSDK.instance.openMic(myUserID);
// 开启外放
await CrSDK.instance.setSpeakerOut(true);
相关 API 请参考:
相关结构定义请参考:
2.多方视频
- 多方视频示例图:

常用于在线教育场景,老师的视频画面比较大,可以使用较高的分辨率比如 720P,下面学生的视频画面比较小,应采用较低的视频编码分辨率,比如 360P 或 256P。
- 示例代码如下:
import { CrVideoView, type CrUsrVideoId, type CrVideoCfg } from '@cr/react-native-rtc';
// 获取视频的相关配置
const cfg = await CrSDK.instance.getVideoCfg();
// 配置分辨率为640x360
cfg.size = { width: 640, height: 360 };
// 配置视频帧率
cfg.fps = 25;
// 保存视频配置到SDK
await CrSDK.instance.setVideoCfg(cfg);
// 获取房间所有成员
const mems = await CrSDK.instance.getAllMembers();
const myUserID = 'myUserID';
// 老师大画面 + 学生小画面(看小流)
const teacherVideo: CrUsrVideoId = { userId: myUserID, videoID: -1 };
const studentVideos = mems
.filter((mem) => mem.userId !== myUserID)
.map((mem) => ({
usrVideoId: { userId: mem.userId, videoID: -1, qualityLv: 2 } as CrUsrVideoId & { qualityLv: number },
}));
// 渲染:大流用 qualityLv=1,小流用 qualityLv=2
// <CrVideoView usrVideoId={teacherVideo} scaleType={0} />
// <CrVideoView usrVideoId={studentVideos[0].usrVideoId} scaleType={0} />
相关 API 请参考:
相关结构定义请参考: