You need to enable JavaScript to run this app.
导航
视频帧朝向
最近更新时间:2024.05.14 14:49:13首次发布时间:2022.08.01 17:09:04

适用场景

移动端采集出的视频帧默认宽大于高,并包含一个旋转角信息。根据方向不同,旋转角可能为 0、90 度、180 度、270 度。

  • 在单流转推场景下,播放器在解码时无法处理角度信息,导致渲染出的视频帧没有预先转正。

  • 移动端开启视频特效,或使用自定义视频前处理时,绝大多数素材专为竖屏设置,旋转角的存在会导致贴纸显示方向和位置与预期不符。

前提条件

你已经集成了 3.44 及以上版本的 RTC SDK,并实现音视频通话功能。

功能说明

在上述特定场景下,旋转角的存在会导致显示效果与预期不符。这时可以调用 setVideoOrientation,在自定义视频处理和编码环节之前,将视频帧中的旋转角处理为 0,并在整个 RTC 链路中传递调整后的视频帧。单流转推场景下,建议根据业务需要固定视频帧朝向为 PortraitLandscape 模式。移动端开启视频特效贴纸,或使用自定义视频前处理时,建议固定视频帧朝向为 Portrait 模式。
下面列举了三种视频帧朝向的预期显示效果。图中的 Status Bar 表示移动端的系统状态栏,Sticker 表示添加的视频特效贴纸。

Adaptive 模式

如果你的 Native 端应用需要和微信小程序端互通,或使用了以下功能时,不建议使用本模式。

  • 单流转推
  • 视频特效贴纸
  • 自定义视频前处理
采集端竖屏采集端横屏
本端渲染
远端渲染

Portrait 模式

采集端竖屏采集端横屏
本端渲染
远端渲染
单流转推播放器

Landscape 模式

采集端竖屏采集端横屏
本端渲染
远端渲染
单流转推播放器

API 参考