安卓手机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扫描限制)

相关推荐
长亭外的少年7 小时前
Kotlin 编译失败问题及解决方案:从守护进程到 Gradle 配置
android·开发语言·kotlin
建群新人小猿10 小时前
会员等级经验问题
android·开发语言·前端·javascript·php
1024小神11 小时前
tauri2.0版本开发苹果ios和安卓android应用,环境搭建和最后编译为apk
android·ios·tauri
兰琛11 小时前
20241121 android中树结构列表(使用recyclerView实现)
android·gitee
Y多了个想法12 小时前
RK3568 android11 适配敦泰触摸屏 FocalTech-ft5526
android·rk3568·触摸屏·tp·敦泰·focaltech·ft5526
NotesChapter13 小时前
Android吸顶效果,并有着ViewPager左右切换
android
_祝你今天愉快14 小时前
分析android :The binary version of its metadata is 1.8.0, expected version is 1.5.
android
暮志未晚Webgl14 小时前
109. UE5 GAS RPG 实现检查点的存档功能
android·java·ue5
麦田里的守望者江15 小时前
KMP 中的 expect 和 actual 声明
android·ios·kotlin
Dnelic-15 小时前
解决 Android 单元测试 No tests found for given includes:
android·junit·单元测试·问题记录·自学笔记