微信小程序实战:掌握“手机状态”感知与设备 API 全解析

摘要 :在移动端开发中,获取设备的网络状态、屏幕亮度、剪贴板及震动反馈,是提升用户体验的关键。本文基于案例 5.11,手把手教你如何在微信小程序中集成 wx.getNetworkType、wx.onNetworkStatusChange、wx.getConnectedWifi、屏幕亮度调节及剪贴板操作,并附上完整的 WXML、WXSS 与 JS 代码。

1. 案例背景与效果展示

本案例设计了一个名为"手机状态"的小程序,主要演示以下功能:

  • 网络状态:实时获取当前网络类型(Wi-Fi、5G、4G 等),并监听网络切换事件。

  • Wi-Fi 参数查询:获取当前连接 Wi-Fi 的 SSID、BSSID、信号强度及频段。

  • 屏幕亮度调节:通过滑动条(Slider)调整屏幕亮度,查询当前亮度,并可复制亮度值。

  • 屏幕常亮:通过 Switch 开关,保持屏幕常亮(常亮状态下手机会震动一会儿)。

  • 剪贴板操作:复制并获取剪贴板内容。

2. 核心界面布局 (index.wxml)

界面整体分为三个区域:网络状态展示区、Wi-Fi 参数查询区、屏幕亮度调节与常亮控制区。

html

复制代码
<!-- index.wxml -->
<view class="box">
  <view class="title">手机状态</view>

  <!-- 网络状态区 -->
  <view class="txt-layout">
    <text>当前网络状态:{{status}}</text>
    <button type="primary" size="mini" bind:tap="getWifiStatus">wifi参数查询</button>
  </view>

  <!-- Wi-Fi 信息展示区 -->
  <view class="txt-layout" wx:if="{{wifiInfo}}">
    <text>Wi-Fi的SSID:{{wifiInfo.SSID}}</text>
    <text>Wi-Fi的BSSID:{{wifiInfo.BSSID}}</text>
    <text>Wi-Fi信号强度:{{wifiInfo.signalStrength}}</text>
    <text>Wi-Fi频段单位MHz:{{wifiInfo.frequency}}</text>
  </view>

  <!-- 屏幕亮度调节区 -->
  <view class="txt-layout">
    <view>设置屏幕亮度</view>
    <slider min="0" max="1" step="0.1" value="{{brightness}}" show-value="true" bind:change="setBrightness" />
    <view class="btn-layout">
      <button type="primary" size="mini" bind:tap="getBrightness">查询亮度</button>
      <text>当前屏幕亮度为:{{brightness}}</text>
    </view>
    <view class="btn-layout">
      <button type="primary" size="mini" bind:tap="copyBrightness">复制亮度</button>
      <text>复制的屏幕亮度为:{{copiedScreenBrightness}}</text>
    </view>
    <view class="btn-layout">
      <switch bind:change="setKeepScreenOnOrOff" />
      <text>保持屏幕常亮状态</text>
    </view>
  </view>
</view>
3. 逻辑处理与核心 API (index.js)

在 JS 中,我们需要实现网络监听、Wi-Fi 查询和亮度控制等功能。

javascript

复制代码
// index.js
Page({
  data: {
    title: '手机状态',
    status: '网络获取中...',
    wifiInfo: null,
    brightness: 0.5,
    copiedScreenBrightness: 0,
    isKeepScreenOn: false
  },

  onLoad() {
    // 1. 获取网络类型
    wx.getNetworkType({
      success: (res) => {
        this.setData({ status: res.networkType });
      }
    });

    // 2. 监听网络状态变化事件
    wx.onNetworkStatusChange((result) => {
      if (result.isConnected) {
        this.setData({ status: result.networkType });
      } else {
        this.setData({ status: '未联网' });
      }
    });
  },

  // 3. Wi-Fi 参数查询
  getWifiStatus() {
    wx.startWifi({
      success: () => {
        wx.getConnectedWifi({
          success: (res) => {
            this.setData({
              wifiInfo: res.wifi,
              title: 'wifi参数查询'
            });
          },
          fail: (err) => {
            console.log('wx.getConnectedWifi接口调用失败', err);
          }
        });
      },
      fail: (err) => {
        console.log('wx.startWifi接口调用失败', err);
      }
    });
  },

  // 4. Slider 拖动设置屏幕亮度
  setBrightness(e) {
    wx.setScreenBrightness({
      value: e.detail.value,
      success: () => {
        this.setData({ brightness: e.detail.value });
      }
    });
  },

  // 5. 查询屏幕亮度
  getBrightness() {
    wx.getScreenBrightness({
      success: (res) => {
        this.setData({ brightness: res.value });
      }
    });
  },

  // 6. 复制亮度到剪贴板
  copyBrightness() {
    const brightnessValue = String(this.data.brightness);
    wx.setClipboardData({
      data: brightnessValue,
      success: () => {
        wx.getClipboardData({
          success: (res) => {
            this.setData({ copiedScreenBrightness: res.data });
          }
        });
      }
    });
  },

  // 7. 保持屏幕常亮开关
  setKeepScreenOnOrOff(e) {
    const isChecked = e.detail.value;
    if (isChecked) {
      // 开启常亮,同时震动一下
      wx.vibrateLong();
    }
    wx.setKeepScreenOn({
      keepScreenOn: isChecked
    });
  }
});
4. 样式美化 (index.wxss & app.wxss)

