当前位置：首页 > news >正文

uni-app-x开发安卓app的wifi监听器实战

news 2026/6/23 21:44:58

UniApp X 安卓App的Wi-Fi 状态监听器实战指南

前言

在移动应用开发中，实时监听 Wi-Fi 连接状态变化是一个常见需求。本文将详细介绍如何使用 UniApp X (UTS) 开发一个健壮的 Wi-Fi 状态监听器，帮助开发者快速实现网络状态检测功能。

功能特性

监听 Wi-Fi 开关状态变化（开启/关闭）
监听网络连接状态变化（连接/断开）
自动获取当前连接的 Wi-Fi 名称（SSID）
单例模式设计，避免重复注册监听器
自动释放资源，防止内存泄漏

权限配置

在使用 Wi-Fi 功能之前，需要在AndroidManifest.xml中配置相应权限：

<!-- Wi-Fi 权限 --><uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/><uses-permissionandroid:name="android.permission.CHANGE_WIFI_STATE"/><!-- 获取 SSID 所需的位置权限 --><uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"/><uses-permissionandroid:name="android.permission.ACCESS_COARSE_LOCATION"/>

注意：在 Android 8.0 及以上版本，获取 Wi-Fi SSID 名称需要位置权限。即使应用本身不需要位置功能，也必须申请此权限才能获取到真实的 SSID。

核心代码实现

必须先申请android.permission.ACCESS_FINE_LOCATION 权限再进行下一步这里就不写了

// wifiListener.utsimportContextfrom"android.content.Context";importIntentfrom"android.content.Intent";importIntentFilterfrom"android.content.IntentFilter";importBroadcastReceiverfrom"android.content.BroadcastReceiver";importWifiManagerfrom"android.net.wifi.WifiManager";importWifiInfofrom"android.net.wifi.WifiInfo";importNetworkInfofrom"android.net.NetworkInfo";typeWifiStateData={isConnected:boolean;ssid?:string;}// 获取SSID 需要配置权限 android.permission.ACCESS_FINE_LOCATION 即app的位置权限开启 才能获取到 必须先申请权限classWifiBroadcastReceiverextendsBroadcastReceiver{privatecb:(data:WifiStateData)=>void;constructor(callback:(data:WifiStateData)=>void){super();this.cb=callback;}overrideonReceive(context:Context,intent:Intent){constaction=intent.getAction();if(action===WifiManager.WIFI_STATE_CHANGED_ACTION){conststate=intent.getIntExtra(WifiManager.EXTRA_WIFI_STATE,WifiManager.WIFI_STATE_UNKNOWN);if(state===WifiManager.WIFI_STATE_ENABLED){console.log('[Wi-Fi] 已开启');constssid=getCurrentSSID();consthasSsid=ssid!=null;if(hasSsid){this.cb({isConnected:true,ssid:ssid});}else{this.cb({isConnected:false});}}elseif(state===WifiManager.WIFI_STATE_DISABLED){console.log('[Wi-Fi] 已关闭');this.cb({isConnected:false});}}elseif(action===WifiManager.NETWORK_STATE_CHANGED_ACTION){constnetworkInfo=intent.getParcelableExtra<NetworkInfo>(WifiManager.EXTRA_NETWORK_INFO);if(networkInfo!=null&&networkInfo.isConnected()){constwifiInfo=intent.getParcelableExtra<WifiInfo>(WifiManager.EXTRA_WIFI_INFO);letssid:string|null=null;if(wifiInfo!=null){constraw=wifiInfo.getSSID();if(raw!=null&&raw!=='<unknown ssid>'){ssid=raw.replace(/^"|"$/g,'');}}if(ssid==null){ssid=getCurrentSSID();}console.log('[Wi-Fi] 已连接:',ssid!=null?ssid:'未知网络');if(ssid!=null){this.cb({isConnected:true,ssid:ssid});}else{this.cb({isConnected:true});}}else{console.log('[Wi-Fi] 已断开');this.cb({isConnected:false});}}}}/** * Wi-Fi 状态监听器 * 使用方法： * const listener = WifiListener.getInstance(); * listener.startListening((state) => { console.log(state); }); * // 页面销毁时：listener.stopListening(); */classWifiListener{privatestaticinstance:WifiListener|null=null;privatereceiver:BroadcastReceiver|null=null;privatecontext:Context|null=null;privateconstructor(){}publicstaticgetInstance():WifiListener{if(WifiListener.instance==null){WifiListener.instance=newWifiListener();}returnWifiListener.instance;}privategetContext():Context|null{if(this.context==null){this.context=UTSAndroid.getAppContext();}returnthis.context;}/** * 开始监听 Wi-Fi 状态变化 * @param callback 回调函数，参数为 { isConnected: boolean, ssid?: string } */publicstartListening(callback:(data:WifiStateData)=>void):void{constcontext=this.getContext();if(context==null){console.error('无法获取 Context');return;}this.stopListening();this.receiver=newWifiBroadcastReceiver(callback);constfilter=newIntentFilter();filter.addAction(WifiManager.WIFI_STATE_CHANGED_ACTION);filter.addAction(WifiManager.NETWORK_STATE_CHANGED_ACTION);try{context.registerReceiver(this.receiver,filter);console.log('[Wi-Fi] 监听器已注册');}catch(e){console.error('[Wi-Fi] 注册失败:',e);}}/** * 停止监听，取消注册广播接收器 */publicstopListening():void{if(this.receiver!=null){constcontext=this.getContext();if(context!=null){try{context.unregisterReceiver(this.receiver);console.log('[Wi-Fi] 监听器已取消注册');}catch(e){}}this.receiver=null;}}}functiongetCurrentSSID():string|null{constcontext=UTSAndroid.getAppContext();if(context==null)returnnull;constwifiManager=context.getSystemService(Context.WIFI_SERVICE)asWifiManager;if(wifiManager==null)returnnull;constwifiInfo=wifiManager.getConnectionInfo();if(wifiInfo==null)returnnull;if(wifiInfo.getNetworkId()===-1)returnnull;letssid=wifiInfo.getSSID();if(ssid!=null&&ssid!=='<unknown ssid>'){ssid=ssid.replace(/^"|"$/g,'');returnssid;}returnnull;}export{WifiListener,WifiStateData};

