| 参数名 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
ssid | 是 | - | 要测试的 WiFi 名称(SSID) |
url | 否 | 空 | 连接成功后用于测速的目标 URL(目标 IP 为域名解析地址) |
ctCount | 否 | 5 | 连接测试超时计数。每次等待 3 秒,总等待时间为 ctCount * 3 秒 |
connect | 否 | true | 是否执行连接操作。false 时跳过连接 |
disconnect | 否 | true | 是否执行断开操作。false 时跳过断开,否则先执行断开操作 |
host | 否 | www.tingyun.com | 用于配置默认目标主机(如果未配置测速 URL) |
ip | 否 | 1.1.1.1 | 用于配置默认目标 IP(如果未配置测速 URL) |
| 指标索引 | 指标名称 | 说明 |
|---|---|---|
| 0 | 性能 | 性能(信号质量 %) |
| 1 | 信号质量百分比 | WiFi 信号质量,百分比形式 |
| 2 | 信号强度 dBm | 以 dBm 为单位的信号强度值 |
| 3 | AP 连接状态 | 1=连接成功,0=连接失败 |
| 4 | 下载速度 | 通过 URL 测速的下载速度 |
| 5 | 下载时间 | 下载测试的耗时 |
| 6 | 下载字节数 | 下载测试的总字节数 |
| 7 | WiFi 连接耗时 | 从发起连接到连接成功的耗时 |
| 8 | 频段 | 2.4G / 5G / Wifi6 / WiGig |
| 9 | WiFi 下行速度(备用) | 同上 |
| 10 | WiFi 上行速度 | WiFi 上行速度 |
| 11 | 信道 | WiFi 信道编号 |
| 12 | DNS 时间 | 测速时的 DNS 解析耗时 |
| 20 | 总耗时 | 整个任务的总耗时 |
ssid:核心参数,决定测试哪个 WiFi 网络。若 SSID 不存在或信号不可达,AP 连接状态为 0,后续测速指标无意义。url:若配置,连接成功后会向该地址发起下载测速,产出指标 4/5/6/12。若未配置,则跳过测速阶段。ctCount:连接等待轮数。SSID 连接较慢时需要增大此值,否则可能误判为连接失败。但过大的值会增加总耗时(指标 20)。connect:设为 false 时跳过连接步骤,直接测试当前已连接 WiFi 的信号和速度。此时指标 7(WiFi 连接耗时)为 0。disconnect:设为 false 时任务结束后不断开 WiFi,适用于需要保持连接的场景。host / ip:仅用于配置目录域名和 IP。| 错误码 | 含义 |
|---|---|
| 699001 | WiFi 连接失败 |
| 699002 | WiFi 断开失败 |
| 699003 | 未知错误 |
| 699004 | 下载测速失败(URL 相关) |