输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

快应用

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
API参考
API参考快应用API系统能力Wifi

Wifi

更新时间: 2025-05-07 07:42
本文导读
展开章节

接口声明

在manifest.json文件的 features属性中增加如下配置。

收起
自动换行
深色代码主题
复制
  1. {"name": "system.wifi"}

导入模块

在调用接口页面的<script>部分增加如下配置。

收起
自动换行
深色代码主题
复制
  1. import wifi from '@system.wifi'

或

收起
自动换行
深色代码主题
复制
  1. var wifi = require("@system.wifi")

使用限制

展开

限制条件

说明

适用终端

手机、平板、智慧屏

适用区域

全球

接口定义

在快应用中支持搜索周边的Wi-Fi，同时可以针对指定Wi-Fi，传入密码发起连接。

展开

接口

描述

wifi.connect(OBJECT)

连接Wi-Fi。若已知Wi-Fi信息，可以直接调用此接口连接。

wifi.scan(OBJECT)

请求获取Wi-Fi列表，在onscanned注册的回调中返回wifiList数据。

wifi.onscanned = function(data)

监听获取Wi-Fi列表数据时的事件，在回调中将返回 wifiList。

wifi.onstatechanged = function(data)

监听连接断开Wi-Fi的事件。

wifi.getConnectedWifi(OBJECT)

获取已连接中的Wi-Fi信息。

wifi.connect(OBJECT)

描述

连接Wi-Fi。若已知Wi-Fi信息，可以直接调用此接口连接。

当系统版本为6.0及以上版本时，需要请求获取位置信息的权限。

当系统版本为10.0或者以上版本时，调用此接口后，需要等待接到系统通知，并同意接入wifi后自动连接。

收到系统通知有如下限制：

  • 该网络不在禁用清单中（如果用户在设置wifi页面主动断开网络，则会进入禁用清单24小时）。
  • 用户填写的网络信息与首次扫描出的信息匹配成功。

如果未收到系统通知，需要用户进入系统设置手动链接Wi-Fi。

OBJECT参数

展开

参数

类型

是否必填

说明

SSID

string

是

Wi-Fi设备的ssid。

BSSID

string

是

Wi-Fi设备的bssid。

password

string

是

Wi-Fi设备的密码。

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数（调用成功、失败都会执行）。

示例代码

收起
自动换行
深色代码主题
复制
  1. wifi.connect({
  2.     SSID:'',
  3.     BSSID:'',
  4.     password:'',
  5.     success: function() {
  6.         console.log('connect wifi success');
  7.     },
  8.     fail: function(errmsg, errorCode) {
  9.         console.log('connect failed ' + errmsg+', error = '+errorCode);
  10.     }
  11. })

wifi.scan(OBJECT)

描述

请求获取Wi-Fi列表，在onscanned注册的回调中返回wifiList数据。

当系统版本为6.0或者以上版本时，如果没有打开定位开关，将导致设备无法正常获取周边的Wi-Fi信息。同时，需要请求获取位置信息的权限。

OBJECT参数

展开

参数

类型

是否必填

说明

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数（调用成功、失败都会执行）。

示例代码

收起
自动换行
深色代码主题
复制
  1. wifi.scan({
  2.     success:function() {
  3.         console.log('scan wifi success');    
  4.     },
  5.     fail: function(errmsg, errorCode) {
  6.         console.log('scan failed ' + errmsg+', error = '+errorCode);
  7.     }
  8. })

wifi.onscanned = function(data)

描述

监听获取Wi-Fi列表数据时的事件，在回调中将返回 wifiList。取消监听的方式：wifi.onscanned = null

当系统版本为6.0及以上版本时，需要请求获取位置信息的权限。

OBJECT参数

展开

参数

类型

说明

wifiList

array

Wi-Fi列表数据。

Wi-FI列表项说明：

展开

参数

类型

说明

SSID

string

Wi-Fi的SSID。

BSSID

string

Wi-Fi的BSSID。

secure

boolean

Wi-Fi是否安全。

signalStrength

number

Wi-Fi信号强度。返回值为–100~0的整型数值：

  • 0到–49表示信号最好。
  • –50到–70表示信号偏差。
  • 小于-70表示信号最差，有可能连接不上或者掉线。