css

复制代码
/* app.wxss */
.box {
  padding: 20rpx;
  margin: 20rpx;
  border: 2rpx solid silver;
}
.title {
  font-size: 40rpx;
  font-weight: bolder;
  text-align: center;
  margin-bottom: 30rpx;
  color: pink;
}

/* index.wxss */
page {
  height: 100vh;
  display: flex;
  flex-direction: column;
}
.scrollarea {
  flex: 1;
  overflow-y: hidden;
}
view, button {
  margin: 10rpx;
}
.txt-layout {
  display: flex;
  flex-direction: column;
  margin: 10rpx;
  padding: 10rpx;
  border: 2rpx solid blueviolet;
}
.btn-layout {
  display: flex;
  align-items: center;
}
5. 注意事项
  • Wi-Fi 权限 :wx.getConnectedWifi 在某些安卓手机或微信版本上可能需要位置权限,若获取失败请检查手机系统权限设置。

  • 真机调试:屏幕亮度调节、震动反馈和 Wi-Fi 获取等功能在开发者工具模拟器上可能无法真实反馈,建议务必使用真机预览。


第二篇博客:微信小程序网络与 Wi-Fi 状态监听实战:从 getNetworkType 到 onNetworkStatusChange

摘要:在移动应用中,网络切换(如从 Wi-Fi 切换到 4G)非常频繁。如果不妥善处理,可能会导致请求失败或用户流量浪费。本文深入讲解微信小程序的网络状态 API,并结合案例 5.11 中的 Wi-Fi 参数查询,教你如何构建一个对网络状态敏感的健壮小程序。

1. 为什么需要监听网络状态?

小程序的网络请求可能会受到用户所处环境的影响。监听网络状态可以帮助我们:

  • 在无网络时,向用户展示友好的离线提示,而非让请求无限等待。

  • 在 Wi-Fi 环境下,提示用户可以观看高清视频或进行大文件下载。

  • 获取连接 Wi-Fi 的 SSID(Wi-Fi 名称),用于企业内网签到或特定场景的定位。

2. 核心 API 解析

(1)wx.getNetworkType(Object object)

用于获取当前的网络类型。返回值 networkType 可能是:

  • wifi:Wi-Fi 网络

  • 2g、3g、4g、5g:移动网络

  • ethernet:有线网络

  • unknown:Android 下不常见的网络类型

  • none:无网络

(2)wx.onNetworkStatusChange(function callback)

这是一个监听函数。当网络类型发生变化时,会触发此回调。案例代码中是这样使用的:

javascript

复制代码
wx.onNetworkStatusChange((result) => {
  console.log("网络状态变化", result);
  if (result.isConnected) {
    // 重新联网,更新状态
    this.setData({ status: result.networkType });
  } else {
    // 断网状态
    this.setData({ status: '未联网' });
  }
});
3. Wi-Fi 参数查询:wx.startWifi 与 wx.getConnectedWifi

在案例中,除了获取网络类型,还进一步获取了 Wi-Fi 的详细信息。

  • wx.startWifi:初始化 Wi-Fi 模块(注意:必须调用此函数后,才能使用后续的 Wi-Fi API)。

  • wx.getConnectedWifi:获取当前已连接的 Wi-Fi 信息。

javascript

复制代码
getWifiStatus() {
  wx.startWifi({
    success: () => {
      wx.getConnectedWifi({
        success: (res) => {
          // res.wifi 包含 SSID, BSSID, signalStrength 等
          this.setData({ wifiInfo: res.wifi });
        },
        fail: (err) => {
          // 如果没有连接 Wi-Fi,或者未开启定位权限,会走到这里
          wx.showToast({ title: '获取WiFi失败', icon: 'none' });
        }
      });
    }
  });
}

避坑指南 :在 Android 系统中,微信获取 Wi-Fi 信息需要系统开启定位权限 (即使小程序并不使用地图)。如果用户没有开启定位,wx.getConnectedWifi 可能会返回 fail,此时需要引导用户去系统设置中开启定位。

4. 最佳实践
  1. 容错处理 :不要假设用户始终在 Wi-Fi 环境下。在使用 wx.getConnectedWifi 前,先通过 wx.getNetworkType 判断是否为 wifi。

  2. 取消监听 :虽然 onNetworkStatusChange 一般不会造成内存泄漏,但在小程序的 onUnload 生命周期中,应尽量避免未取消的定时器或监听。

  3. 隐私指引:如果你的小程序需要获取 Wi-Fi 信息,请务必在小程序后台的"用户隐私保护指引"中勾选"Wi-Fi 信息",否则该 API 将直接报错。


第三篇博客:微信小程序屏幕亮度、常亮与剪贴板、震动:提升用户感知的细节(案例 5.11)

