蘑菇视频切换网络时横竖屏设置7个关键点（少一个都不顺）
蘑菇视频切换网络时横竖屏设置7个关键点（少一个都不顺）
在观看视频时，从Wi‑Fi切换到移动数据或从4G切回Wi‑Fi，常会遇到横竖屏意外切换、全屏被打断、播放界面布局错位等问题。下面列出7个关键点，覆盖用户角度的快速修复和开发者角度的稳健实现，按点逐项排查，通常能迅速定位并解决问题。
- 应用内的横竖屏锁定与自动旋转优先级
- 用户端：检查蘑菇视频内是否有“屏幕锁定”或“自动旋转”选项。有些视频播放器提供内部锁定（比如“锁定当前方向”），开启后能避免因系统旋转或网络切换触发布局重绘导致方向变化。
- 开发端：明确应用内设置优先级，内部锁定应覆盖系统自动旋转。处理好 Activity/Fragment 的方向请求，避免在网络事件回调中无条件调用 setRequestedOrientation 导致冲突。
- 系统自动旋转权限与屏幕方向策略
- 用户端：确认系统级“自动旋转”已开启（安卓：快捷设置开关；iOS：控制中心方向锁）。某些厂商定制系统或省电模式会临时禁用自动旋转，切换网络时可能触发状态变化。
- 开发端：在关键播放界面监听系统旋转设置变化，必要时提示用户或适配不同策略。避免在网络切换回调中误判系统旋转状态从而导致界面闪烁。
- 网络切换时的播放状态与缓冲策略
- 问题来源：网络切换会导致缓冲中断、播放器重建或重新请求流，重建流程如果没有保留当前方向状态，会让界面回到默认布局。
- 建议做法：实现无缝切换策略——在切换过程中保留当前播放位置、方向和全屏状态，先暂停或静默切换数据流，待连接稳定后再恢复。采用自适应码率（ABR）可减少重连耗时。
- 横竖屏适配的UI布局与约束
- 问题来源：不同方向使用不同布局文件或约束，重绘过程若未同步方向状态会造成元素错位或全屏失效。
- 建议做法：尽量使用单一可伸缩布局（ConstraintLayout、Auto Layout 等），在代码中通过约束或属性切换而非完全重建视图。全屏与非全屏的切换逻辑应与方向状态解耦：例如先处理方向，再处理 UI 显示与隐藏。
- 全屏逻辑与沉浸式体验保留
- 问题来源：切换网络时系统栏或状态栏可能闪现，导致视频缩小或布局变更。
- 建议做法：在切换过程中保留沉浸式标志（隐藏状态栏、导航栏），并在短时间内抑制不必要的 UI 重新计算。对于需要重新创建 Surface 的播放器，确保在重建后恢复全屏标志与布局参数。
- 播放器生命周期与状态保存（避免重启造成方向丢失）
- 开发端要点：网络变化可能触发 Activity 重建（例如低内存或系统策略）。务必在 onSaveInstanceState / ViewModel 中保存播放位置、播放速率、是否全屏与锁定方向等关键状态，在重建时优先恢复这些值。
- 对用户的建议是保持应用为最新版本，避免后台被系统频繁回收；有问题频繁出现时尝试清除应用缓存或重启应用来验证是否为内存回收导致的重建问题。
- 日志、错误捕获与回退机制（定位问题与用户体验保障）
- 开发端：在网络切换路径添加详细日志（网络类型、事件时间、播放器状态、错误码），并上报关键指标。对常见异常（连接超时、解码错误）提供优雅回退：短时本地缓冲播放、提示用户切换到更稳定网络或重试按钮，而非直接恢复默认竖屏。
- 用户端：如果遇到频繁异常，记录出问题的网络类型、操作步骤和时间点，反馈给客服或在社区中说明，这些信息能够帮助开发者快速定位问题。
额外小贴士（实用操作）
- 用户层面快捷排查：更新蘑菇视频到最新版本 → 检查系统“自动旋转” → 关闭省电模式与流量限制 → 清除应用缓存 → 重启应用。
- 如果频繁在不同网络间切换（如地铁/室外），建议先暂停播放再切换网络，待连接稳定后再继续播放或等待播放器自动切换码率。
