安卓wifi开发怎么实现？安卓wifi开发教程、实例与常见问题

安卓WiFi开发的核心在于精准控制连接、高效管理状态、保障安全传输，同时兼顾系统兼容性与功耗优化。

开发者需以系统权限为前提、API适配为基础、异常处理为保障，构建稳定可靠的WiFi功能模块,以下从四大维度展开专业实践路径：

权限申请：确保开发前提合规

安卓10（API29）起，WiFi操作权限大幅收紧，必须明确区分前台/后台权限策略：

1. ACCESS_WIFI_STATE：读取WiFi状态（基础权限，普通权限）
2. CHANGE_WIFI_STATE：开关WiFi、连接热点（危险权限，需运行时申请）
3. ACCESS_FINE_LOCATION：扫描WiFi列表必需（安卓9+强制要求）
4. NEARBY_DEVICES（安卓11+）：用于Wi-FiDirect连接，替代旧版BLUETOOTH权限

⚠️注意：若未正确申请定位权限，getScanResults()将返回空列表,导致功能失效。

核心操作：四大高频场景实现方案

扫描与连接

• 扫描触发：调用WifiManager.getScanResults()前，必须先启动startScan()，并注册BroadcastReceiver监听SCAN_RESULTS_AVAILABLE_ACTION
• 连接策略：
  • 预配置网络（WifiConfiguration）适用于固定SSID/PWD场景
  • 动态连接（addNetwork()+enableNetwork()）需处理返回的networkId，失败时自动重试≤3次
  • 优先使用WifiManager.connect()而非enableNetwork()，避免重复连接冲突

网络状态监听

• 实时监听：注册ConnectivityManager.NetworkCallback（API21+）替代旧版NetworkInfo
• 关键事件： networkCallback=newNetworkCallback(){@OverridepublicvoidonAvailable(Networknetwork){/已连接/}@OverridepublicvoidonLost(Networknetwork){/断开/}};connectivityManager.registerDefaultNetworkCallback(networkCallback);

WiFiDirect（P2P）开发

• 初始化：WifiP2pManager+Channel，必须在主线程外执行所有操作
• 设备发现：调用discoverPeers()后监听WIFI_P2P_PEERS_CHANGED_ACTION
• 连接流程：
  1. connect()传入WifiP2pConfig
  2. 监听WIFI_P2P_CONNECTION_CHANGED_ACTION
  3. 成功后通过WifiP2pInfo.groupOwnerAddress建立Socket通信

热点（SoftAP）管理

• Android10+已限制非系统应用创建热点，仅支持读取状态
• 兼容方案：
  • 通过WifiManager.setWifiApEnabled()（反射调用，高风险）
  • 或引导用户跳转系统设置页（Settings.ACTION_WIFI_SETTINGS）
  • 推荐方案：使用WifiManager.startLocalOnlyHotspot()（API26+），但仅限本地通信，无法联网

异常处理：提升稳定性三大关键点

1. 连接失败重试机制：

   • 每次连接失败后等待500ms再重试，累计失败3次后提示用户检查密码
   • 使用WifiManager.saveConfiguration()前务必验证配置有效性

2. 权限缺失兜底：

   • 在onResume()中检测定位权限，缺失时弹出系统授权对话框
   • 对Android11+设备，额外检查MANAGE_ALL_FILES_ACCESS_PERMISSION（若需保存扫描结果）

3. 内存泄漏防护：

   • 所有BroadcastReceiver必须在onDestroy()中注销
   • 使用WeakReference包装回调对象

性能与体验优化

• 功耗控制：
  • 扫描间隔≥5秒（setScanAlwaysAvailable(false)）
  • 连接后及时关闭WifiManager.startScan()
• 兼容性策略：
  • Android10+：使用WifiManager.getConnectionInfo()获取BSSID替代SSID（隐私限制）
  • 华为/小米定制系统：部分机型需添加白名单（如Settings.Secure.WIFI_MULTI_STA_ENABLED）
• 用户引导优化：
  • 断连时提示“请确认路由器是否开启”
  • 连接超时（>15秒）自动弹出重试按钮

相关问答

Q：安卓12+如何绕过定位权限扫描WiFi？
A：无法绕过，Android12（API31）延续定位权限要求，唯一例外是使用WifiManager.getContex().getSystemService(WifiManager.class).getScanResults()配合ACCESS_BACKGROUND_LOCATION（需用户手动开启后台定位）。

Q：为什么addNetwork()返回-1？
A：常见原因：①网络已存在（需先removeNetwork()）；②系统限制（如企业网络策略）；③Android10+未正确处理WPA3加密格式，建议改用WifiNetworkSpecifier（API29+）实现更安全的连接。

你是否遇到过特定机型WiFi连接异常？欢迎在评论区分享你的解决方案！