蘑菇视频ios横屏切换时后台播放如果只能做一件事：先改这里

问题描述很多开发者在处理蘑菇视频 iOS 版时遇到一个常见问题：在横屏播放视频并切换到后台时，音视频播放被系统中断。大家常常试图从界面、播放器生命周期、布局等方向排查，结果走了很多弯路。实际上，如果只能做一件事，就先改这一项：AVAudioSession 的类别并开启后台音频权限。

为什么先改这一步 iOS 对后台播放有严格控制。即便播放器本身在前台能正常播放，系统仍然会在应用进入后台时暂停视频，除非你的应用声明了能在后台播放音频并正确配置了音频会话。把 AVAudioSession 设置为能在后台播放的类别，并在 Xcode 中打开“Background Modes → Audio, AirPlay, and Picture in Picture”，这是让横屏视频在切后台后继续输出音频的最关键一步。许多其他设置都无法替代这一点。

操作步骤（一步到位） 1）在 Xcode 中打开后台权限

Target → Signing & Capabilities → + Capability → Background Modes
勾选 “Audio, AirPlay, and Picture in Picture”

2）在代码里配置 AVAudioSession（建议放在 AppDelegate 或播放器初始化的早期）示例（Swift）： import AVFoundation

do { try AVAudioSession.sharedInstance().setCategory(.playback, mode: .moviePlayback, options: []) try AVAudioSession.sharedInstance().setActive(true) } catch { print("AVAudioSession 配置失败：(error)") }

说明：

category 选择 .playback，能够在静音键下继续播放并让音频在后台继续输出。
mode 可选 .moviePlayback，有助于优化视频场景下的行为。
必须调用 setActive(true) 激活会话。

3）若想支持画中画（Picture in Picture）

在 Background Modes 中已经勾选后，还需要使用 AVPictureInPictureController 来触发 PiP。
PiP 能在支持的设备上在进入后台时继续显示小窗播放，提升用户体验。

4）横屏与界面支持（避免影响后台播放）

确保 Info.plist 或工程设置中支持横竖屏的方向包含你需要的方向。
ViewController 的 supportedInterfaceOrientations 与 UI 界面协调，避免因强制旋转逻辑在切后台时导致播放器被销毁或重置。

5）网页或嵌入的 WebView 注意点

如果播放器是通过 WKWebView 或 HTML5 video 实现，需在配置中允许内联播放（allowsInlineMediaPlayback = true）并在 video 标签上设置 playsinline。
即便如此，后台播放仍需原生 AVAudioSession + 后台权限的配合，否则系统可能仍会中断。

测试与排查要点

在真机上测试。模拟器不能可靠模拟后台播放行为。
上拉 Control Center 或锁屏界面查看是否有正在播放的媒体控制（显示应用名、进度）。
若没有，检查控制台是否有 AVAudioSession 错误日志（例如权限或冲突）。
避免将 category 设置为 .ambient（会受静音开关影响），需要忽略静音请用 .playback。
如果应用同时被其他音频源打断，考虑处理 AVAudioSession 的中断回调并适时恢复。

常见误区

只在 Info.plist 打开后台 Modes 而不设置 AVAudioSession：无效。
以为 VideoLayer 存在就能在后台继续画面播放：iOS 不允许后台持续渲染视频画面，最多是音频继续输出或启用 PiP。
在 App 进入后台时销毁播放器或停止会话：这会直接导致播放中断。把会话生命周期管理放在不会被释放的地方（如 AppDelegate 或长期持有的播放器管理对象）。

快速检查清单（发布前）