📡
漫游事件捕获
自动识别终端与 AP 关联关系的变化，把"上一次"与"当前"两次关联的状态并列呈现，漫游是否发生一目了然。
- 区分当前 / 上一次 Wi-Fi 连接信息
- 事件发生时自动弹出提示区
适用平台iOS（iPhone / iPad）
适用对象网络工程师 · 运维 · 智能家居与商用 Wi-Fi 部署
测试方式接入 Wi-Fi、授权定位，边走边测
当前版本V2.0.1
四个动作，看清一次漫游
连着网关 ping 一路，漫游那一刻的"空窗"就藏不住了。
⏱️
ping 时延实测
以 ping 为基础连续探测网关，用往返时延的突变区间反推漫游实际耗时，而不是靠主观感觉。
- 毫秒级记录，结果可对比
- 同一环境多次复测口径一致
📶
Wi-Fi 信号信息看板
实时读取已连接网络的 SSID、BSSID、RSSI 等关键参数，边走边看信号强度如何变化。
- SSID / BSSID 实时刷新
- RSSI 变化趋势辅助判断覆盖
🧾
日志导出与复盘
测试结果与运行日志可导出留存，交给同事、贴进工单，或作为验收报告的一部分。
- 一键生成测试记录文件
- 提示信息直白，取用无门槛
以上功能均取自本项目需求与迭代记录，未包含任何未上线的规划项。
从打开到出报告，三步
像测体温一样测漫游：贴着现场走一圈，数字自己会说话。
-
01
准备：连上 Wi-Fi、授权定位
先把手机接入被测 Wi-Fi 网络。iOS 出于隐私限制，读取 Wi-Fi 名称与 BSSID 需要定位权限，请务必允许，否则部分信息会显示为空。
提示：看到状态提示为"已获取"，说明权限就位。 -
02
测试：边走边跑
在 APP 内开始测试，然后带着手机沿着实际使用路线移动——穿过 AP 覆盖交界区、上下楼层走廊都算典型场景。观察"上一次 / 当前"信息与 ping 时延的变化。
提示：让相邻 AP 的覆盖有适度重叠，漫游才更容易被触发。 -
03
留档：导出并对比
测试结束导出结果文件，记录当次路线、AP 布局与结论。多数场景建议同路线测 3 次以上，取稳定值判断，避免单次偶然波动。
提示：换固件、调功率前后各测一轮，才有资格说"优化有效"。
第一显示区
主标题 + 当前连接信息的固定展示区，进入 APP 即可读到最关键的几行字。
事件提示区
漫游发生时在这里呈现"上一次"与"当前"的状态对照，橙色代表过去、绿色代表现在。
世界时钟
顶部时间显示，方便多时区协作时对齐测试时间点。
日志与导出
运行日志实时可见，导出入口集中在一处，操作路径短。
这几个词，看懂了就够用
说明书最小集：理解四个名词，就能读懂一次测试。
| 名词 | 含义 | 怎么看 |
|---|---|---|
| SSID | 你在界面上看到的那个 Wi-Fi 名字 | 确认连的是不是"正确的那张网" |
| BSSID | 具体 AP / 射频的硬件地址，同名的网也可能有多个 | BSSID 变了，说明你换了 AP，漫游发生了 |
| RSSI | 接收信号强度，单位 dBm，越接近 0 越强 | 同一位置反复测，值稳说明覆盖稳 |
| 漫游耗时 | 终端从旧 AP 断开到新 AP 关联完成、业务恢复的时间 | 由 ping 时延的突变区间推算，数值越小越好 |
体验良好
漫游瞬间时延波动小、很快恢复，语音与视频几乎无感。
体验欠佳
漫游期间时延明显跳高甚至丢包，通话会卡、视频会转圈。
历史版本更新
当前版本 V2.0.1。更早版本的细节以 APP Store 更新说明为准。
当前
V2.0.1
iOS 26 基线- 修复 Wi-Fi 参数显示异常：定位权限已获取后，SSID、BSSID 等信息仍为空且不刷新的问题
- 修复真机上"生成文件"按钮点击无响应的问题，导出流程更顺畅
- 优化第一显示区文字对齐，主标题与顶部间距收紧
- 优化顶部世界时钟的显示与信息密度
- 精简导出方法相关提示文案，读起来更直白
- 调整两个 Log 输出接口的输出内容，日志更易读
- 整体 UI 交互友好度改进
R
V2.0.0
重构基线- 一代版本下架后重建基线，升级至 iOS 26 环境
- 重新跑通核心能力：接入识别、ping 时延探测、漫游事件呈现
- 全套客制化 UI 上线，信息层级重排
1.0
V1.0.0
初版- 完成主要功能预研：iOS 体系下的 ping 实现与 Wi-Fi 信号读取
- 确认"以网关 ping 时延反推漫游耗时"的技术路线
- 建立主界面 UI 骨架
注：V2.0.0 与 V1.0.0 的条目依据本项目迭代与预研需求整理；如需逐条精确清单，请以 App Store 发布说明为准。
你可能想先知道的几件事
为什么必须授权定位权限？
iOS 把 Wi-Fi 名称与 BSSID 视作位置相关信息，没有定位授权就读不到。拒绝授权时，界面上的网络信息会显示为空或提示未获取。
测试结果为什么每次不完全一样？
漫游受信号环境、终端状态、AP 配置共同影响，轻微波动是正常的。建议同一路线重复多次，看趋势而不是盯单次数值。
能直接给出"好 / 不好"的结论吗？
APP 负责给出客观数据，判定标准取决于业务场景。语音通话对中断最敏感，普通网页浏览容忍度高得多，建议先定标准再测试。
支持 Android 吗？
当前版本为 iOS 专用工具，基于 iOS 的网络信息读取能力实现。Android 端暂无发布计划。