摘要 :如何让小程序变得"有温度"?除了核心业务,视觉、触觉的反馈至关重要。本文聚焦案例 5.11 中的屏幕状态与触觉反馈,详细讲解 wx.setScreenBrightness、wx.setKeepScreenOn、wx.vibrateLong 和剪贴板 API 的实战应用,并分析其中的 UX 设计细节。

1. 屏幕状态控制:亮度与常亮

(1)设置与获取屏幕亮度

微信小程序可以通过 Slider 组件配合 wx.setScreenBrightness 来调节手机亮度。

javascript

复制代码
// Slider 拖动事件
setBrightness(e) {
  wx.setScreenBrightness({
    value: e.detail.value, // 范围 0 ~ 1,0 最暗,1 最亮
    success: () => {
      this.setData({ brightness: e.detail.value });
    }
  });
}

注意:部分安卓手机(如某些定制系统)可能有亮度保护机制,小程序调节亮度的效果可能不如原生应用明显。

(2)保持屏幕常亮:wx.setKeepScreenOn

在查看二维码、阅读长文章、或者使用导航时,我们通常不希望屏幕自动熄灭。案例中通过一个 Switch 开关来控制:

javascript

复制代码
setKeepScreenOnOrOff(e) {
  const isKeepOn = e.detail.value;
  if (isKeepOn) {
    // 开启常亮前,手机震动一下作为反馈
    wx.vibrateLong();
  }
  wx.setKeepScreenOn({
    keepScreenOn: isKeepOn
  });
}

UX 设计亮点 :PPT 的案例中特别提到,"打开 switch 开关,手机震动一会儿"。这是一个非常好的微交互。wx.vibrateLong() 会让手机产生约 400ms 的震动,给用户一个明确的物理确认信号,告知用户"常亮模式已生效"。

2. 剪贴板交互:复制与读取

当用户需要分享亮度值或某些代码片段时,剪贴板功能显得尤为重要。

javascript

复制代码
copyBrightness() {
  // 1. 写入剪贴板
  wx.setClipboardData({
    data: String(this.data.brightness),
    success: () => {
      // 2. 读取剪贴板以确认
      wx.getClipboardData({
        success: (res) => {
          this.setData({ copiedScreenBrightness: res.data });
          wx.showToast({ title: '已复制', icon: 'success' });
        }
      });
    }
  });
}

注意事项:

  • wx.setClipboardData 会自动弹出"内容已复制"的原生 Toast 提示,一般不需要自己再画蛇添足。

  • 读取剪贴板(wx.getClipboardData)在 iOS 上可能面临系统弹窗提示用户隐私("是否允许粘贴"),这属于正常现象,不可绕过。

3. 状态同步与生命周期管理

在本案例中,网络状态是持续变化的,而屏幕亮度是跟随用户操作的。在处理这些"手机状态"时,我们需要密切关注小程序的生命周期。

  • onLoad :获取初始网络类型,并注册 onNetworkStatusChange 监听。

  • onShow :如果用户从系统设置返回小程序,可以考虑重新查询一次屏幕亮度(wx.getScreenBrightness),因为用户可能在小程序外调整了亮度。

  • onUnload :如果用户开启了"屏幕常亮",当用户退出该页面时,建议重置该状态(恢复为跟随系统),以免影响用户后续的手机使用习惯。

javascript

复制代码
onUnload() {
  // 页面卸载时,关闭屏幕常亮
  wx.setKeepScreenOn({
    keepScreenOn: false
  });
}
4. 总结

通过这三个案例的整合,我们构建了一个完整的、对手机状态"敏感"的小程序。不仅能读取网络和 Wi-Fi 状况,还能通过滑块、开关、震动和剪贴板操作,给用户提供即时、清晰的操作反馈。掌握这些设备 API,能让你的小程序从"能用"进化到"好用"。

相关推荐
马哥python说17 小时前
我用DeepSeek Harness快速上线了一个情侣小程序
微信小程序·小程序·云开发
Jackzhang17 小时前
[端与游戏开发手记] 小程序第一次调接口,卡在域名白名单的那半天
微信小程序
AI_Gump20 小时前
AutoGLM 两年演进深度解读:一篇讲透智谱的手机 Agent 路线
人工智能·智能手机
djxzyr1 天前
微信小程序传感器实战:罗盘、加速计、陀螺仪与加速度实时波形
微信小程序·小程序
开开心心就好2 天前
两张表格数据对比工具,不用写函数也能查
算法·spring·智能手机·pdf·电脑·intellij-idea·音视频
轩哥谈芯2 天前
不用电池也能动:手机NFC给电机供电
智能手机
陈拉斯3 天前
无后端的人格测试小程序:当「数据不出设备」变成架构约束,我学到了什么
微信小程序
李纲明3 天前
微信小程序开了 Skyline 后样式全乱、滚动对不上甚至部分组件不能用?Skyline 怎么接才稳
javascript·微信小程序·小程序·devdiy
李纲明3 天前
微信小程序等位大桌被小桌占掉或过号回来就闹:先核桌型分队与过号容忍次数,再查门口屏与推送同源
微信小程序·devdiy·等位排队·桌型分队·过号重排·门口屏·推送同源