Wi-Fi
getConnectedWifi
调用 getConnectedWifi 以获取设备当前所连的 Wifi。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | 支持 | / |
注意事项：
- 获取 Wi-Fi 信息需要允许应用访问位置信息
- iOS14 以后需要打开精确定位
window.ksoxz_sdk.getConnectedWifi({ onSuccess, onError })返回结果
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| SSID | string | Wi-Fi 的 SSID | / |
| BSSID | string | Wi-Fi 的 BSSID | / |
| secure | boolean | Wi-Fi 是否安全 | iOS 端暂不支持输出该字段 Android10 及以上无法获取 |
| signalStrength | number | Wi-Fi 信号强度 | iOS 端暂不支持输出该字段 |
错误码
| errCode | msg | 含义 |
|---|---|---|
| 1504001 | WIFI is disabled | WIFI 开关未开启 |
| 1504002 | not obtain GPS Permission | 操作失败, 因为用户未授予 App 定位权限 |
| 1504003 | not open GPS | 操作失败, 因为系统 GPS 开关未打开 |
| 1504004 | current WIFI is null | 获取不到当前已连接 WiFi |
getWifiStatus
调用 getWifiStatus 以请求获取 Wi-Fi 开关状态。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | 支持 | / |
window.ksoxz_sdk.getWifiStatus({ onSuccess, onError })返回结果
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| status | string | Wi-Fi 状态类型。可能值： on：开 off：关 | / |
getWifiList
调用 getWifiList 以请求获取 Wi-Fi 列表。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | / | / |
注意事项：
- 调用该接口前，需要用户授权 scope.location。
- 获取 Wi-Fi 列表的结果会在 onGetWifiList 中回调返回。
window.ksoxz_sdk.getWifiList({ onSuccess, onError })错误码
| errCode | msg | 含义 |
|---|---|---|
| 1504001 | WIFI is disabled | WIFI 开关未开启 |
| 1504002 | not obtain GPS Permission | 操作失败, 因为用户未授予 App 定位权限 |
| 1504003 | not open GPS | 操作失败, 因为系统 GPS 开关未打开 |
onGetWifiList
onGetWifiList(function callback) 用于监听获取到 Wi-Fi 列表数据事件。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | / | / |
注意事项：该接口需要与 getWifiList 接口配套使用。
window.ksoxz_sdk.getWifiList()
window.ksoxz_sdk.onGetWifiList(callback)返回结果
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| wifiList | object[] | Wi-Fi 列表数据 | WifiInfo |
WifiInfo
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| SSID | string | Wi-Fi 的 SSID | / |
| BSSID | string | Wi-Fi 的 BSSID | / |
| secure | boolean | Wi-Fi 是否安全 | iOS 端暂不支持输出该字段 Android10 及以上无法获取 |
| signalStrength | number | Wi-Fi 信号强度 | iOS 端暂不支持输出该字段 |
offGetWifiList
offGetWifiList(function callback) 用于取消监听获取到 Wi-Fi 列表数据事件。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | / | / |
该接口需要与 onGetWifiList 接口配套使用。
window.ksoxz_sdk.offWifiList(callback)