setVideoCaptureRotation abstract method

Future<int?> setVideoCaptureRotation(
  1. VideoRotation rotation
)

设置本端采集的视频帧的旋转角度

v3.57 新增。

当外接摄像头倒置或者倾斜安装,且不支持重力感应时,调用本接口对采集画面角度进行调整。
对于手机等支持重力感应的移动设备,需调用 RTCVideo.setVideoRotationMode 实现旋转。

rotation:相机朝向角度,默认为 rotation0(0),无旋转角度。

返回值:

  • 0:调用成功;
  • <0:调用失败,具体原因参看 ReturnStatus

注意:

  • 对于内部采集的视频画面,如果已调用 RTCVideo.setVideoRotationMode 设置了旋转方向,会在此基础上叠加旋转角度。
  • 视频贴纸特效或通过 RTCVideoEffect.enableVirtualBackground 增加的虚拟背景,也会跟随本接口的设置进行旋转。
  • 本地渲染视频和发送到远端的视频都会相应旋转,但不会应用到单流转推中。如果希望在单流转推的视频中应用旋转,调用 RTCVideo.setVideoOrientation

Implementation

Future<int?> setVideoCaptureRotation(VideoRotation rotation);