Android 热点开发的相关api总结
Android 热点
一、前言
热点开发属于系统级功能开发，涉及的核心 API 多为系统签名权限保护（如android.permission.TETHER_PRIVILEGED），通常仅系统应用（如 Settings）可正常调用。
实际开发中，除基础的开关、配置功能外，可能需要扩展自定义信道设置、频段切换等 Settings 未涵盖的功能。本文总结热点开发的核心流程、调试技巧及版本适配要点
二、热点开发
1、开关和默认配置
（1）核心 API（分版本）
Android 13 及以上：推荐使用
ConnectivityManager与TetheringManager的公开 API，支持回调监听状态：// 开启热点 ConnectivityManager connectivityManager = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE); TetheringManager tetheringManager = connectivityManager.getTetheringManager(); tetheringManager.startTethering(TetheringManager.TETHERING_WIFI,ContextCompat.getMainExecutor(context),new TetheringManager.StartTetheringCallback() {@Overridepublic void onTetheringStarted() { /* 开启成功 */ }@Overridepublic void onTetheringFailed() { /* 开启失败 */ }} );// 关闭热点 tetheringManager.stopTethering(TetheringManager.TETHERING_WIFI);Android 11-12：可使用
WifiManager的startTetheredHotspot（需系统签名）：WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE); // 开启（使用现有配置） wifiManager.startTetheredHotspot(null); // 关闭 wifiManager.stopTetheredHotspot();
（2）配置信息设置
通过SoftApConfiguration配置热点参数（SSID、密码、频段、信道等），需注意配置修改后需重启热点才能生效：
private SoftApConfiguration buildConfig() {SoftApConfiguration.Builder builder = new SoftApConfiguration.Builder();builder.setSsid("MyHotspot"); // 热点名称// 加密类型：0=无密码（OPEN），1=WPA2-PSKbuilder.setPassphrase("12345678", SoftApConfiguration.SECURITY_TYPE_WPA2_PSK); // 频段与信道（必须匹配，否则开启失败）// 2.4G频段（band=1）：信道1-14；5G频段（band=2）：信道36-165builder.setChannel(6, 1); // 2.4G信道6return builder.build();
}// 应用配置
WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
wifiManager.setSoftApConfiguration(buildConfig());
2、主要流程
热点开启的核心调用链
1. ConnectivityManager.startTethering() → 触发 tethering 服务请求
2. TetheringManager.startTethering() → 管理 tethering 状态与权限校验
3. TetheringService.startTethering() → 系统服务层处理请求
4. WifiManager.startTetheredHotspot() → 调用WiFi服务开启热点
5. WifiServiceImpl.startTetheredHotspot() → 实现热点启动逻辑
6. ActiveModeWarden.startSoftAp() → 管理活跃模式（AP模式）
7. SoftApManager.start() → 构建AP配置并调用底层
8. WifiNative.startSoftAp() → 与WiFi HAL交互
9. HostapdHal.addAccessPoint() → 调用硬件抽象层接口，启动hostapd进程
关键节点：SoftApManager负责 AP 配置转换，HostapdHal对接硬件驱动，若某环节日志缺失，需重点排查对应层问题（如权限、硬件支持）。
3、相关日志
调试热点问题时，需重点关注以下日志关键字和过滤命令：
| 日志类型 | 关键字 / 进程名 | 过滤命令示例 | ||
|---|---|---|---|---|
| Framework 层 | SoftApManager、WifiService | `logcat | grep -iE "SoftApManager | WifiService"` |
| 底层服务 | hostapd、wpa_supplicant | `logcat | grep -i hostapd` | |
| HAL 与驱动交互 | WifiNative、WifiHAL | `logcat | grep -i WifiNative` | |
| 网络接口 | wlan、ap0（接口名） | `logcat | grep -i wlan1` |
常见错误日志分析：
Failed to start softap: invalid channel：信道与频段不匹配（如 5G 频段用了 2.4G 信道）。SecurityException: Not allowed to start tethering：缺少系统签名或TETHER_PRIVILEGED权限。hostapd: Failed to set channel：硬件不支持该信道（需检查设备支持的频段范围）。
4、相关广播
热点状态变化的核心广播为WifiManager.WIFI_AP_STATE_CHANGED_ACTION，可监听开关过程：
private BroadcastReceiver hotspotReceiver = new BroadcastReceiver() {@Overridepublic void onReceive(Context context, Intent intent) {if (WifiManager.WIFI_AP_STATE_CHANGED_ACTION.equals(intent.getAction())) {int state = intent.getIntExtra(WifiManager.EXTRA_WIFI_AP_STATE, -1);switch (state) {case WifiManager.WIFI_AP_STATE_ENABLED:Log.d(TAG, "热点已开启");// 可在此处获取热点IP（通过NetworkInterface）break;case WifiManager.WIFI_AP_STATE_FAILED:Log.e(TAG, "热点开启失败");break;// 其他状态：开启中（WIFI_AP_STATE_ENABLING）、关闭中（WIFI_AP_STATE_DISABLING）、已关闭（WIFI_AP_STATE_DISABLED）}}}
};// 注册广播
IntentFilter filter = new IntentFilter(WifiManager.WIFI_AP_STATE_CHANGED_ACTION);
context.registerReceiver(hotspotReceiver, filter);
三、其他
1、Android 热点开发调试小结
- 权限依赖：必须为系统应用（安装在
/system/priv-app）并使用系统签名，还需要导入framwork包； - 硬件限制：频段和信道支持依赖 WiFi 芯片，需通过
WifiManager.getConfiguredNetworks()或底层日志确认设备能力。
// 依赖ZXing库：implementation 'com.google.zxing:core:3.5.0'
private Bitmap generateHotspotQrCode(String ssid, String password) {// 二维码内容格式：WIFI:S:热点名;T:加密类型（WPA/WEP/OPEN）;P:密码;;String content = "WIFI:S:" + ssid + ";T:WPA;P:" + password + ";;";MultiFormatWriter writer = new MultiFormatWriter();try {BitMatrix matrix = writer.encode(content, BarcodeFormat.QR_CODE, 300, 300, // 二维码宽高new HashMap<>());// 转换BitMatrix为Bitmapint width = matrix.getWidth();int height = matrix.getHeight();Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);for (int x = 0; x < width; x++) {for (int y = 0; y < height; y++) {bitmap.setPixel(x, y, matrix[x][y] ? Color.BLACK : Color.WHITE);}}return bitmap;} catch (WriterException e) {e.printStackTrace();return null;}
}