文档中心
ExpressVideoSDK 实时音视频
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 实时音视频
  • 视频能力
  • 常用视频配置

常用视频配置

更新时间:2024-02-28 14:27

功能简介

在视频通话或直播时,开发者可以根据需要指定推流和拉流视频相关配置,如视频采集分辨率、视频编码输出分辨率、视频帧率、码率、视图模式和镜像模式。

  • 分辨率:
    • 视频分辨率:用于度量图像内数据量多少的一个参数,通常表示成 ppi。
    • 采集分辨率:指摄像头等采集设备提供的画面分辨率。
    • 编码分辨率:指经过编码处理的画面的分辨率。
  • 码率:指每秒传输的比特(bit)数,单位为 bps(bit per second)。
  • 帧率:单位时间内视频显示帧数的量度单位,测量单位为“每秒显示帧数”(Frame Per Second,fps)。

设置合适的视频分辨率、帧率和码率可以在音视频场景中提供用户更好的使用体验。选择合适镜像模式与视图模式则可以让开发者提供个性化的视频显示模式。

示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 assets/topics/publish_stream/ 目录下的文件。

前提条件

在设置视频配置之前,请确保:

  • 已在 ZEGO 控制台 创建项目,并申请有效的 AppID 和 AppSign,详情请参考 控制台 - 项目信息。
  • 已在项目中集成 ZEGO Express SDK,并实现了基本的音视频推拉流功能,详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

使用步骤

修改视频配置

通过调用 setVideoConfig 接口修改视频配置,用户既可自定义参数,也可以使用预设值进行设置。

需要在推流(startPublishingStream)前或预览(startPreview)前设置好相关视频配置,在推流后仅支持编码分辨率和码率的修改。

自定义参数设置

调用 setVideoConfig 接口修改推流视频配置,可通过该接口设置视频帧率、码率、视频采集分辨率和视频编码输出分辨率。若不进行特殊设置,则 SDK 会根据选定的场景,自动应用适合该场景的分辨率、码率、帧率,以获取最佳体验效果,详情请参考 场景化音视频配置。

如果拉流端需要拉取 60 帧的流,需要联系技术支持,详情可参考 ZEGO Express SDK 是否支持拉 60 帧的流?

以设置视频采集分辨率为 360p,编码分辨率为 360p,码率为 600 kbps,帧率为 15 fps 为例:

let videoConfig = new ZegoVideoConfig()
videoConfig.captureWidth = 640
videoConfig.captureHeight = 360
videoConfig.encodeWidth = 640
videoConfig.encodeHeight = 360
videoConfig.bitrate = 600
videoConfig.fps = 15

// 设置视频配置
this.engine.setVideoConfig(videoConfig)

使用预设值设置

除自定义参数设置之外,也可以使用 ZEGO Express SDK 提供的预设组合值,ZegoVideoConfigPreset 的预设组合值如下:

ZegoVideoConfigPreset 采集分辨率
(宽 × 高)
编码分辨率
(宽 × 高)
帧率(fps) 码率(kbps)
Preset180P 320 × 180 320 × 180 15 300
Preset270P 480 × 270 480 × 270 15 400
Preset360P 640 × 360 640 × 360 15 600
Preset540P 960 × 540 960 × 540 15 1200
Preset720P 1280 × 720 1280 × 720 15 1500
Preset1080P 1920 × 1080 1920 × 1080 15 3000

调用 setVideoConfig 接口使用预设值时示例代码如下:

// 使用预设置进行视频设置
let videoConfig = new ZegoVideoConfig(ZegoVideoConfigPreset.Preset1080P)
this.engine.setVideoConfig(videoConfig)

相关文档

  • 如何选择视频分辨率、帧率、码率?
  • 怎么处理视频模糊问题?
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