蘑菇视频ios播放中横竖屏我做了案例：结论很明确

蘑菇视频1132026-05-11 12:28:02

蘑菇视频 iOS 播放中横竖屏我做了案例：结论很明确

在蘑菇视频 iOS 客户端里，视频播放时横竖屏切换是用户体验的关键点。我做了多个实现方案的实际测试，覆盖原生 AVPlayer、AVPlayerViewController、以及基于 WKWebView 的 H5 播放器。下面把测试环境、遇到的问题、具体实现细节和最终结论整理出来，方便开发者和产品同学参考并直接落地。

一、测试环境与前提

iOS 版本：iOS 13、14、15、16（真机测试为主）
设备：iPhone（有刘海、无刘海）、iPad（分屏模式也测试）
播放类型：
原生 AVPlayer 嵌入 AVPlayerLayer（内嵌播放）
AVPlayerViewController（系统全屏控制）
WKWebView（H5 播放，HTML5 fullscreen API）
要求：支持从竖屏进入横屏全屏，也支持横屏退出回到页面内播放器；避免强制改变系统方向造成的闪动或状态栏错位；兼容 iPad 分屏和多任务。

二、常见问题总结

直接改变 UIDevice.orientation 或使用 UIApplication.setStatusBarOrientation（已废弃）会在不同 iOS 版本上表现不一致，且可能被拒审或引起状态栏显示异常。
AVPlayerLayer 本身不处理控制器方向，内嵌播放器切换到横屏需要父 VC 配合布局与动画，否则会出现黑边或拉伸。
AVPlayerViewController 作为系统播放器，默认处理好全屏，但在容器 VC 的 supportedInterfaceOrientations 没设置好时可能不能横屏或退出异常。
WKWebView 的 HTML5 全屏有时无法正确触发 UIViewController 的方向变化，尤其在 iPad 分屏状态下。

三、我做的案例与实现方案（实测）方案 A：推荐 —— 使用 AVPlayerViewController，模态全屏展示

思路：把播放控制交给 AVPlayerViewController，由系统管理旋转与状态栏。展示方式使用 modalPresentationStyle = .fullScreen。
关键点：

在 presenting VC 中实现 supportedInterfaceOrientations 返回想要支持的方向（通常 .allButUpsideDown 或 .portrait + .landscape）。
AVPlayerViewController 使用 present(viewController:animated:completion:) 全屏展示，退出时 dismiss。

优点：最少的兼容问题，系统动画、播放控制和控制栏自带，适配所有 iOS 版本表现稳定。
实测结论：在 iPhone 和 iPad 上体验一致，横屏进入/退出流畅，状态栏与安全区显示正常。

示例（简化 Swift）： let playerVC = AVPlayerViewController() playerVC.player = player playerVC.modalPresentationStyle = .fullScreen present(playerVC, animated: true)

方案 B：内嵌 AVPlayerLayer，需要做布局与转场动画

思路：页面内嵌播放器切换到横屏时，创建一个过渡动画，将播放器从页面中“拉出”并扩展到全屏（调整约束或使用 transform），退出时反向动画。
关键点：

使用 container view 承载 AVPlayerLayer，切换时将该 container 移动到 window 层级（addSubview 到 keyWindow）以便覆盖整个屏幕。
动画过程中更新 AVPlayerLayer 的 frame 或 layer.bounds，保持视频比例不变。
为避免系统方向冲突，页面级 supportedInterfaceOrientations 保持支持横向，实际不调用强制旋转 API。

优点：控制力强，可自定义过渡动画与 UI。
缺点：实现复杂，需要处理 safe area、刘海屏和 iPad 分屏，容易出现状态栏闪动或布局错位。对小团队维护成本高。
实测结论：如果需要高度定制化的过渡效果可以采用，但须投入大量测试与兼容代码。

方案 C：H5 播放器（WKWebView）

思路：依赖浏览器层的 fullscreen API（requestFullscreen），并配合原生容器支持方向。
关键点：

在 HTML/JS 中使用标准 API 触发全屏；在 iOS Safari 或 WKWebView 中，通常会以系统全屏方式展示。
原生需要确保 WKWebView 所在的 VC 支持横向。
在 iPad 的分屏场景下，浏览器 fullscreen 行为受限，需要额外处理。

优点：对 H5 内容友好，前端可控制交互。
缺点：跨平台差异与 iPad 分屏限制，体验不如原生稳定。
实测结论：H5 在手机上表现接近原生，但在 iPad 分屏或第三方容器里可能失效。

四、编码要点与注意事项（开发向）

Info.plist 中 Supported interface orientations 应包含需要支持的方向（避免仅在代码层修改导致不可预期）。
当使用 modal 全屏展示时，务必设置 modalPresentationStyle = .fullScreen，否则 iOS 默认的 pageSheet 可能阻止横屏或引起布局问题。
避免使用 UIDevice.current.setValue(…) 去“强制”改变设备方向，除非非常清楚其副作用并能处理可能的审核风险。
处理刘海屏与安全区域：在横屏时考虑 safeAreaInsets 的左右适配，控制层（播放控制条）不要被刘海或手势区域遮挡。
iPad 分屏：不能假设全屏可用，要检测当前 traitCollection，若处于分屏模式，给出合适提示或降级到内嵌播放体验。
退出/返回时记得还原播放器所属的 view 层级和约束，避免内存泄露与重复 addSubview。

五、我实际对比的结果一览

最稳定、开发成本低：AVPlayerViewController + modal fullScreen（推荐）
最灵活、实现复杂：自定义 AVPlayerLayer + container 转场（适合极致定制）
H5 适配：手机端可行，iPad 与分屏需谨慎处理
强制旋转（UIDevice.setValue）在部分 iOS 版本会出现状态栏或布局闪烁，可靠性不高

六、结论（明确）对于蘑菇视频这类需要兼顾稳定性与用户体验的产品，首选方案是使用 AVPlayerViewController，以模态全屏方式展示。这种做法在大多数机型和 iOS 版本上都能得到一致、流畅的体验，开发工作量和后期维护成本最低。如果产品有非常特殊的视觉或动画需求，再考虑自定义内嵌播放器和转场实现，但务必准备充足的设备与场景测试（尤其是 iPad 分屏、刘海屏与 iOS 历史版本）。

如果你需要，我可以把上面推荐方案对应的完整示例代码、关注的边界用例测试清单和一份简短的集成步骤文档发给你，方便直接拿去开发和 QA 使用。想要哪一种细节先给我说一下。