perf(android): 传输期间持 Wi-Fi 高性能锁;汇总带上链路协商速率

实测 1.01 GB 的分段数据推翻了此前的判断:

  接收  1分1秒 · 17.06 MB/s   ← 97% 的时间
  校验  1秒   · 1.05 GB/s
  保存  2秒   · 731 MB/s
  合计  1分3秒 · 16.44 MB/s

保存只花 2 秒,此前估计的 15 秒完全错误——那次 MediaStore 拷贝根本不值得
优化,也不构成 10 GB 的阻塞(按此速率 10 GB 约 14 秒)。全部瓶颈都在
网络传输本身。

改动

1. Wi-Fi 高性能锁
   Android 默认让 Wi-Fi 芯片在包间隙进入省电休眠,代价是额外唤醒延迟,
   对持续大流量传输会明显压低吞吐。这是 Android 上最常见也最容易被忽略的
   一项限速。传输期间持锁(API 29+ 用 WIFI_MODE_FULL_LOW_LATENCY,
   以下用 WIFI_MODE_FULL_HIGH_PERF),下载与上传两条路径都覆盖,
   并在 finally 与返回首页时释放——否则 Wi-Fi 会一直停在高功耗模式。
   Manifest 补 WAKE_LOCK 权限。

2. 汇总带上链路协商速率
   新增 WifiConnector.describeLink(),在完成汇总里附上
   「链路 x Mbps · 频段 · 信号 y dBm」。判断"传输慢"到底是软件问题还是
   链路本身的上限,这两个数字是唯一依据:协商 866 Mbps 却只跑到
   136 Mbps 说明有优化空间;协商本来就只有 150 Mbps 则已接近满速,
   再改代码也没有意义。下一步该往哪走,取决于这个数。

