视频采集旋转

功能简介

ZEGO 针对移动端提供 4 种采集旋转模式（固定比例模式、自适应模式、对齐模式及自定义模式），以简化开发者实现多端旋转表现时面临的复杂适配问题，如摄像头角度、分辨率、自动旋转、StatusBar（状态栏）位置适配等。您可以根据旋转表现和业务场景要求，通过 setAppOrientationMode 接口配置不同模式。

固定比例模式

在固定比例模式下，视频输出方向相对 StatusBar 总是保持固定比例，视频画面比例取决于编码分辨率比例。

优势：固定比例模式适用于所有场景，也是直播场景中常用的模式。该模式在采集端已处理好视频画面的旋转，拉流端不需要额外处理，因此无直播分发渠道的兼容性问题。

编码比例为竖屏时，推流及拉流端表现如下：

• UI 固定为竖屏：

  

• UI 不锁定（启用 App 屏幕自动旋转）：

  

自适应模式

在自适应模式下，无论何种手持方式或 UI 方向，图像会总保持垂直地面向上。

优势：在自适应模式下，用户可以选择自己喜欢的手持方式进行视频通话，适用于 1v1 或多人视频的 RTC 场景，您也可以通过混流转推实现直播业务。

表现如下：

对齐模式

在对齐模式下，以 StatusBar 作为参考，播放端的视频方向与推流端预览的视频方向一致。播放端会以 StatusBar 作为参考对图像进行旋转，播放端的旋转角度和推流端预览的旋转角度一致。

优势：对齐模式与自适应模式类似，但用户可以结合自动旋转开关和手持方式，主动调整满屏或等比缩放的画面表现，适用于 1v1 或多人视频的 RTC 场景。

UI 固定为竖屏时：

UI 固定为横屏时：

UI 不锁定（启用 App 屏幕自动旋转）：

自定义模式（默认）

在自定义模式下，您可以根据需求自定义视频采集旋转的表现形式，实现方式更加灵活，具体实现步骤，请参考 如何自定义视频采集旋转方式？

实现流程

推流端

推流端需要调用 setAppOrientationMode 接口设置任意一种采集旋转模式。

this.engine.setAppOrientationMode(ZegoOrientationMode.FixedResolutionRatio);

this.engine.setAppOrientationMode(ZegoOrientationMode.Adaption);

this.engine.setAppOrientationMode(ZegoOrientationMode.Alignment);

拉流端

仅自适应模式下，拉流端需要在拉流前调用 setAppOrientationMode 接口设置自适应模式。

this.engine.setAppOrientationMode(ZegoOrientationMode.Adaption);