tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
腾讯云小程序平台
    文档
    Download PDF

    WiFi

    最后更新时间：2024-07-16 17:58:26
    下载PDF

      onWifiConnected

      该 API 使用方法为 wx.onWifiConnected(function listener)
      说明：
      支持度：
      Android：支持。
      iOS：支持。
      功能说明：监听连接上 Wi-Fi 的事件。
      参数及说明：function listener，连接上 Wi-Fi 的事件的监听函数，参数 Object res 如下：
      属性
      类型
      说明
      wifi
      WifiInfo
      Wi-Fi 信息

      offWifiConnected

      该 API 使用方法为 wx.offWifiConnected(function listener)
      功能说明：移除连接上 Wi-Fi 的事件的监听函数。
      参数及说明：function listener，onWifiConnected 传入的监听函数。不传此参数则移除所有监听函数。
      示例代码：
      const listener = function (res) { console.log(res) }
      
      wx.onWifiConnected(listener)
      wx.offWifiConnected(listener) // 需传入与监听时同一个的函数对象

      stopWifi

      该 API 使用方法为 wx.stopWifi(Object object)
      功能说明：关闭 Wi-Fi 模块。
      参数及说明：Object object。
      属性
      类型
      默认值
      必填
      说明
      success
      function
      -
      否
      接口调用成功的回调函数
      fail
      function
      -
      否
      接口调用失败的回调函数
      complete
      function
      -
      否
      接口调用结束的回调函数（调用成功、失败都会执行）
      错误码
      错误码
      错误信息
      说明
      0
      ok
      正常
      12000
      not init
      未先调用 startWifi 接口
      12001
      system not support
      当前系统不支持相关能力
      12002
      password error Wi-Fi
      密码错误
      12003
      connection timeout
      连接超时, 仅 Android 支持
      12004
      duplicate request
      重复连接 Wi-Fi
      12005
      wifi not turned on
      Android 特有，未打开 Wi-Fi 开关
      12006
      gps not turned on
      Android 特有，未打开 GPS 定位开关
      12007
      user denied
      用户拒绝授权链接 Wi-Fi
      12008
      invalid SSID
      无效 SSID
      12009
      system config err
      系统运营商配置拒绝连接 Wi-Fi
      12010
      system internal error
      系统其他错误，需要在 errmsg 打印具体的错误原因
      12011
      weapp in background
      应用在后台无法配置 Wi-Fi
      12013
      wifi config may be expired
      系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试，仅 Android 支持
      12014
      invalid WEP / WPA password
      iOS 特有，无效的 WEP / WPA 密码
      示例代码:
      wx.stopWifi({
        success (res) {
          console.log(res.errMsg)
        }
      })

      startWifi

      该 API 使用方法为 wx.startWifi(Object object)
      功能说明：初始化 Wi-Fi 模块。
      参数及说明：Object object。
      属性
      类型
      默认值
      必填
      说明
      success
      function
      -
      否
      接口调用成功的回调函数
      fail
      function
      -
      否
      接口调用失败的回调函数
      complete
      function
      -
      否
      接口调用结束的回调函数（调用成功、失败都会执行）
      错误码
      错误码
      错误信息
      说明
      0
      ok
      正常
      12000
      not init
      未先调用 startWifi 接口
      12001
      system not support
      当前系统不支持相关能力
      12002
      password error Wi-Fi
      密码错误
      12003
      connection timeout
      连接超时, 仅 Android 支持
      12004
      duplicate request
      重复连接 Wi-Fi
      12005
      wifi not turned on
      Android 特有，未打开 Wi-Fi 开关
      12006
      gps not turned on
      Android 特有，未打开 GPS 定位开关
      12007
      user denied
      用户拒绝授权链接 Wi-Fi
      12008
      invalid SSID
      无效 SSID
      12009
      system config err
      系统运营商配置拒绝连接 Wi-Fi
      12010
      system internal error
      系统其他错误，需要在 errmsg 打印具体的错误原因
      12011
      weapp in background
      应用在后台无法配置 Wi-Fi
      12013
      wifi config may be expired
      系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试，仅 Android 支持
      12014
      invalid WEP / WPA password
      iOS 特有，无效的 WEP / WPA 密码
      示例代码:
      wx.startWifi({
        success (res) {
          console.log(res.errMsg)
        }
      })

      onGetWifiList

      该 API 使用方法为 wx.onGetWifiList(function listener)
      功能说明：监听获取到 Wi-Fi 列表数据事件。
      参数及说明：function listener，获取到 Wi-Fi 列表数据事件的监听函数。参数 Object res 如下：
      属性
      类型
      说明
      wifiList
      Array.<WifiInfo>
      Wi-Fi 列表数据

      offGetWifiList

      该 API 使用方法为 wx.offGetWifiList(function listener)
      功能说明：移除获取到 Wi-Fi 列表数据事件的监听函数。
      参数及说明：function listener，onGetWifiList 传入的监听函数。不传此参数则移除所有监听函数。
      示例代码：
      const listener = function (res) { console.log(res) }
      
      wx.onGetWifiList(listener)
      wx.offGetWifiList(listener) // 需传入与监听时同一个的函数对象

      getConnectedWifi

      该 API 使用方法为 wx.getConnectedWifi(Object object)
      功能说明：获取已连接中的 Wi-Fi 信息。
      参数及说明：Object object
      属性
      类型
      默认值
      必填
      说明
      partialInfo
      boolean
      false
      否
      是否需要返回部分 Wi-Fi 信息
      success
      function
      -
      否
      接口调用成功的回调函数
      fail
      function
      -
      否
      接口调用失败的回调函数
      complete
      function
      -
      否
      接口调用结束的回调函数（调用成功、失败都会执行）
      object.success 回调函数参数：Object res
      属性
      类型
      说明
      wifi
      WifiInfo
      Wi-Fi 信息
      错误码
      错误码
      错误信息
      说明
      0
      ok
      正常
      12000
      not init
      未先调用 startWifi 接口
      12001
      system not support
      当前系统不支持相关能力
      12002
      password error Wi-Fi
      密码错误
      12003
      connection timeout
      连接超时, 仅 Android 支持
      12004
      duplicate request
      重复连接 Wi-Fi
      12005
      wifi not turned on
      Android 特有，未打开 Wi-Fi 开关
      12006
      gps not turned on
      Android 特有，未打开 GPS 定位开关
      12007
      user denied
      用户拒绝授权链接 Wi-Fi
      12008
      invalid SSID
      无效 SSID
      12009
      system config err
      系统运营商配置拒绝连接 Wi-Fi
      12010
      system internal error
      系统其他错误，需要在 errmsg 打印具体的错误原因
      12011
      weapp in background
      应用在后台无法配置 Wi-Fi
      12013
      wifi config may be expired
      系统保存的 Wi-Fi 配置过期，建议忘记 Wi-Fi 后重试，仅 Android 支持
      12014
      invalid WEP / WPA password
      iOS 特有，无效的 WEP / WPA 密码

      WifiInfo

      功能说明：Wifi 信息。
      注意：
      Android wx.connectWifi / wx.getConnectedWifi 若设置了 partialInfo:true，或者调用了 wx.onWifiConnectedWithPartialInfo 事件。将会返回只包含 SSID 属性的 WifiInfo 对象。
      iOS wx.getConnectedWifi 若设置了 partialInfo:true，将会返回只包含 SSID、BSSID 属性的 WifiInfo 对象，且需要用户开启宿主客户端定位权限才能正确返回结果。
      在某些情况下，可能 Wi-Fi 已经连接成功，但会因为获取不到完整的 WifiInfo 对象报错。具体错误信息为 errCode:12010, errMsg: can't gain current wifi 或 no wifi is connected。如果开发者不需要完整的 WifiInfo 对象，则可以通过采取上述策略解决报错问题。

      属性

      string SSID：Wi-Fi 的 SSID。
      string BSSID：Wi-Fi 的 BSSID。
      boolean secure：Wi-Fi 是否安全。
      number signalStrength：Wi-Fi 信号强度，Android 取值 0 ～ 100 ，iOS 取值 0 ～ 1，值越大强度越大。
      number frequency：Wi-Fi 频段单位 MHz。
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款