Kotlin 本机无法编译,仅做结构检查。
This commit is contained in:
zhy200308
2026-08-11 21:52:52 +08:00
parent dec132cf3e
commit ae2c36fa54
3 changed files with 67 additions and 0 deletions
+2
View File
@@ -6,6 +6,8 @@
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- WifiLock 需要:传输期间阻止 Wi-Fi 进入省电休眠 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="32" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" android:usesPermissionFlags="neverForLocation" /> <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" android:usesPermissionFlags="neverForLocation" />
@@ -151,6 +151,7 @@ class MainActivity : ComponentActivity() {
stopCamera() stopCamera()
scannerMode = ScannerMode.NONE scannerMode = ScannerMode.NONE
pairConsumed.set(false) pairConsumed.set(false)
wifiConnector.releaseHighPerfLock()
wifiConnector.release() wifiConnector.release()
pendingPair = null pendingPair = null
connectedNetwork = null connectedNetwork = null
@@ -855,6 +856,10 @@ class MainActivity : ComponentActivity() {
downloadRunning = true downloadRunning = true
transferAbortReason = null transferAbortReason = null
// 传输期间阻止 Wi-Fi 进入省电休眠。Android 默认会在包间隙让
// Wi-Fi 芯片休眠,对持续大流量传输会明显压低吞吐。
wifiConnector.acquireHighPerfLock()
val linkAtStart = wifiConnector.describeLink()
transferExecutor.execute { transferExecutor.execute {
// 「传输 / 校验 / 保存」三个阶段各自的速率含义完全不同,混在一起 // 「传输 / 校验 / 保存」三个阶段各自的速率含义完全不同,混在一起
// 平均出来的数字毫无意义。逐段记账,结束后一并列出—— // 平均出来的数字毫无意义。逐段记账,结束后一并列出——
@@ -922,6 +927,8 @@ class MainActivity : ComponentActivity() {
append("\n合计 ").append(humanDuration(totalMillis / 1000.0)).append(" · ") append("\n合计 ").append(humanDuration(totalMillis / 1000.0)).append(" · ")
append(humanBytes((saved.size * 1000.0 / totalMillis).toLong())).append("/s") append(humanBytes((saved.size * 1000.0 / totalMillis).toLong())).append("/s")
} }
// 带上链路协商速率:判断"慢"是软件问题还是链路上限的唯一依据
append("\n").append(linkAtStart)
} }
runOnUiThread { runOnUiThread {
bar.progress = 1000 bar.progress = 1000
@@ -937,6 +944,8 @@ class MainActivity : ComponentActivity() {
} }
} finally { } finally {
downloadRunning = false downloadRunning = false
// 无论成功失败都要释放,否则 Wi-Fi 会一直停留在高功耗模式
wifiConnector.releaseHighPerfLock()
} }
} }
} }
@@ -1073,6 +1082,7 @@ class MainActivity : ComponentActivity() {
} }
val files = selectedFiles.toList() val files = selectedFiles.toList()
sendButton?.isEnabled = false sendButton?.isEnabled = false
wifiConnector.acquireHighPerfLock()
transferExecutor.execute { transferExecutor.execute {
try { try {
files.forEachIndexed { index, file -> files.forEachIndexed { index, file ->
@@ -1114,6 +1124,8 @@ class MainActivity : ComponentActivity() {
sendStatusText?.text = "传输失败:${e.message}" sendStatusText?.text = "传输失败:${e.message}"
sendButton?.isEnabled = true sendButton?.isEnabled = true
} }
} finally {
wifiConnector.releaseHighPerfLock()
} }
} }
} }
@@ -316,6 +316,59 @@ class WifiConnector(context: Context) {
private fun hasIpv4(props: LinkProperties?): Boolean = props?.linkAddresses?.any { it.address is Inet4Address } == true private fun hasIpv4(props: LinkProperties?): Boolean = props?.linkAddresses?.any { it.address is Inet4Address } == true
/**
* 传输期间持有的 Wi-Fi 高性能锁。
*
* Android 默认会让 Wi-Fi 芯片在包间隙进入省电休眠,代价是额外的唤醒
* 延迟。对于持续大流量传输,这会明显压低吞吐——这是 Android 上最常见
* 也最容易被忽略的一项限速。锁只在传输期间持有,结束立即释放。
*/
private var transferLock: WifiManager.WifiLock? = null
@Suppress("DEPRECATION")
fun acquireHighPerfLock() {
if (transferLock != null) return
val mode = if (Build.VERSION.SDK_INT >= 29) {
WifiManager.WIFI_MODE_FULL_LOW_LATENCY
} else {
WifiManager.WIFI_MODE_FULL_HIGH_PERF
}
transferLock = try {
wifiManager.createWifiLock(mode, "qft:transfer").apply {
setReferenceCounted(false)
acquire()
}
} catch (e: Exception) {
Log.w(TAG, "无法获取 Wi-Fi 高性能锁:${e.message}")
null
}
}
fun releaseHighPerfLock() {
try { transferLock?.takeIf { it.isHeld }?.release() } catch (_: Exception) {}
transferLock = null
}
/**
* 当前 Wi-Fi 链路的协商速率与信号强度。
*
* 判断"传输慢"到底是软件问题还是链路本身的上限,这两个数字是唯一
* 依据:协商 866 Mbps 却只跑到 136 Mbps 说明有优化空间;
* 协商本来就只有 150 Mbps 就已经接近满速,改代码也没用。
*/
@Suppress("DEPRECATION", "MissingPermission")
fun describeLink(): String = try {
val info = wifiManager.connectionInfo
if (info == null || info.linkSpeed <= 0) {
"链路信息不可用"
} else {
val band = if (Build.VERSION.SDK_INT >= 21 && info.frequency >= 4900) "5GHz" else "2.4GHz"
"链路 ${info.linkSpeed} Mbps · $band · 信号 ${info.rssi} dBm"
}
} catch (e: Exception) {
"链路信息读取失败:${e.message}"
}
/** /**
* 当前网络的自述:本机地址/掩码、网关、SSID。 * 当前网络的自述:本机地址/掩码、网关、SSID。
* *