示例代码

收起
自动换行
深色代码主题
复制
  1. wifi.onscanned = function(data) {
  2.     console.log('scanned result data = '+ JSON.stringify(data));    
  3. }

wifi.onstatechanged = function(data)

描述

监听连接断开Wi-Fi的事件。取消监听的方式：wifi.onstatechanged = null

当系统版本为6.0及以上版本时，需要请求获取位置信息的权限。

OBJECT参数

展开

参数

类型

说明

SSID

string

Wi-Fi的SSID。

BSSID

string

Wi-Fi的BSSID。

secure

boolean

Wi-Fi是否安全。

signalStrength

number

Wi-Fi信号强度。返回值为–100~0的整型数值：

  • 0到–49表示信号最好。
  • –50到–70表示信号偏差。
  • 小于-70表示信号最差，有可能连接不上或者掉线。

state

number
  • 0代表断开连接。
  • 1代表连接成功。

示例代码

收起
自动换行
深色代码主题
复制
  1. wifi.onstatechanged = function(data) {
  2.     console.log(data.state+' ssid = '+data.SSID+', bssid = '+data.BSSID+', secure = '+data.secure+' signalStrength = '+data.signalStrength);
  3. }

wifi.getConnectedWifi(OBJECT)

描述

获取已连接中的Wi-Fi信息。

当系统版本为6.0及以上版本时，需要请求获取位置信息的权限。

OBJECT参数

展开

参数

类型

是否必填

说明

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数（调用成功、失败都会执行）。

success返回值：

展开

参数

类型

说明

SSID

string

Wi-Fi的SSID。

BSSID

string

Wi-Fi的BSSID。

secure

boolean

Wi-Fi是否安全。

signalStrength

number

Wi-Fi信号强度。返回值为–100~0的整型数值：

  • 0到–49表示信号最好。
  • –50到–70表示信号偏差。
  • 小于–70表示信号最差，有可能连接不上或者掉线。

示例代码

收起
自动换行
深色代码主题
复制
  1. wifi.getConnectedWifi({
  2.     success:function(ret) {
  3.         console.log('ssid = '+ret.SSID+', BSSID = '+ ret.BSSID+', secure = '+ret.secure+', signalStrength = '+ret.signalStrength);
  4.     },
  5.     fail: function(errmsg, errorCode) {
  6.         console.log('getConnectedWifi failed ')
  7.     }
  8. })

Demo