使用示例

在页面中使用

<template> <view> <view>Wi-Fi 状态: {{ isConnected ? '已连接' : '未连接' }}</view> <view v-if="ssid">网络名称: {{ ssid }}</view> </view> </template> <script setup> import { ref, onMounted, onUnmounted } from 'vue'; import { WifiListener } from '@/utils/wifiHelper.uts'; const isConnected = ref(false); const ssid = ref(''); const wifiListener = WifiListener.getInstance(); onMounted(() => { wifiListener.startListening((state) => { isConnected.value = state.isConnected; ssid.value = state.ssid || ''; }); }); onUnmounted(() => { wifiListener.stopListening(); }); </script>

技术要点解析

1. 为什么需要继承 BroadcastReceiver

Android 的 Wi-Fi 状态变化通过广播机制传递。BroadcastReceiver是 Android 四大组件之一，用于接收系统广播。要监听 Wi-Fi 状态，必须：

创建BroadcastReceiver的子类
重写onReceive方法处理广播
在AndroidManifest.xml或代码中注册接收器

2. 为什么要使用单例模式

privatestaticinstance:WifiListener|null=null;publicstaticgetInstance():WifiListener{if(WifiListener.instance==null){WifiListener.instance=newWifiListener();}returnWifiListener.instance;}

避免重复创建监听器实例
确保全局只有一个广播接收器
防止多次注册导致的资源浪费

3. SSID 获取的注意事项

functiongetCurrentSSID():string|null{constwifiInfo=wifiManager.getConnectionInfo();if(wifiInfo.getNetworkId()===-1)returnnull;letssid=wifiInfo.getSSID();if(ssid!=null&&ssid!=='<unknown ssid>'){ssid=ssid.replace(/^"|"$/g,'');returnssid;}returnnull;}