缘起
最近有个需求，要求App能够自动扫描到某个热点然后自动连接上热点。背景是我们公司属于IoT行业，这个热点是设备发出的，有固定的前缀（比如设备热点名为SmartLife-xx），可以直接连接无需密码。
本来觉得这个需求非常简单，然鹅GitHub上仅有的几个相关Demo并不能满足需求，只好自己撸起。
拆解需求
核心的动作有三个：
- 扫描WiFi列表
- 匹配到相关的热点后连接
- 返回连接结果
核心API
- 参考Android API 文档,扫描获取扫描结果也需要三步
- 注册 WifiManager.SCAN_RESULTS_AVAILABLE_ACTION广播监听
- 调用 WifiManager.startScan()方法扫描
- 调用 WifiManager.getScanResults()获取扫描结果
其中：WifiManager.startScan()方法被标记为@deprecated ，文档提示"The ability for apps to trigger scan requests will be removed in a future release".结合Stack Overflow这篇回复，估计Android以后会阉割这个功能，好在文档中说API 29还能使用，Android 10 release 后允许继续使用。如果以后真阉割这个API了我们再找解决方案。
- 自动连接到热点也有2个API：Wifimanager.updateNetwork(config) 和Wifimanager.addNetwork(config)。这2个API作用不同，看下源码：
- Wifimanager.updateNetwork(config)
public int updateNetwork(WifiConfiguration config) {
if (config == null || config.networkId < 0) {
return -1;
}
return addOrUpdateNetwork(config);
}
- Wifimanager.addNetwork(config)
public int addNetwork(WifiConfiguration config) {
if (config == null) {
return -1;
}
config.networkId = -1;
return addOrUpdateNetwork(config);
}
显然，2个API的区别是config.networkId是否等于 -1；如果连接过指定的WiFi，系统会有记录，config.networkId > 0,否则config.networkId = -1；源码注释对Wifimanager.addNetwork的说法是
Add a new network description to the set of configured networks.
* The {@code networkId} field of the supplied configuration object
* is ignored.
* <p/>
* The new network will be marked DISABLED by default. To enable it,
* called {@link #enableNetwork}.
对某个WiFi调用这个API后，这个WiFi就会被标记为DISABLED，如果想要连接必须再调用enableNetwork方法。杯具的是自动连接到热点也有2个API在API 29会过期，文档推荐使用WifiNetworkSpecifier.Builder相关方法代替，后续会继续研究更新。
- 返回连接结果，成功或者失败，我注册了广播WifiManager.NETWORK_STATE_CHANGED_ACTION来监听。在连接target WiFi之前需要断开当前连接WiFi，连接成功之后会收到WiFi变化的广播，然后获取当前连接的WiFi和target WiFi进行对比，就可以知道是否连接成功。
权限
如果想要正常使用以上核心API,除了常规的
<uses-permission android:name="android.permission.INTERNET"/>
权限外，还需要以下权限
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
文档里都有解释，这里就不一一列举了。
核心代码
- WiFi扫描核心代码
public void wifiScan(final AppCompatActivity mActivity) {
index = 0;
if (rxPermissions == null) {
rxPermissions = new RxPermissions(mActivity);
pool = Executors.newScheduledThreadPool(1);
}
rxPermissions.request(Manifest.permission.ACCESS_COARSE_LOCATION, Manifest.permission.ACCESS_FINE_LOCATION).
subscribe(new Consumer<Boolean>() {
@Override
public void accept(Boolean aBoolean) {
if (aBoolean) {
final WifiManager wifimanager = (WifiManager) mActivity.getApplicationContext().getSystemService(Context.WIFI_SERVICE);
pool.scheduleAtFixedRate(new Runnable() {
@Override
public void run() {
if (index < TOTAL_TIMES) {
wifimanager.startScan();
Log.i("WIFI_LIST", "1 : wifimanager.startScan()" + " index = " + index);
index++;
}
}
}, 0, DELAYT_TIME, TimeUnit.MILLISECONDS);
} else {
Log.i("WIFI_LIST", "1 : no permission");
}
}
});
}
简单解释下，使用了线程池循环扫描。如果没有扫描到target WiFi 就每隔2s扫描一次，最多扫描20次。如果扫描到target WiFi就停止扫描，调用以下方法
public void stopScan() {
if (pool != null) {
pool.shutdown();
}
}
- 连接target WiFi 核心 代码
public static boolean addNetWork(WifiConfiguration config, Context context) {
WifiManager wifimanager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
WifiInfo wifiinfo = wifimanager.getConnectionInfo();
if (null != wifiinfo) {
wifimanager.disableNetwork(wifiinfo.getNetworkId());
}
boolean result = false;
if (config.networkId > 0) {
result = wifimanager.enableNetwork(config.networkId, true);
wifimanager.updateNetwork(config);
} else {
int i = wifimanager.addNetwork(config);
result = false;
if (i > 0) {
wifimanager.saveConfiguration();
return wifimanager.enableNetwork(i, true);
}
}
return result;
}
- 广播监听
@Override
public void onReceive(Context context, Intent intent) {
if(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION.equals(intent.getAction())){ //扫描到WiFi列表
if(delegate != null){
List<ScanResult> results = delegate.getWifiScanResult(context);
Log.i("WIFI_LIST", "2 : WifiBroadcastReceiver#onReceive" + " currentIndex = " + delegate.getCurrentIndex() + " results.size = " + results.size());
if(listener != null){
if(delegate.getCurrentIndex() == TOTAL_TIME){
listener.resultSuc(results,true);
}else {
listener.resultSuc(results,false);
}
}
}
}else if(WifiManager.NETWORK_STATE_CHANGED_ACTION.equals(intent.getAction())){ //连接的WiFi变化了
WifiInfo connectedWifiInfo = ((WifiManager) context.getSystemService(Context.WIFI_SERVICE)).getConnectionInfo();
if(listener != null){
listener.connectedWifiCallback(connectedWifiInfo);
}
}
}
完整Demo
Github地址
欢迎star ,欢迎fork。有问题留言一起探讨。