收起
自动换行
深色代码主题
复制
  1. <template>
  2.   <div class="container">
  4.     <div class="item-content">
  5.       <text class="txt">connectWifi:{{isSuccess}}</text>
  6.     </div>
  7.     <input type="button" class="btn" onclick="connectWifi"  value="Connect Wifi" />
  9.     <div class="item-content">
  10.       <text class="txt">wifiResult:{{wifistate}}</text>
  11.     </div>
  13.     <input type="button" class="btn" onclick="onconnected"  value="Wifi onstatechanged" />
  14.     <input type="button" class="btn" onclick="cancelConnect"  value="wifi cancelConnectlistening" />
  15.     <div class="item-content">
  16.       <text class="txt">wifi.scan:{{scan}}</text>
  17.     </div>
  18.     <input type="button" class="btn" onclick="scanWifi" value="Scan Wifi" />
  19.     <div class="item-content">
  20.       <text class="txt">wifi.scanResult:{{scanedresult}}</text>
  21.     </div>
  22.     <input type="button" class="btn" onclick="onscanned" value="wifi onscanned" />
  23.     <input type="button" class="btn" onclick="cancelonScanned"  value="wifi cancelonScanned" />
  25.     <div class="item-content">
  26.       <text class="txt">wifi.wifiinfo:{{wifiinfo}}</text>
  27.     </div>
  28.     <input type="button" class="btn" onclick="getConnectedWifiInfo"  value="Wifi getConnectedWifiInfo" />
  30.   </div>
  31. </template>
  33. <style>
  34.  .container{
  35.   flex: 1;
  36.   flex-direction: column;
  37. } 
  39.   .item-container {
  40.     margin-bottom: 50px;
  41.     margin-right: 60px;
  42.     margin-left: 60px;
  43.     flex-direction: column;
  44.   }
  46.   .item-content {
  47.     flex-direction: column;
  48.     background-color: #ffffff;
  49.     padding-left: 30px;
  50.     padding-right: 30px;
  51.     padding-top: 20px;
  52.     padding-bottom: 20px;
  53.     margin-bottom: 30px;
  54.     align-items: flex-start;
  55.   }
  57.   .txt {
  58.     padding-top: 15px;
  59.     padding-bottom: 15px;
  60.   }
  61.   .btn {
  62.   height: 80px;
  63.   text-align: center;
  64.   border-radius: 5px;
  65.   margin-right: 60px;
  66.   margin-left: 60px;
  67.   margin-bottom: 50px;
  68.   color: #ffffff;
  69.   font-size: 30px;
  70.   background-color: #0faeff;
  71. }
  72. </style>
  73. <script>
  74.   import wifi from '@system.wifi'
  76.   export default {
  77.     data: {
  78.       componentName: 'Wifi',
  79.       isSuccess: '',
  80.       wifistate: '',
  81.       scan: '',
  82.       scanedresult: '',
  83.       wifiinfo: ''
  84.     },
  85.     onInit: function () {
  86.       this.$page.setTitleBar({ text: 'Wifi' })
  87.     },
  89.     connectWifi: function () {
  90.       var that = this
  91.       wifi.connect({
  92.         SSID: 'OPPO Reno7 5G',
  93.         BSSID: '0e:71:f6:f1:b9:7a',
  94.         password: 'wlj123456',
  95.         success: function () {
  96.           console.log('connect wifi success')
  97.           that.isSuccess = 'Success'
  98.         },
  99.         fail: function (errmsg, errorCode) {
  100.           console.log('connect---------failed ' + errmsg + ', error = ' + errorCode)
  101.           that.isSuccess = 'Fail'
  102.         }
  103.       })
  104.     },
  106.     onconnected: function () {
  107.       var that = this
  108.       wifi.onstatechanged = function (ret) {
  109.         that.wifistate = ret.state + ' ssid = ' + ret.SSID + ', bssid = ' + ret.BSSID + ', secure = ' + ret.secure + ' signalStrength = ' + ret.signalStrength
  110.       }
  111.     },
  113.     cancelConnect: function () {
  114.       wifi.onstatechanged = null
  115.     },
  117.     scanWifi: function () {
  118.       var that = this
  119.       wifi.scan({
  120.         success: function () {
  121.           that.scan = 'success'
  122.           console.log('scan wifi success')
  123.         },
  124.         fail: function (errmsg, errorCode) {
  125.           console.log('scan failed ' + errmsg + ', error = ' + errorCode)
  126.           that.scan = 'fail'
  127.         }
  128.       })
  129.     },
  131.     onscanned: function () {
  132.       var that = this
  133.       wifi.onscanned = function (ret) {
  134.         that.scanedresult = JSON.stringify(ret)
  135.         console.log('scaned result success ret = ' + JSON.stringify(ret))
  136.       }
  137.     },
  138.     cancelonScanned: function () {
  139.       wifi.onscanned = null
  140.     },
  141.     getConnectedWifiInfo: function () {
  142.       var that = this
  143.       wifi.getConnectedWifi({
  144.         success: function (ret) {
  145.           that.wifiinfo = ret.SSID + ': BSSID' + ret.BSSID + ', secure = ' + ret.secure + ', signalStrength = ' + ret.signalStrength
  146.         },
  147.         fail: function (data, code) {
  148.           console.log('getConnectedWifi failed ' + data)
  149.           that.wifiinfo = 'fail'
  150.         }
  151.       })
  152.     }
  153.   }
  154. </script>

效果图如下：

错误码说明

展开

错误码

描述

说明

1000

password error

Wi-Fi密码错误。

1001

connection timeout

连接超时。

1002

duplicate request

重复连接 Wi-Fi。

1003

wifi not turned on

未打开Wi-Fi开关。

1004

gps not turned on

未打开GPS定位开关。

1005

invalid SSID

无效SSID。

500

quickapp in background

应用在后台无法进行操作。

版本更新说明

展开

版本

发布日期

描述

1010

2018-04-20

第一次正式发布。
联系人
蓝牙
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 API参考 中进行搜索
请输入您想要搜索的关键词