蘑菇视频切换网络时弹窗新手一次讲明白：从0到1怎么设置

蘑菇视频切换网络时弹窗新手一次讲明白：从0到1怎么设置

开头一句话讲清楚要干什么 当用户在播放视频时从 Wi‑Fi 切换到移动网络，弹出提示可以避免用户意外产生流量。本文从产品设计到技术实现（Android / iOS），手把手把整个流程从 0 → 1 拆开，适合开发者和产品经理直接拿去实现或搬运到 Google 网站作为教程发布。

一、为什么要做这个弹窗

• 防止用户在移动网络下继续高流量播放导致额外费用或卡顿；
• 提升体验：清晰告知当前网络状态并给出选择；
• 合规与可控：让用户主动确认、高风险行为可记录为日志。

二、产品与交互设计要点（先想好，再开发）

• 弹窗触发策略：只在 Wi‑Fi → 移动网络 转换时弹出，避免切换到其它 Wi‑Fi 时出现干扰。
• 去重与“记住选择”：提供“本次不再提醒/记住选择”选项，保留在用户设置里可随时修改。
• 弹窗出现时机：在前台并且播放器处于播放或将要播放时触发；应用在后台或锁屏一般不弹窗。
• 文案要清晰、行动明确：告知流量风险并提供“继续播放/暂停/设置”三种操作。
• 无障碍与国际化：支持 TalkBack/VoiceOver，字符串可本地化。

三、Android 实现要点（Kotlin 示例思路） 1) 权限与清单

• 只需 ACCESSNETWORKSTATE（运行时不需申请，属于普通权限）：

2) 网络变更监听（推荐用 ConnectivityManager.NetworkCallback）

• 优点：更准确、不会受到 CONNECTIVITY_ACTION 在高版本上的限制。
• 注册/注销时机：在应用进前台或播放器初始化时注册，退出或销毁时注销。

示例逻辑（伪代码思路）：

• 初始化：ConnectivityManager.registerDefaultNetworkCallback(networkCallback)
• networkCallback.onAvailable(network) -> 获取 NetworkCapabilities，判断是否包含 TRANSPORTCELLULAR 或 TRANSPORTWIFI
• 保存上次网络类型（例如 enum：UNKNOWN/WIFI/CELLULAR）
• 当上次为 WIFI 且当前为 CELLULAR 时，且应用在前台并且播放器处于播放或将播放，且用户未在设置里选择“永不提醒”，在主线程展示弹窗

弹窗展示（在 Activity/Fragment）

• 使用 AlertDialog 或自定义浮层，必须在主线程执行。
• 弹窗按钮示例：继续播放（记录用户同意并开始/继续播放）、暂停（停止播放并保持在当前界面）、设置（跳转到应用内网络提醒设置页面）。
• 记住选择：在 SharedPreferences 中保存布尔值，例如 “prefskiplossynetworkprompt”。

避免常见问题

• 多次重复弹窗：做防抖（比如 30 秒内只弹一次）并结合“记住选择”。
• 在后台触发：检查 isAppInForeground() 或 ActivityLifecycleCallbacks 来确保只在前台弹出。

四、iOS 实现要点（Swift + Network 框架） 1) 监测网络：使用 NWPathMonitor（推荐）或 SCNetworkReachability（较旧）

• NWPathMonitor 有 queue，可以在后台线程监听，并在 pathUpdateHandler 中处理状态变化。

示例思路：

• 创建 NWPathMonitor()
• 在 pathUpdateHandler 中判断 path.usesInterfaceType(.wifi) / .cellular
• 保持上一次网络类型变量，检测到 WIFI → CELLULAR 时，且应用处于活跃状态（UIApplication.shared.applicationState == .active）并且播放器处于播放或即将播放时，在主线程调用 showAlert()

弹窗展示（UIKit）

• 使用 UIAlertController，添加继续/暂停/去设置等操作。
• 记住选择：UserDefaults 存布尔值，防止重复弹窗。

避免常见问题

• 多次回调：NWPathMonitor 在网络波动时可能多次触发，做去抖（例如 1 秒内合并变更）并检查网络稳定性。
• 后台唤醒：如果应用在后台，避免弹窗，改为在通知栏或应用内设置中记录状态。

五、推荐的弹窗文案与按钮（可直接复制）

• 标题：检测到网络已切换为移动网络
• 内容：当前网络为移动数据，播放高清视频将产生较大流量，可能产生费用。
• 按钮：继续播放（继续并允许本次使用移动网络）／暂停（停止播放）／不再提醒（记住我的选择）

简短版（适合小屏幕）

• “当前为移动数据，继续播放将产生流量。继续？ [继续] [暂停] [不再提醒]”

六、测试清单（发布前务必过）

• Wi‑Fi → 移动网络、移动网络 → Wi‑Fi 各场景；
• 在前台、后台、锁屏切换场景；
• 断网再恢复、弱网切换、运营商 Captive Portal 场景；
• 用户勾选“永不提醒”后设置页可恢复选择；
• 多种 Android 厂商对后台行为差异测试（如 MIUI、EMUI 等）；
• iOS 不同系统版本下 NWPathMonitor 行为一致性。

七、性能与隐私注意

• 监听回调尽量轻量，不在回调里做阻塞操作；
• 只读取网络状态与存储最少必要的用户偏好，不上报敏感信息；
• 尽量合并频繁状态变化以减少 UI 干扰和电量消耗。

八、从 0 到 1 的工作拆解（建议进度）

• 第 1 天：需求确认与文案设计、UI 原型；
• 第 2 天：实现网络监听（Android/iOS）与状态管理；
• 第 3 天：实现弹窗逻辑、记住选择、设置入口；
• 第 4 天：联调播放器接口、做前后台校验；
• 第 5 天：测试，修复边界问题，上线灰度。

• 喜欢（11）
• 不喜欢（3）