uniapp uni.getconnectedwifi 如何使用及常见问题解答

在uniapp中如何使用uni.getConnectedWifi接口获取当前连接的WiFi信息？调用时总是返回失败，错误码为12002，请问可能是什么原因导致的？在安卓和iOS平台上获取到的WiFi信息是否有差异？是否需要特殊的权限配置？另外，在模拟器和真机调试时表现不一致该如何解决？

2 回复

uni.getConnectedWifi() 用于获取已连接WiFi信息。使用前需配置权限，并在 onLoad 中调用。常见问题：安卓可能需手动开启定位权限，iOS返回SSID可能为"Wi-Fi"等系统限制。建议用 uni.authorize 提前申请权限，失败时用 uni.getSetting 检查授权状态。


UniApp 中的 uni.getConnectedWifi 是一个用于获取当前已连接 Wi-Fi 信息的 API，适用于移动端（iOS 和 Android）。以下是使用方法和常见问题解答：

使用方法

  1. 引入 API：在 UniApp 页面中直接调用 uni.getConnectedWifi 方法。
  2. 权限配置：确保在 manifest.json 中配置 Wi-Fi 权限（Android 需要 ACCESS_WIFI_STATE 权限，iOS 无需额外配置）。
  3. 代码示例：
    uni.getConnectedWifi({
  success: (res) => {
    console.log('Wi-Fi 信息:', res.wifi);
    // 返回的 res.wifi 包含 SSID、BSSID、安全类型等
  },
  fail: (err) => {
    console.error('获取失败:', err);
  }
});
    • 成功回调：返回 Wi-Fi 对象，包含 SSID（网络名称）、BSSID（路由器 MAC 地址）、secure（安全类型）等。
    • 失败回调：可能因无连接、权限不足或系统限制导致。

常见问题解答

  1. 返回 SSID 为 <unknown ssid>：

    • 原因：系统权限限制（如 Android 10+ 隐私政策）。
    • 解决：检查位置权限是否开启，或引导用户手动连接 Wi-Fi。

  2. Android 无法获取信息：

    • 确认权限：在 manifest.json 的 Android 配置中添加：
      "permissions": ["android.permission.ACCESS_WIFI_STATE"]
    • 系统限制：部分机型需用户开启位置权限（因 Wi-Fi 扫描与位置服务绑定）。

  3. iOS 兼容性：

    • 需用户授权网络访问，且仅能获取已连接 Wi-Fi 的基本信息（如 SSID）。

  4. 模拟器/调试问题：

    • 在模拟器中可能返回空数据，建议使用真机测试。

  5. 安全类型 secure 字段说明：

    • 返回值为 true（需密码）或 false（开放网络），具体类型依赖系统支持。

注意事项

  • 平台差异：Android 和 iOS 的返回数据可能不同，需做好兼容处理。
  • 用户隐私：获取 Wi-Fi 信息可能涉及隐私，确保应用用途符合规范。

通过以上步骤，您可以顺利集成并处理常见问题。如有复杂需求，参考 UniApp 官方文档。

回到顶部