From ae2c36fa547945033c5a7db072bdc7e19ccc7bb6 Mon Sep 17 00:00:00 2001
From: zhy200308 <2258391712@qq.com>
Date: Tue, 11 Aug 2026 21:52:52 +0800
Subject: [PATCH] =?UTF-8?q?perf(android):=20=E4=BC=A0=E8=BE=93=E6=9C=9F?=
=?UTF-8?q?=E9=97=B4=E6=8C=81=20Wi-Fi=20=E9=AB=98=E6=80=A7=E8=83=BD?=
=?UTF-8?q?=E9=94=81=EF=BC=9B=E6=B1=87=E6=80=BB=E5=B8=A6=E4=B8=8A=E9=93=BE?=
=?UTF-8?q?=E8=B7=AF=E5=8D=8F=E5=95=86=E9=80=9F=E7=8E=87?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
实测 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 本机无法编译,仅做结构检查。
---
android/app/src/main/AndroidManifest.xml | 2 +
.../main/java/com/qft/optical/MainActivity.kt | 12 +++++
.../java/com/qft/optical/WifiConnector.kt | 53 +++++++++++++++++++
3 files changed, 67 insertions(+)
diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index b88be45..4e279ff 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -6,6 +6,8 @@
+
+
diff --git a/android/app/src/main/java/com/qft/optical/MainActivity.kt b/android/app/src/main/java/com/qft/optical/MainActivity.kt
index 9dcac05..2d8dc0f 100644
--- a/android/app/src/main/java/com/qft/optical/MainActivity.kt
+++ b/android/app/src/main/java/com/qft/optical/MainActivity.kt
@@ -151,6 +151,7 @@ class MainActivity : ComponentActivity() {
stopCamera()
scannerMode = ScannerMode.NONE
pairConsumed.set(false)
+ wifiConnector.releaseHighPerfLock()
wifiConnector.release()
pendingPair = null
connectedNetwork = null
@@ -855,6 +856,10 @@ class MainActivity : ComponentActivity() {
downloadRunning = true
transferAbortReason = null
+ // 传输期间阻止 Wi-Fi 进入省电休眠。Android 默认会在包间隙让
+ // Wi-Fi 芯片休眠,对持续大流量传输会明显压低吞吐。
+ wifiConnector.acquireHighPerfLock()
+ val linkAtStart = wifiConnector.describeLink()
transferExecutor.execute {
// 「传输 / 校验 / 保存」三个阶段各自的速率含义完全不同,混在一起
// 平均出来的数字毫无意义。逐段记账,结束后一并列出——
@@ -922,6 +927,8 @@ class MainActivity : ComponentActivity() {
append("\n合计 ").append(humanDuration(totalMillis / 1000.0)).append(" · ")
append(humanBytes((saved.size * 1000.0 / totalMillis).toLong())).append("/s")
}
+ // 带上链路协商速率:判断"慢"是软件问题还是链路上限的唯一依据
+ append("\n").append(linkAtStart)
}
runOnUiThread {
bar.progress = 1000
@@ -937,6 +944,8 @@ class MainActivity : ComponentActivity() {
}
} finally {
downloadRunning = false
+ // 无论成功失败都要释放,否则 Wi-Fi 会一直停留在高功耗模式
+ wifiConnector.releaseHighPerfLock()
}
}
}
@@ -1073,6 +1082,7 @@ class MainActivity : ComponentActivity() {
}
val files = selectedFiles.toList()
sendButton?.isEnabled = false
+ wifiConnector.acquireHighPerfLock()
transferExecutor.execute {
try {
files.forEachIndexed { index, file ->
@@ -1114,6 +1124,8 @@ class MainActivity : ComponentActivity() {
sendStatusText?.text = "传输失败:${e.message}"
sendButton?.isEnabled = true
}
+ } finally {
+ wifiConnector.releaseHighPerfLock()
}
}
}
diff --git a/android/app/src/main/java/com/qft/optical/WifiConnector.kt b/android/app/src/main/java/com/qft/optical/WifiConnector.kt
index 64b97d2..dff7e85 100644
--- a/android/app/src/main/java/com/qft/optical/WifiConnector.kt
+++ b/android/app/src/main/java/com/qft/optical/WifiConnector.kt
@@ -316,6 +316,59 @@ class WifiConnector(context: Context) {
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。
*