蘑菇视频ios横屏切换时网络适配设置2个关键点（少一个都不顺）
横屏切换看视频是常见需求，但如果在切换过程中忽略网络适配，小概率的卡顿、重新加载或清晰度突降会极大影响体验。针对蘑菇视频在 iOS 上横屏切换场景，实践中把注意力集中在下面两个关键点，能让切换平滑且网络资源高效利用。
关键点一：保持播放会话连续并复用网络资源
- 核心思路：横屏切换时不要重新创建播放会话或重复发起拉流，保留同一 AVPlayer/AVPlayerItem 实例，把显示层从竖屏视图搬到横屏视图或把播放器放到统一容器里。这样能复用已经建立的 TCP/HTTP/TLS 链接、保留已缓冲数据、避免重新走鉴权或获取播放地址的流程。
- 要点实现：
- 使用单例或共享的播放器管理类，存放 AVPlayer。
- 切换 UI 时只移动 AVPlayerLayer（或 AVPlayerViewController 的子视图），不要销毁 player。
- 如果必须切换到另一个 ViewController，传递同一个 AVPlayer 引用，而非重建 new AVPlayer(url:)。
- 示例（Swift，简化版）：
- 播放器管理器： let sharedPlayer = AVPlayer(url: url)
- 在竖屏/横屏视图中： playerLayer.player = PlayerManager.shared.player view.layer.addSublayer(playerLayer)
- 横竖屏切换只调整 playerLayer.frame 与父视图，不释放 player。
- 常见问题：
- 如果每次都创建新 player，会导致重新请求播放地址、重新进行 HLS 变码选择，出现短暂黑屏或清晰度回退。
- 注意在移动 playerLayer 时管理好 KVO 观察（比如 AVPlayerItem.status）与通知，避免重复注册/注销。
关键点二：基于网络状况动态调整码率与缓冲策略
- 核心思路：横屏往往意味着用户期望更高观看质量（更大屏幕），但带宽和网络波动并未随之改变。通过网络感知和播放器侧的码率/缓冲策略调整，在可用带宽范围内提升清晰度或优先稳定性，避免切换时出现突降或频繁抖动。
- 可调参数与策略：
- AVPlayerItem.preferredPeakBitRate：设置期望上限码率（单位 bps）。在 Wi‑Fi 且网络良好时适当提高；在移动网络或弱网下降低。
- AVPlayer.automaticallyWaitsToMinimizeStalling：开启可在低带宽时允许播放器延缓播放以减少卡顿；根据体验选择 true/false。
- preferredForwardBufferDuration（iOS 10+）：控制预缓冲时长，横屏可适度增加以换取稳定播放。
- 网络检测与决策：
- 使用 NWPathMonitor 或 Reachability 检测当前网络类型与变化。
- 横屏切换时读取当前网络状态并做一次策略调整：例如 Wi‑Fi + good -> preferredPeakBitRate = 0（允许最高）；蜂窝或差 -> 限制为 800000 ~ 1500_000 bps。
- 监听 AVPlayerItem 的 playbackLikelyToKeepUp、playbackBufferEmpty 等状态，发生卡顿时降码率或增加缓冲时长。
- 示例逻辑（伪码）： monitor.pathUpdateHandler = { path in if path.usesInterfaceType(.wifi) { player.currentItem?.preferredPeakBitRate = 0 // 让 HLS 自适应到高质量 player.automaticallyWaitsToMinimizeStalling = true } else { player.currentItem?.preferredPeakBitRate = 1000000 player.automaticallyWaitsToMinimizeStalling = false } }
- 注意：
- 对 HLS 来说 preferredPeakBitRate 是建议值，播放器仍会在运行时基于实际带宽切换分段。不要把 preferredPeakBitRate 设置得过高导致客户端持续尝试高码率并引发重缓冲。
- 横屏短时间内频繁切换策略会带来抖动，做一次平滑判断（例如 2s 内稳定）再调整比立刻频繁改更稳妥。
测试清单（上线前必做）
- 横屏/竖屏切换路径：全屏切换、内联切换、从列表点击进入全屏，确保都不重建 player。
- 网络切换测试：Wi‑Fi → 蜂窝、良好蜂窝 → 差蜂窝，观察是否平滑降码率并减少卡顿。
- 首次进入与重复进入对比：确认第一次的缓冲与第二次进入的行为一致且不会重复发起耗时鉴权。
- 低内存场景：模拟内存紧张时是否被系统回收 player，若被回收需在回收策略中保留关键 Session（或平滑恢复逻辑）。
- 日志与指标：记录每次横屏切换时的 currentBitrate、bufferDuration、networkType，便于定位问题。
常见坑与解决办法
- 横屏时重新创建播放器导致播放地址重复鉴权：把获取播放地址的逻辑与播放器创建分离，优先用缓存地址或延续 session。
- 直接销毁 AVPlayer 导致已分配的网络连接断开：改为隐藏播放器并保留实例，或在切换前将播放器从旧 layer 移除再挂载到新 layer。
- 盲目提高 preferredPeakBitRate 导致频繁卡顿：先检测带宽，分阶段提升，给播放器一点时间自适应。
结语 把“会话连续性”和“网络感知的码率/缓冲调整”作为横屏切换的两大策略，能显著减少卡顿与清晰度突降，提升蘑菇视频用户的观看体验。按照上面实现要点和测试清单逐一验证，绝大多数横屏相关的网络问题都能被平稳化处理。