设置视频属性

更新时间: 2024/08/05 15:02:55

在视频通话前,开发者可以根据不同场景下的用户喜好与需求,对视频属性进行设置,调整发送视频画面的清晰度以及流畅度,带给用户最优的通话体验。 视频属性通常包含分辨率和帧率。

云信 Web SDK 通过 setVideoProfile 接口支持设置视频属性。在 localStream.init() 或者 localStream.open() 接口之前调用生效。

  • resolution:设置的视频分辨率。
  • frameRate:设置的视频帧率。

注意事项

  • NERTC SDK 会根据实时网络环境,对设置的参数作自适应调整,通常会下调参数。
  • 本文中各参数的设置可能会影响计费。

示例项目

网易云信在 GitHub 上提供设置视频属性的开源示例项目 VideoEncoding,您可以前往下载体验,也可以在线体验此功能。

设置视频分辨率

视频分辨率可以用来衡量视频质量,通常情况下分辨率越高,视频越清晰。 通过 resolution 参数设置视频分辨率,支持设置的模式如下:

resolution可选值 类型 说明
NERTC.VIDEO_QUALITY_180p number 视频默认分辨率 640x480
NERTC.VIDEO_QUALITY_480p number 视频低分辨率 640x480
NERTC.VIDEO_QUALITY_720p number 视频中分辨率 1280x720
NERTC.VIDEO_QUALITY_1080p number 视频高分辨率 1920x1080

设置视频帧率

视频编码帧率(fps)指是每秒钟编码多少帧画面。通过 frameRate 可以设置视频编码帧率。支持设置的值如下:

frameRate可选值 类型 说明
NERTC.CHAT_VIDEO_FRAME_RATE_5 number 视频通话帧率,最大取每秒5帧
NERTC.CHAT_VIDEO_FRAME_RATE_10 number 视频通话帧率,最大取每秒10帧
NERTC.CHAT_VIDEO_FRAME_RATE_15 number 视频通话帧率,最大取每秒15帧
NERTC.CHAT_VIDEO_FRAME_RATE_20 number 视频通话帧率,最大取每秒20帧
NERTC.CHAT_VIDEO_FRAME_RATE_25 number 视频通话帧率,最大取每秒25帧

示例代码

rtc.localStream.setVideoProfile({
  resolution: NERTC.VIDEO_QUALITY_480p,
  frameRate: NERTC.CHAT_VIDEO_FRAME_RATE_5
})

常见问题

iOS 13 和 14 版本,采集 720p 以上的视频出现异常

此文档是否对你有帮助?
有帮助
去反馈
  • 注意事项
  • 示例项目
  • 设置视频分辨率
  • 设置视频帧率
  • 示例代码
  • 常见问题