iOS 屏幕旋转的实践解析——下篇

ZEGO即构科技

企业官方账号

2021-09-13 18:39:38

三、相关问题

在开发旋转场景的需求的时候，由于复杂的多级配置和数目繁多的枚举类型，难免会遇到一些崩溃和无法旋转的问题，下面我们就来总结一下此类问题。

问题一：无法自动旋转

首先检查下系统屏幕旋转开关是否被锁定。系统屏幕锁定开关打开后，应用内无法自动旋转，但是可以调用上文提到的的方法进行手动旋转。

问题二：多级屏幕旋转控制设置错误

以下方法都可以设置屏幕旋转的全局权限：

Device Orientation 属性配置：“TARGETS > General > Deployment Info > Device Orientation”，图中是 xcode 默认的配置，值得注意的是 iPhone 不支持旋转到 Upside Down 方向。

Appdelegate的 supportedInterfaceOrientationsForWindow 方法：

// 返回需要支持的方向
// 如果我们实现了Appdelegate的这一方法，那么我们的App的全局旋转设置将以这里的为准
- (UIInterfaceOrientationMask)application:(UIApplication *)applicatio supportedInterfaceOrientationsForWindow:(nullable UIWindow *)window {
    return UIInterfaceOrientationMaskLandscapeRight | UIInterfaceOrientationMaskLandscapeLeft | UIInterfaceOrientationMaskPortrait;
}

以上两种方式优先级：Appdelegate方法 > Target配置，这两种方式的配置和控制器的 supportedInterfaceOrientations 方法都会影响最终视图控制器最终支持的方向。以 iOS 14 中以 present 打开控制器的方式为例，当前控制器最终支持的屏幕方向，取决于上面两种方式中的优先级最高的方式的值，与控制器 supportedInterfaceOrientations 的交集。

总结起来有以下几种情况：

如果交集为空，且在控制器的 shouldAutorotate 方法中返回为 YES，则会发生UIApplicationInvalidInterfaceOrientation 的崩溃。
如果交集为空，且在控制器的 shouldAutorotate 方法中返回为 NO，控制器的supportedInterfaceOrientations 方法与 preferredInterfaceOrientationForPresentation 方法返回值不冲突（前者返回值包含有后者返回值），则显示为控制器配置的方向。
如果交集为空，且在控制器的 shouldAutorotate 方法中返回为 NO，控制器的supportedInterfaceOrientations 方法与 preferredInterfaceOrientationForPresentation 方法返回值冲突（前者返回值未包含有后者返回值），则会发生 UIApplicationInvalidInterfaceOrientation 的崩溃。
如果交集不为空，控制器的 supportedInterfaceOrientations 方法与 preferredInterfaceOrientationForPresentation 方法返回值冲突，则会发生 UIApplicationInvalidInterfaceOrientation 的崩溃。
如果交集不为空，控制器的 supportedInterfaceOrientations 方法与 preferredInterfaceOrientationForPresentation 方法返回值不冲突，当前控制器则根据 shouldAutorotate 返回值决定是否在交集的方向内自动旋转。

这里建议如果没有全局配置的需求，就不要变更 Target 属性配置或实现 Appdelegate 方法，只需在要实现旋转效果的 ViewController 中按前面所说的方式去实现代码。

问题三：横屏时打开系统锁定屏幕开关，视图被强制恢复到竖屏

由于 iOS 闭源，苹果为什么会这样操作当然我们也无从得知，但是我们可以通过一些手段来规避这个问题。好在产生这样的旋转时，系统也会触发和普通旋转时一样的方法调用。

以 iPhone X 为例，当下拉打开控制页面时，我们会收到 UIApplicationWillResignActiveNotification 的系统通知，收起控制页面后会收到 UIApplicationDidBecomeActiveNotification 通知，通过这两个通知来记录一下状态，在 shouldAutorotate 通过判断是否是 Active 状态返回 YES/NO。

- (void)setupNotification {
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(applicationWillResignActive:)
                                                 name:UIApplicationWillResignActiveNotification object:nil];
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(applicationDidBecomeActive:)
                                                 name:UIApplicationDidBecomeActiveNotification object:nil];
}


- (BOOL)shouldAutorotate {
    if (!self.isApplicationActive) {
            return NO;
        } else {
            return YES;
        }
    }
}

问题四：屏幕旋转与 ZegoExpressEngine 的适配

有很多小伙伴已经接入了我们的 ZegoExpressEngine 实时音视频引擎，那么在旋转的场景中你就要考虑到旋转对推拉流的影响，以 RoomKit SDK 的使用场景为例，大致有以下几种情况：

当前页面固定一个方向显示，只需要设置与当前方向符合的视频分辨率（引擎默认值为 “360 × 640”,根据自己需求确定），再调用引擎的 setAppOrientation 接口设置当前方向，以下代码以左横屏方向为例：

ZegoVideoConfig *videoConfig = [[ZegoVideoConfig alloc] init];
// 左横屏分辨率设置如下：
videoConfig.encodeResolution = CGSizeMake(1280, 720);
[[ZegoExpressEngine sharedEngine] setVideoConfig:videoConfig];
// 调用 setAppOrientation 接口设置视频的朝向
[[ZegoExpressEngine sharedEngine] setAppOrientation:UIInterfaceOrientationLandscapeLeft];

当前页面有旋转的场景，这时就需要在旋转完成后去更新 ZegoExpressEngine 引擎的方向和视频分辨率，注意这里的当前方向取的是当前状态栏的方向。

