Open Headunit UserExitHotspotPolicy用户手动退出热点后的系统行为设计指南【免费下载链接】open-headunitHeadunit App for displaying Android Auto项目地址: https://gitcode.com/GitHub_Trending/he/open-headunitOpen Headunit是一款把车机变成 Android Auto 主机的开源应用而它的UserExitHotspotPolicy用户退出热点策略正是解决一个容易被忽略的问题当你手动结束投屏会话时车机上的 Wi-Fi 热点该如何处置。本文带你完整理解这套退出即决策的设计——它不是一行简单的关热点代码而是一套兼顾权限、硬件能力与用户体验的状态机。为什么断开连接还不够问题的根源想象这样一个场景你在车机应用里点了断开会话结束了但手机其实并没有离开 Wi-Fi 网络。源码注释里讲得很直白见 UserExitHotspotPolicy.kt关闭 AAP 套接字、发送ByeByeRequest并不会让手机脱离网络。手机仍然挂在热点上而 Android Auto 会不断重试无线设置直到把自己限流为止——因为在手机看来是车在中途跑路了。这个应用能动的唯一杠杆就是让网络本身消失把车机托管的那个软 APsoft AP即 Wi-Fi 热点关掉手机自然会被甩出网络。决策逻辑速览三种退出动作策略的核心入口是UserExitHotspotPolicy.onUserExit()它根据当前连接配置返回三种动作之一动作含义典型场景NONE不关热点——这条路不归它管走 WiFi DirectP2P组网由别处拆除DISABLE把车机托管的热点关掉手机被真正踢出网络用户已授权应用管理热点WARN_LEFT_UP保持热点不动只记录警告说明代价热点是用户手动开的应用没有权限代管判断顺序对应 UserExitHotspotPolicy.kt 第 53-65 行先问归属当前模式Native AA / Helper是否真的把手机放在了车机自托管的热点上不是 →NONE。这一问保证了它与负责 WiFi Direct 的WifiModePolicy是互补关系——同一次断连两边有且仅有一边会说是避免同时拆除 P2P 组和热点。再问硬件记忆这台设备是否已经被证明关了热点就再也开不回来teardownProvenUnsafe是 →WARN_LEFT_UP绝不再冒险。最后问授权用户是否通过自动开启热点autoEnableHotspot设置把热点的开关权交给了应用是 →DISABLE否 →WARN_LEFT_UP。 关键设计哲学门槛是归属权而不是症状。P2P 组是应用为会话创建的随时可拆而软热点通常是用户自己手动打开的关掉它再想恢复在很多未 root 的车机上根本做不到。把别人的热点关了却恢复不了比连接卡顿更糟糕——卡顿用户可以自己去清掉。DISABLE 的执行细节先拆完再重启而非关闭决策只是第一步真正执行在 AapService.kt 的断开流程里第 1555-1597 行有两个讲究顺序严格必须等commManager.awaitDisconnectComplete()确认 ByeBye 握手与套接字关闭全部完成才能动热点否则拆除过程中新来的连接会被误拒。重启而非单纯关闭如果只把热点关掉下一次连接就要付上完整的开机代价——源码实测某台拒绝setSoftApConfiguration()的车机要耗掉约 20 秒。所以应用选择重启热点热点消失的一瞬间把手机踢出网络然后立即再拉起来这 20 秒的开销就花在用户已经走开的当下而不是下次的等待时间里。自我学习机制teardownProvenUnsafe标志这是整个设计里最反直觉也最精妙的部分。有些无线芯片源码中记录了一台 UNISOC 车机热点一旦被应用关掉由于 hostapd 的频道扫描与驱动重建接口发生竞争就再也开不回来——包括本该作为退路的自动开启也失败。在这种设备上每次手动退出都会烧掉一个热点代价极高。于是应用采用了一次性的探测策略第一次照常执行DISABLE若HotspotManager.restart()失败就把 Settings.kt 中的hotspotTeardownProvenUnsafe置为true并持久化保存因为这个属性属于硬件、运行间不会改变持久化后每次退出都直接走WARN_LEFT_UP用户只在日志里收到一次友好提示以后结束会话时请从手机端的 Android Auto 通知栏退出或手动关掉热点。用一个热点的代价换来了每次会话一个热点的长期损失这是典型的用最少试错换取长期正确。用户视角这个开关在哪里在 SettingsFragment.kt 中当你选择 Native AA 的热点传输路线时设置页会自动出现热点管理开关autoEnableHotspot。这个开关在两个地方生效连接建立前找不到热点时由应用自动开启用户手动退出后由UserExitHotspotPolicy依据它决定是否拆除网络。也就是说开启 把热点的完整生命周期交给应用关闭 应用只读不动退出时仅提示。测试如何守住互补契约单元测试 UserExitHotspotPolicyTest.kt 覆盖了两类关键性质永不重叠遍历所有模式 × 策略 × 传输组合断言usesHeadUnitHotspot与usesWifiDirect不会同时为真第 137-153 行否则同一次断连会双重拆除永不落空所有车机托管手机网络的路线必须至少被两个策略之一认领第 163-178 行否则网络会一直挂着、手机永远无法离开。后者尤其重要因为两边都不认领这种错误不会报错、只会在真机上表现为断开后手机还连着热点测试就是为了让这种静默失败无处藏身。小结UserExitHotspotPolicy展示了开源项目里少见的工程克制按归属权决策而不是按症状硬关用一次试错学习硬件能力并把结果持久化拆除顺序严格先握手后拆网重启代替关闭以摊平延迟用穷举测试锁死恰好一个策略负责的契约。如果你也在做车机投屏类应用这套退出即决策的模式权限 → 能力 → 授权三层判断 失败记忆非常值得借鉴。核心源码索引策略本体connection/wifi/UserExitHotspotPolicy.kt执行流程aap/AapService.kt不安全标志utils/Settings.kt设置入口main/SettingsFragment.kt配套测试connection/wifi/UserExitHotspotPolicyTest.kt【免费下载链接】open-headunitHeadunit App for displaying Android Auto项目地址: https://gitcode.com/GitHub_Trending/he/open-headunit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考