摘要 :在移动端开发中,获取设备的网络状态、屏幕亮度、剪贴板及震动反馈,是提升用户体验的关键。本文基于案例 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. 最佳实践
-
容错处理 :不要假设用户始终在 Wi-Fi 环境下。在使用
wx.getConnectedWifi前,先通过wx.getNetworkType判断是否为wifi。 -
取消监听 :虽然
onNetworkStatusChange一般不会造成内存泄漏,但在小程序的onUnload生命周期中,应尽量避免未取消的定时器或监听。 -
隐私指引:如果你的小程序需要获取 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,能让你的小程序从"能用"进化到"好用"。