// 根据当前方向设置分辨率
ZegoVideoConfig *videoConfig = [ZegoVideoConfig defaultConfig];
if (isCurPortrait) {
    videoConfig.captureResolution = CGSizeMake(720, 1280);
} else {
    videoConfig.captureResolution = CGSizeMake(1280, 720);
}
// 调用 setAppOrientation 接口设置视频的朝向
[[ZegoExpressEngine sharedEngine] setAppOrientation:[UIApplication sharedApplication].statusBarOrientation];

上面的 ZegoExpressEngine 音视频引擎屏幕旋转后的适配逻辑，处理时机都在视图控制器旋转完成后，也就是 viewWillTransitionToSize 方法的 completion block 里面，这时拿到的 [UIApplication sharedApplication].statusBarOrientation 方向与当前控制器方向符合。更多 ZegoExpressEngine 音视频引擎屏幕旋转问题可以参考：https://doc-zh.zego.im/article/4823?w=

四、相关枚举值

在前面的讲述中，我们也认识了一些与屏幕旋转相关的枚举值。乍一看这块内容确实会感觉多得让人眼花缭乱，但是我们看清楚他们名称中的关键词如：Device、Interface，并在各个枚举类型用到的地方去理解它的意思，也是能理清这里面的逻辑的。

1、设备方向：UIDeviceOrientation

UIDeviceOrientation 是以 home 键的位置作为参照，受传感器影响，和当前屏幕显示的方向无关，所以只能取值不能设值。

typedef NS_ENUM(NSInteger, UIInterfaceOrientation) {
    UIInterfaceOrientationUnknown            = UIDeviceOrientationUnknown,
    UIInterfaceOrientationPortrait           = UIDeviceOrientationPortrait,
    UIInterfaceOrientationPortraitUpsideDown = UIDeviceOrientationPortraitUpsideDown,
    UIInterfaceOrientationLandscapeLeft      = UIDeviceOrientationLandscapeRight,
    UIInterfaceOrientationLandscapeRight     = UIDeviceOrientationLandscapeLeft
} API_UNAVAILABLE(tvos);

前面讲述的屏幕旋转方法中不会直接用到这个枚举，但是如果你有监听设备当前方向的需求时，它就变得有用了。可以通过 [UIDevice currentDevice].orientation 获取当前设备的方向，若要监听设备的方向变化，可以用以下代码实现：

[[UIDevice currentDevice] beginGeneratingDeviceOrientationNotifications];
 [[NSNotificationCenter defaultCenter] addObserver:observer
                                          selector:@selector(onDeviceOrientationChange:)
                                              name:UIDeviceOrientationDidChangeNotification
                                            object:nil];

2、页面方向：UIInterfaceOrientation

UIInterfaceOrientation 是当前视图控制器的方向，区别于设备方向，它是屏幕正在显示的方向，preferredInterfaceOrientationForPresentation 方法的返回值就是这个枚举类型。

/// 优先的屏幕方向
- (UIInterfaceOrientation)preferredInterfaceOrientationForPresentation {
    return UIInterfaceOrientationPortrait;
}

注意 UIInterfaceOrientationLandscapeLeft 与 UIDeviceOrientationLandscapeRight 是对应的，这两个枚举类型左右相反。

typedef NS_ENUM(NSInteger, UIInterfaceOrientation) {
    UIInterfaceOrientationUnknown            = UIDeviceOrientationUnknown,
    UIInterfaceOrientationPortrait           = UIDeviceOrientationPortrait,
    UIInterfaceOrientationPortraitUpsideDown = UIDeviceOrientationPortraitUpsideDown,
    UIInterfaceOrientationLandscapeLeft      = UIDeviceOrientationLandscapeRight,
    UIInterfaceOrientationLandscapeRight     = UIDeviceOrientationLandscapeLeft
} API_UNAVAILABLE(tvos);

3、页面方向：UIInterfaceOrientationMask

观察 UIInterfaceOrientationMask 枚举的值，我们就会发现这是一种为了支持多种UIInterfaceOrientation 而定义的类型，它用来作为 supportedInterfaceOrientations 方法的返回值，比如我们在该方法中返回 UIInterfaceOrientationMaskAll 就可以支持所有方向了。

/// 当前 VC支持的屏幕方向
- (UIInterfaceOrientationMask)supportedInterfaceOrientations {
    return UIInterfaceOrientationMaskAll;
}

typedef NS_OPTIONS(NSUInteger, UIInterfaceOrientationMask) {
    UIInterfaceOrientationMaskPortrait = (1 << UIInterfaceOrientationPortrait),
    UIInterfaceOrientationMaskLandscapeLeft = (1 << UIInterfaceOrientationLandscapeLeft),
    UIInterfaceOrientationMaskLandscapeRight = (1 << UIInterfaceOrientationLandscapeRight),
    UIInterfaceOrientationMaskPortraitUpsideDown = (1 << UIInterfaceOrientationPortraitUpsideDown),
    UIInterfaceOrientationMaskLandscape = (UIInterfaceOrientationMaskLandscapeLeft | UIInterfaceOrientationMaskLandscapeRight),
    UIInterfaceOrientationMaskAll = (UIInterfaceOrientationMaskPortrait | UIInterfaceOrientationMaskLandscapeLeft | UIInterfaceOrientationMaskLandscapeRight | UIInterfaceOrientationMaskPortraitUpsideDown),
    UIInterfaceOrientationMaskAllButUpsideDown = (UIInterfaceOrientationMaskPortrait | UIInterfaceOrientationMaskLandscapeLeft | UIInterfaceOrientationMaskLandscapeRight),
} API_UNAVAILABLE(tvos);