音视频通话

多方视频通话

功能介绍

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

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 请参考:

相关结构定义请参考: