安卓手机APP开发__Wi-Fi扫描概述

安卓手机APP开发__Wi-Fi扫描概述

目录

概述

Wi-Fi的扫描过程

限制

权限

[Android 8.0 and Android 8.1:](#Android 8.0 and Android 8.1:)

[Android 9:](#Android 9:)

[Android 10 (API 级别 29) 和 更高版本:](#Android 10 (API 级别 29) 和 更高版本:)

扫描频率的限制

[Android 8.0 and Android 8.1:](#Android 8.0 and Android 8.1:)

[Android 9:](#Android 9:)

[Android 10 and higher:](#Android 10 and higher:)


概述

你能使用Wi-Fi的扫描能力,通过使用Wifi管理器API来得到Wi-Fi的扫描过程.

Wi-Fi的扫描过程

在扫描的过程中有三个步骤:

为SCAN_RESULTS_AVAILABLE_ACTION注册一个广播的监听器,当扫描的请求被完成时

这个监听器被调用了,提供它们成功/失败的状态.对于运行在安卓10(API级别29)以及

更高版本,这个广播被发送到任何Wi-Fi扫描完成的设备上。APP能积极地监听所有的

扫描完成,通过使用广播。

使用WifiManager.startScan()方法请求一个扫描。确保检查方法的返回状态,因

为这个调用可能因为如下的任何一个原因而失败:

因为在短时间内有太多的扫描了,扫描请求被堵塞住了。

设备是空闲的但扫描被禁用了

Wi-Fi报告了一个扫描故障

使用WifiManager.getScanResults()方法得到扫描的结果。返回的扫描的结果是最新的

更新的结果,如果你的扫描没有完成,它可能是之前的一次的结果。这意味着

如果你在接收到一个成功的广播之前,调用了这个方法,你可能得到一个比较旧的结果。

如下的代码提供了一个例子,它是如何实现这些步骤的:

Kotlin

Kotlin 复制代码
val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager

val wifiScanReceiver = object : BroadcastReceiver() {

  override fun onReceive(context: Context, intent: Intent) {
    val success = intent.getBooleanExtra(WifiManager.EXTRA_RESULTS_UPDATED, false)
    if (success) {
      scanSuccess()
    } else {
      scanFailure()
    }
  }
}

val intentFilter = IntentFilter()
intentFilter.addAction(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION)
context.registerReceiver(wifiScanReceiver, intentFilter)

val success = wifiManager.startScan()
if (!success) {
  // scan failure handling
  scanFailure()
}

....

private fun scanSuccess() {
  val results = wifiManager.scanResults
  ... use new scan results ...
}

private fun scanFailure() {
  // handle failure: new scan did NOT succeed
  // consider using old scan results: these are the OLD results!
  val results = wifiManager.scanResults
  ... potentially use older scan results ...
}

限制

安卓8.0 (API 级别 26)引入了对权限的限制的允许的Wi-Fi扫描的频率的限制。

为了提升网络的性能,安全,和电池的寿命,安卓9 (API 级别 28)加强了权限请求

并且进一步地限制了Wi-Fi扫描的频率。

权限

Android 8.0 and Android 8.1:

对WifiManager.getScanResults()方法的成功的调用需要如下的权限:

ACCESS_FINE_LOCATION

ACCESS_COARSE_LOCATION

CHANGE_WIFI_STATE

如果调用时没有这三个权限,这个调用是失败的,并且返回了SecurityException.

Android 9:

对WifiManager.startScan()方法的成功的调用需要如下的权限:

你的app 有 ACCESS_FINE_LOCATION 或 ACCESS_COARSE_LOCATION 权限.

你的 app 有 CHANGE_WIFI_STATE 权限.

在设备上的定位服务被启用(设置〉定位)

Android 10 (API 级别 29) 和 更高版本:

对WifiManager.startScan()方法的成功的调用需要如下的权限:

你的app 有 ACCESS_FINE_LOCATION 权限.

你的 app 有 CHANGE_WIFI_STATE 权限.

在设备上的定位服务被启用(设置〉定位)

对WifiManager.getScanResults()方法的成功的调用需要如下的权限:

你的app 有 ACCESS_FINE_LOCATION 权限.

你的 app 有 ACCESS_WIFI_STATE 权限.

在设备上的定位服务被启用(设置〉定位)

如果调用时没有这三个权限需求,这个调用是失败的,并且返回了SecurityException.

扫描频率的限制

在使用WifiManager.startScan()方法应用这个限制

Android 8.0 and Android 8.1:

每个后台的APP在30分钟的周期内能扫描一次。

Android 9:

每一个前台的APP在一个2分钟的周期内可以扫描4次。

所有的后台的APP放在一起,在30分钟的周期内能扫描一次。

Android 10 and higher:

限制与安卓9时是一样的,有了一个新的开发者选项,在本地测试时,可以关闭这个限制

(开发者选项〉网络〉Wi-Fi扫描限制)

相关推荐
晨曦_子画18 分钟前
编程语言之战:AI 之后的 Kotlin 与 Java
android·java·开发语言·人工智能·kotlin
孤客网络科技工作室40 分钟前
AJAX 全面教程:从基础到高级
android·ajax·okhttp
Mr Lee_2 小时前
android 配置鼠标右键快捷对apk进行反编译
android
顾北川_野2 小时前
Android CALL关于电话音频和紧急电话设置和获取
android·音视频
&岁月不待人&3 小时前
Kotlin by lazy和lateinit的使用及区别
android·开发语言·kotlin
Winston Wood4 小时前
Android Parcelable和Serializable的区别与联系
android·序列化
清风徐来辽5 小时前
Android 项目模型配置管理
android
帅得不敢出门5 小时前
Gradle命令编译Android Studio工程项目并签名
android·ide·android studio·gradlew
problc6 小时前
Flutter中文字体设置指南:打造个性化的应用体验
android·javascript·flutter
帅得不敢出门16 小时前
安卓设备adb执行AT指令控制电话卡
android·adb·sim卡·at指令·电话卡