视频采集旋转方向--实时音视频-火山引擎

文档中心

实时音视频

请输入

视频管理

视频采集旋转方向

适用场景

使用移动端进行视频通话时，可能发生横竖屏切换，为了提供更好的观看体验，需要根据用户使用场景，对视频旋转方向进行相应设置，防止出现视频画面发生方向颠倒等问题。

前提条件

你已经集成 v3.36 或更高版本的 RTC SDK，实现了基本的音视频通话。
支持渲染功能的 SDK 详见API 参考。

名词解释

App 方向：App 方向即系统 UI 方向。App 的方向取决于开发者是否锁定 UI 以及用户是否关闭屏幕自动旋转。
重力方向：通过移动端设备内置的重力传感器，获取地球的重力方向数据。
Status Bar：移动端的系统状态栏，始终位于 App 界面上方。当 App 方向改变时，系统状态栏的位置也会改变。
屏幕自动旋转开关：打开时， App 方向和系统状态栏的位置将跟随设备旋转，用户可以在移动端系统控制栏中进行操作。
UI 锁定：由开发者进行设置。UI 锁定时，即使用户打开屏幕自动旋转，也无法旋转；不锁定时，App 方向将跟随设备旋转。

功能说明

采集端采集和发送的视频帧，包括对视频帧进行旋转角度的信息。接收端渲染视频时，将按照与采集端相同的方式进行旋转。
我们提供 setVideoRotationMode，在内部采集时设置旋转模式，约定旋转方向的参考系。旋转方向的参考系可以设置为 App 方向（默认）或重力方向。
接收端可以调用setRemoteVideoCanvas调整视频帧的渲染模式，以下以fit填充模式为例。在该模式下，SDK 不会对采集到的图像进行裁剪。

作用范围

对前置摄像头、后置摄像头均有效。
对共享屏幕和自定义视频采集无效。
接收端的视频方向与录制、合流转推中的方向一致。

当 UI 不锁定且屏幕自动旋转开启时

此时两种旋转模式下接收端表现一致。

采集端	接收端

当设置 UI 锁定或关闭屏幕自动旋转时

此时不同旋转模式的表现如下：

图示以接收端 UI 不锁定且屏幕自动旋转开启为例。接收端 UI 锁定或关闭屏幕自动旋转时，视频画面与状态栏的相对位置保持不变。

采集端	接收端（采集端设置旋转模式为 App 方向）	接收端（采集端设置旋转模式为重力方向）

功能实现

java

swift

// 开启视频采集
rtcEngine.startVideoCapture();
// 设置旋转模式
rtcEngine.setVideoRotationMode(VideoRotationMode.FOLLOW_APP);

注意事项

当 UI 锁定或自动旋转关闭，旋转模式设置为重力方向时，镜像功能沿设备握持方向左右翻转；旋转模式设置为 App 方向时，镜像功能沿 App 方向左右翻转。镜像功能的开启和使用参看镜像。
当视频帧朝向固定为 Portrait 或 Landscape 模式以后，因为 App 方向或者重力方向变化导致视频帧发生旋转时，本端贴纸特效的位置保持不变。

示例项目

参考以下项目获取完整代码。

API 参考

Android	iOS	Unity
setVideoRotationMode	setVideoRotationMode:	SetVideoRotationMode

最近更新时间：2026.06.15 21:21:28

这个页面对您有帮助吗？

有用

无用

实时音视频

适用场景 #

前提条件 #

名词解释 #

功能说明 #

作用范围 #

当 UI 不锁定且屏幕自动旋转开启时 #

当设置 UI 锁定或关闭屏幕自动旋转时 #

功能实现 #

注意事项 #

示例项目 #

API 参考 #