视频帧朝向

适用场景

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

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

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

前提条件

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

功能说明

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

Adaptive 模式

不建议在此模式下使用单流转推、视频特效贴纸、自定义视频前处理。

	采集端竖屏	采集端横屏
本端渲染
远端渲染

Portrait 模式

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

Landscape 模式

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

API 参考

• Android

  • setVideoOrientation

• iOS

  • setVideoOrientation: