音视频通话

视频推流质量配置

功能介绍

本节介绍如何配置视频编码相关参数(分辨率、帧率、码率等)以及如何按「全局/单设备」两种粒度进行配置。

注意:

成功进入房间后,才可以进行视频推流质量配置。

1. 本地视频全局配置(setVideoCfg)

本地视频全局配置作用于本端视频的默认编码参数;当某个视频设备未设置「私有配置」时,会使用本地视频全局配置。

VideoCfg cfg = RTCMeeting.getInstance().getVideoCfg();

// 设置分辨率为 1280×720
cfg.size = new Size(1280, 720);
cfg.fps = 15;

RTCMeeting.getInstance().setVideoCfg(cfg);

VideoCfg 字段说明参见 VideoCfg。

相关 API 请参考:

2. 单个视频设备私有配置(setLocVideoAttributes)

若希望对某一路视频设备(某个 videoID)单独设置编码参数,可使用私有配置:

short videoID = ...; // 从 getAllVideoInfo 获取
VideoAttributes attrs = RTCMeeting.getInstance().getLocVideoAttributes(videoID);
attrs.size = new Size(1280, 720);
attrs.fps = 15;
RTCMeeting.getInstance().setLocVideoAttributes(videoID, attrs);

私有配置未设置时,将自动使用全局配置。

相关 API 请参考:

3. 保持视频显示比例

使用 VideoUIView 显示视频时,建议保持视频比例,否则容易产生变形:

VideoUIView videoView = findViewById(R.id.video_view);
videoView.setScaleType(VideoUIView.SCALE_TYPE_FITXY);

相关 API 请参考:

4. 限制与注意

  • 分辨率、码率等限制与帐号授权有关。
  • 开启更大分辨率、码率时将增加 CPU、带宽开销,建议按需设置。