视频画面旋转

---

1 功能简介

用户使用移动设备进行直播或视频通话时，可以采用不同的视频采集方向，ZEGO Express SDK 支持采集视频的方式如下：

固定竖屏

表示推流端固定采集以竖屏方式展示的视频，此时当对端设备方向为竖屏时，观看到的画面为充满设备屏幕的竖屏效果。当对端设备方向为横屏时，观看到的画面为相对推流端图像有一定旋转角度的效果（下图以逆时针旋转 90 度为例）。

• UI 锁定时：

  

• UI 不锁定时：

  

固定横屏

表示推流端固定采集以横屏方式展示的视频，此时当对端设备方向为横屏时，观看到的画面为充满设备屏幕的横屏效果。当对端设备方向为竖屏时，观看到的画面为相对推流端图像有一定旋转角度的效果（下图以逆时针旋转 90 度为例）。

• UI 锁定时：

  

• UI 不锁定时：

  

横竖屏切换

提供视频旋转功能，用户可以根据需要将视频相比于手机正立的方向逆时针旋转 90，180 或 270 度。便于用户结合视频场景需要，获取想要的视频渲染效果。视频旋转后会自动进行调整，以适配编码后的图像分辨率。

以上三种方式调用的接口存在差异，详细描述请参考本文的 4 使用步骤。

2 示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/pages/example/common-feature/video-rotation.nvue” 目录下的文件。

3 前提条件

在实现视频采集旋转之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

4 使用步骤

4.1 固定竖屏

使用竖屏直播或视频通话时，宽的分辨率应比高的分辨率小，假设为 “360 × 640”，则需要通过如下步骤实现功能。

1. 调用 createEngineWithProfile 接口创建 SDK 引擎实例，详情请参考 快速开始 - 实现流程 的 “3.1 创建引擎”。

//  使用从 ZEGO 控制台申请到的 appID 用于初始化
const profile = {
appID : xxx,
appSign: '39011cbxxxxxxxxxxxxx',
scenario : 0
};

ZegoExpressEngine.createEngineWithProfile(profile)

2. （可选）调用 setVideoConfig 接口设置编码分辨率，默认值为 “360 × 640”, 可以根据需要调整，若保持默认值则跳过此步骤。

竖屏直播的分辨率设置如下：

let config = { encodeWidth: 360, encodeHeight: 640 }
ZegoExpressEngine.instance().setVideoConfig(config);

3. 调用 loginRoom 接口登录房间，详情请参考 快速开始 - 实现流程 的 “3.2 登录房间”。

ZegoExpressEngine.instance().loginRoom("test_roomid", { 
    userID:"test_userid", 
    userName: "test_username" 
});

4. 使用 <zego-local-view> 标签设置本地视图，调用 startPreview 接口启动本地预览，用于显示本地画面。

<template>
    <zego-local-view style="height: 403.84rpx;flex: 1;"></zego-local-view>
</template>
<script>
import ZegoLocalView from '@/components/zego-ZegoExpressUniApp-JS/zego-view/ZegoLocalView';

export default {
   components: {
        ZegoLocalView
    },
    ...
    startPreview() {
        ZegoExpressEngine.instance().startPreview();
    }
    ...
}
</script>

5. 调用 startPublishingStream 接口开始推流，将本地的音视频流推送到实时音视频云，详情请参考 快速开始 - 实现流程 的 “3.3 推流”。

ZegoExpressEngine.instance().startPublishingStream("test_streamid");

6. 使用固定的竖屏方式进行直播或视频通话。

4.2 固定横屏

使用横屏直播或视频通话时，宽的分辨率应比高的分辨率大，假设为 “640 × 360”，则需要通过如下步骤实现功能。

1. 调用 createEngineWithProfile 接口创建 SDK 引擎实例，详情请参考 快速开始 - 实现流程 的 “3.1 创建引擎”。

//  使用从 ZEGO 控制台申请到的 appID 用于初始化
const profile = {
appID : xxx,
appSign: '39011cbxxxxxxxxxxxxxxxxxxxxx',
scenario : 0
};

ZegoExpressEngine.createEngineWithProfile(profile)

2. 调用 setVideoConfig 接口设置编码分辨率为 “640 × 360”。

let config = { encodeWith: 640, encodeHeight: 360 };

横屏直播的分辨率设置如下：

let config = { encodeWith: 640, encodeHeight: 360 };
ZegoExpressEngine.instance().setVideoConfig(config);

3. 在 App 平台调用 setAppOrientation 接口设置视频的朝向，若逆时针旋转 90 度，则如下接口传参为 ZegoOrientation.LandscapeLeft。若顺时针旋转 90 度，则传参为 ZegoOrientation.LandscapeRight。

ZegoExpressEngine.instance().setAppOrientation(ZegoOrientation.LandscapeLeft);

4. 调用 loginRoom 接口登录房间，详情请参考 快速开始 - 实现流程 的 “3.2 登录房间”。

ZegoExpressEngine.instance().loginRoom("test_roomid", { 
    userID:"test_userid", 
    userName: "test_username" 
});

5. 使用 <zego-local-view> 标签设置本地视图，调用 startPreview 接口启动本地预览，用于显示本地画面。

<template>
    <!-- #ifdef APP-PLUS -->
    <zego-local-view style="height: 403.84rpx;flex: 1;"></zego-local-view>
    <!-- #endif -->
    <!-- #ifdef H5 -->
   <video id="local_video" class="video-view" autoplay playsinline :muted="true" ></video>
    <!-- #endif -->
</template>

<script>
import ZegoLocalView from '@/components/zego-ZegoExpressUniApp-JS/zego-view/ZegoLocalView';

export default {
   components: {
        ZegoLocalView
    },
    ...
    startPreview() {
        // #ifdef APP-PLUS
        ZegoExpressEngine.instance().startPreview(document.querySelector('#local_video video'));
        // #endif
        // #ifdef APP-PLUS
        ZegoExpressEngine.instance().startPreview();
        // #endif
    }
    ...
}
</script>

6. 调用 startPublishingStream 接口开始推流，将本地的音视频流推送到实时音视频云，详情请参考 快速开始 - 实现流程 的 “3.3 推流”。

ZegoExpressEngine.instance().startPublishingStream("test_streamid");

7. 使用固定的横屏方式进行直播或视频通话。

5 常见问题

1. 为什么录制出来的直播流好像看不了？

   由于横竖屏切换时，流的编码分辨率被修改，部分第三方播放器对分辨率修改的视频兼容性不好，可能会出现播放失败的问题，因此一般不推荐在直播或视频过程中进行横竖屏切换时修改分辨率。