永年企业做网站推广,wordpress海外主题,wordpress 4.8.4 漏洞,设计师之家数字图书馆作者#xff1a;董伟
简介
SystemUI应用是OpenHarmony中预置的系统应用#xff0c;为用户提供系统相关信息展示及交互界面#xff0c;包括系统状态、系统提示、系统提醒等#xff0c;例如系统时间、电量信息。
本文主要分析batterycomponent、clockcomponent、wificompo…作者董伟
简介
SystemUI应用是OpenHarmony中预置的系统应用为用户提供系统相关信息展示及交互界面包括系统状态、系统提示、系统提醒等例如系统时间、电量信息。
本文主要分析batterycomponent、clockcomponent、wificomponent三大组件
导入batteryInfo模块监听系统电池事件实时获取电池电量状态导入时间模块调用JS内置函数实时获取系统时间、日期、星期信息导入Wifi模块监听设备Wlan通信与连接事件实时获取Wifi开关、供电、连接名等信息
架构图 目录 /applications/standard/systemui├── build.gradle # 全局编译配置文件├── settings.gradle # 编译模块配置文件├── LICENSE # 许可文件├── common # 通用工具类目录├── entry # entry模块目录├── signature # 证书文件目录├── features # 子组件目录│ ├── batterycomponent # 电池组件│ ├── clockcomponent # 时间组件│ ├── control # 控制中心组件│ ├── navigationservice # 导航栏服务组件│ ├── noticeitem # 通知子组件│ ├── notificationservice # 通知服务组件│ ├── signalcomponent # sim卡信号组件│ ├── wificomponent # wifi组件├── product # SystemUI总体功能目录├── navigationBar # 导航栏模块目录├── statusbar # 状态栏模块目录├── systemDialog # 系统弹框模块目录batterycomponent
简介
电池组件只需监听‘usual.event.BATTERY_CHANGED’即电池变化事件即可监听到电池变化便获取一次电池的状态信息实时获取电池的状态信息是否在充电电量百分比以实现以下功能
1.自动在充电时展示更醒目的图标比如填充绿色、带闪电等
2.动态展示电量百分比变化
官方接口文档
https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-battery-info-0000001100730486
源码地址
https://gitee.com/nicklaus0602/applications_systemui/tree/master/features/batterycomponent
导入模块
import BatteryInfo from ohos.batteryInfo;
import BatterySubscriber from ohos.commonEvent; 申明变量与初始化
var mBatterySoc;
var mBatteryCharging;let mProgress Constants.DEFAULT_PROGRESS;
let mBatteryEventSubscriber null;
let mBatteryEventSubscribeInfo {events: [usual.event.BATTERY_CHANGED]
}export class BatteryStatus {/*** 自定义页面初始化函数由此函数开始一层一层调用下一个函数将当前类导出后只需调用此初始化函数即可完成对Battery模块的使用* 这里使用AppStorage.SetAndLink(batterySoc, 0)来跨页面关联数据只需要在另一个页面中导入当前自定义组件 * 并使用StorageLink(batterySoc)batterySoc: number 1即可关联变量mBatterySoc与batterySoc然后在本页面修改mBatterySoc的值* 另一个页面的变量batterySoc值也会跟着变动。* * 页面初始化 即注册订阅事件监听mBatteryEventSubscribeInfo中的事件**/initBatteryStatus() {Log.showInfo(TAG, initBatteryStatus);mBatterySoc AppStorage.SetAndLink(batterySoc, 0);mBatteryCharging AppStorage.SetAndLink(batteryCharging, false);if (mBatteryEventSubscriber null) {this.registerBatteryListener();}this.getBatteryStatus();}uninitBatteryStatus() {Log.showInfo(TAG, uninitBatteryModel);this.unregisterBatteryListener();}}订阅与回调
/*** Subscribe Battery events 创建订阅*/
private registerBatteryListener() {Log.showInfo(TAG, registerBatteryListener start);BatterySubscriber.createSubscriber(mBatteryEventSubscribeInfo,this.createBatterySubscriberCallBack.bind(this));
}/*** Unsubscribe Battery events 取消订阅**/
private unregisterBatteryListener() {Log.showInfo(TAG, unregisterBatteryListener);BatterySubscriber.unsubscribe(mBatteryEventSubscriber, () {Log.showInfo(TAG, unregister Battery Status Listener );});
}/*** Callback of the subscriber 订阅回调输出日志** param {Object} err - error returns from the caller* param {Object} data - data returns from the caller*/private createBatterySubscriberCallBack(err, data) {Log.showInfo(TAG, Subscriberregister createBatterySubscriberCallBack err: ${JSON.stringify(err)} data: ${JSON.stringify(data)});mBatteryEventSubscriber data;BatterySubscriber.subscribe(mBatteryEventSubscriber, this.batterySubscriberCallBack.bind(this));
}/*** Callback of the events 事件回调若err.code 0表示函数执行正常此时判断事件是否为usual.event.BATTERY_CHANGED如果该事件发生即调用电池模块内的函数来获取电池状态信息** param {Object} err - error returns from the caller* param {Object} data - data returns from the caller*/private batterySubscriberCallBack(err, data) {Log.showInfo(TAG, batterySubscriberCallBack err: ${JSON.stringify(err)} data: ${JSON.stringify(data)});if (err.code 0) {if (data.event usual.event.BATTERY_CHANGED) {this.getBatteryStatus();}} else {Log.showInfo(TAG, Subscriberregister error when subscribing );}
}
获取电池状态、电量
/*** 获取电池状态和剩余电量*/
private getBatteryStatus() {Log.showInfo(TAG,getBatteryStatus)// 调用BatteryInfo.batterySOC获取电量值let batterySoc BatteryInfo.batterySOC;// 调用BatteryInfo.chargingStatus获取充电状态枚举值let batteryCharging BatteryInfo.chargingStatus;if (null batterySoc) {// Set the battery Soc as full when there is no battery hardware 设备无电池硬件时电量默认为满电batterySoc mProgress;}if (batterySoc 0) {// 确保电量值不为负数batterySoc Math.abs(batterySoc) * Constants.PERCENT_NUMBER;}this.checkBatteryStatus(batteryCharging, (result) { let batteryStatus result;// 检查电池的充电状态 将电量的值赋给mBatterySocmBatterySoc.set(batterySoc);// 电池状态赋给mBatteryCharging// 0是false1、2、3是truemBatteryCharging.set(batteryStatus);});
}/*** 传入参数charging根据charging的值来赋boolean值给batteryStatuscharging为0时表示电池未充电表示电池充电状态的枚举NONE 0 表示电池充电状态未知ENABLE 1 表示电池充电状态为使能状态DISABLE 2 表示电池充电状态为停止状态FULL 3 表示电池充电状态为已充满状态** param {number} charging - the battery charging status* param {object} callback - Function callback*/
private checkBatteryStatus(charging, callback) {Log.showInfo(TAG, checkBatteryStatus charging: ${charging});let batteryStatus;switch (charging) {case Constants.NONE:batteryStatus false;break;case Constants.DISABLE:case Constants.ENABLE:case Constants.FULL:batteryStatus true;break;default:batteryStatus false;break;}callback(batteryStatus);
}
Wificomponent
注官方暂无WifiInfo模块的接口文档只有“import wifi from ‘ohos.wifi’”模块的相关文档二者部分属性的枚举值相同可以稍做参考。
wifi 模块地址https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-wlan-0000001121342036
简介
wifi模块需要监听的事件较多需要监听以下事件
1.连接事件’usual.event.wifi.CONN_STATE’
2.供电事件’usual.event.wifi.POWER_STATE’常用于路由器等设备
3.连接名事件’WIFI_CONNECT_NAME’
通过监听wifi的连接状态变化来判断wifi的开关状态通过监听wifi的供电状态变化来判断wifi是否可用通过监听wifi连接的名称变化来判断当前连接的是哪一个wifi网络。
通过对这三个事件的监听我们可以实时获取wifi的开关状态供电状态连接名称借此可以实现以下功能
1.自动根据wifi开关状态设置不同图标
2.自动展示连接的wifi名称
源码地址
https://gitee.com/openharmony/applications_systemui/tree/master/features/wificomponent
导入模块
import WifiInfo from ohos.wifi_native_js;
import Subscriber from ohos.commonEvent;
申明变量与初始化
var mCommonEventSubscribeInfo {events: [Constants.EVENT_CONN_STATE,Constants.EVENT_POWER_STATE, Constants.Event_CONN_NAME]
};var mCommonEventSubscriber null;
var mWifiInfo;
var mWifiStatus;
var mWifiOpenStatus;export class WifiModel {/*** 自定义页面初始化函数由此函数开始一层一层调用下一个函数将当前类导出后只需调用此初始化函数即可完成对Wifi模块的使用* 页面初始化这里使用AppStorage.SetAndLink(wifiInfo, 0)来跨页面关联数据只需要在另一个页面中导入当前自定义组件 * 并使用StorageLink(wifiInfo)wifiInfo: number 1即可关联变量mWifiInfo与wifiInfo然后再本页面修改mWifiInfo的值* 另一个页面的变量wifiInfo值也会跟着变动。* * 页面初始化 即注册订阅事件监听wifi事件变化并获取wifi当前状态信息**/initWifiModel() {Log.showInfo(TAG, initWifiModel)mWifiInfo AppStorage.SetAndLink(wifiInfo, 0);mWifiStatus AppStorage.SetAndLink(wifiStatus, false);mWifiOpenStatus AppStorage.SetAndLink(wifiOpenStatus, false);if(mCommonEventSubscriber null){this.registerWiFiStatusListener();}this.getWifiMessage();}/*** 取消初始化时取消订阅**/uninitWifiModel() {Log.showInfo(TAG, uninitWifiModel)this.unregisterWiFiStatusListener()}
}
订阅与回调
通过创建对wifi事件的订阅来监听mCommonEventSubscribeInfo中的三个事件‘usual.event.wifi.CONN_STATE’‘usual.event.wifi.POWER_STATE’‘WIFI_CONNECT_NAME’若事件发生则触发回调
/*** Subscribe wifi events 订阅wifi事件无返回值创建订阅监听mCommonEventSubscribeInfo中的事件**/
registerWiFiStatusListener() : void {Log.showInfo(TAG, register Wifi status listener );Subscriber.createSubscriber(mCommonEventSubscribeInfo,this.createWifiStatusSubscriberCallBack.bind(this));
}/*** Callback of the subscriber 订阅回调** param {Object} err - error returns from the caller* param {Object} data - data returns from the caller*/
createWifiStatusSubscriberCallBack(err, data) {Log.showInfo(TAG, createWifiStatusSubscriberCallBack start err: ${JSON.stringify(err)} data: ${JSON.stringify(data)});mCommonEventSubscriber data;Subscriber.subscribe(mCommonEventSubscriber, this.wifiStatusSubscriberCallBack.bind(this));
}/*** Callback of the events 事件回调** param {Object} err - error returns from the caller* param {Object} data - data returns from the caller*/
private wifiStatusSubscriberCallBack(err, data) {Log.showInfo(TAG, wifiStatusSubscriberCallBack start err:${ JSON.stringify(err)} data: ${ JSON.stringify(data) });// 默认枚举值 DEFAULT_ERR_CODE: number 0代表函数正常运行if (err.code Constants.DEFAULT_ERR_CODE) {Log.showInfo(TAG, wifi data ${JSON.stringify(data)});// 枚举值 EVENT_CONN_STATE: string usual.event.wifi.CONN_STATE表示wifi连接状态变化if (data.event Constants.EVENT_CONN_STATE) {/*** 枚举值 * WIFI_STATE_AP_CONNECTING: number 1; 正在建立WLAN连接* WIFI_STATE_NETWORK_ENABLED: number 3; 网络可用* WIFI_STATE_NO_NETWORK: number 4; 无网络连接* 如果正在建立WLAN连接||网络可用||无网络连接则调用changeWifiStatus方法设置mWifiStatus为true,表示当前wifi已激活否则即设置为false表 * 示当前wifi未打开*/if(data.code Constants.WIFI_STATE_AP_CONNECTING ||data.code Constants.WIFI_STATE_NETWORK_ENABLED ||data.code Constants.WIFI_STATE_NO_NETWORK){this.updateWifiInfo();this.changeWifiStatus(true);}else {this.updateWifiInfo();this.changeWifiStatus(false);mWifiName.set(WLAN);}}// WIFI_POWER_OFF: number 0; WIFI_POWER_ON: number 4;// data.code 0,wifi不可用mWifiOpenStatus.set(false)// data.code 4,wifi可用mWifiOpenStatus.set(true)// 枚举值 EVENT_POWER_STATE: string usual.event.wifi.POWER_STATE表示wifi供电状态变化常用于路由器等设备if (data.event Constants.EVENT_POWER_STATE) {if( data.code Constants.WIFI_POWER_OFF){this.updateWifiInfo();this.changeWifiStatus(false);mWifiOpenStatus.set(false);mWifiName.set(WLAN);}else if(data.code Constants.WIFI_POWER_ON){mWifiOpenStatus.set(true);}}// 枚举值 Event_CONN_NAME: string WIFI_CONNECT_NAME表示连接名称变化意味着连接到了wifi网络(或者切换到了其他的wifi网络)可以获取当前wifi的信号强度了更新wifi名称并设置wifiStatus为true表示已连接if(data.event WIFI_CONNECT_NAME){this.updateWifiName(JSON.parse(data.data).name)this.changeWifiStatus(true)// rssi是热点的信号强度dBm类型为number,取值范围为[0, 4],rssi为4时wifi信号满格// band是WLAN接入点的频段类型为number// 将rssi,band传入函数updateWifiInfo()let rssi JSON.parse(data.data).rssilet band JSON.parse(data.data).bandLog.showInfo(TAG, WIFI_CONNECT_NAME ${rssi})this.updateWifiInfo(rssi,band);}} else {Log.showError(TAG, error when subscribing );}
}/*** Unsubscribe wifi events 取消wifi事件订阅退订**/
private unregisterWiFiStatusListener() {Subscriber.unsubscribe(mCommonEventSubscriber, () {Log.showInfo(TAG, unregister Wifi Status Listener );});
}
获取Wifi状态
/*** Check the connection status of Wifi 检查wifi的连接状态** param {boolean} status - if display wifi icon*/
private changeWifiStatus(status) {Log.showInfo(TAG, enter changeWifiStatus ${status});mWifiStatus.set(status)
}// 更新wifi信息传入参数rssi,band
private updateWifiInfo(rssiConstants.UPDATE_WIFI_INFO_DEFAULT_PARAM,bandConstants.SIGN_LEVEL) {Log.showInfo(TAG, enter changeWifiInfos ${rssi}${band});mWifiInfo.set(this.getWifiInfo(rssi,band))Log.showInfo(TAG, mWifiInfo wifiInfo ${mWifiInfo.get()});
}
// 更新wifi名称
private updateWifiName(name) {Log.showInfo(TAG, enter changeWifiNames ${name});mWifiName.set(name);
}/*** Update the image of wifi status 更新wifi状态的图标(根据level,即信号的强度,取值范围为[0, 4])信号4代表信号满格** param {number} rssi - the rssi number of the connected wifi* return {string} image used to show wifi status*/
private getWifiInfo(rssi,band) {//The current version keeps return 0 as result, set the level as 4(full level) by hand.Log.showInfo(TAG, getWifiImage enter );//Fake number of band and rssi for wifi signal level temporarilylet level WifiInfo.getSignalLevel(rssi, band);Log.showInfo(TAG, wifi level ${level});return level;
}
// 启用wifi暂不可用
enableWifi() {Log.showInfo(TAG, enableWifi ing);WifiInfo.enableWifi();
}
// 关闭wifi暂不可用
disableWifi() {Log.showInfo(TAG, disableWifi ing);WifiInfo.disableWifi();
}Clockcomponent
简介
对于系统时间的获取较为简单只需在页面初始化时调用JS的内置函数来获取系统时间即可需要注意的是因为要保持所展示的时间实时更新需要使用以下函数来设置时间间隔确保每隔一定的时间就调用一次函数保证时间的实时更新。
setInterval(() {函数名;}, 时间间隔);本文中通过每隔3秒获取一次时间来展示系统时间满足设备展示“xx:xx”即“小时-分钟“的需要如果需要精度更高就需要调整LOOP_TIME使得调用函数的间隔更短。
源码地址
https://gitee.com/openharmony/applications_systemui/tree/master/features/clockcomponent
获取时间数据
const LOOP_TIME 3000;
var mTimeLink;
var mDayLink;
var mWeekDayLink;
var mMonthLink;
/*** 获取当前日期和时间 调用getDate()函数实例化Date对象获取系统当前时间调用JS内置函数每隔三秒将date对象传入* this.updateTime(date);* this.updateDay(date);* this.updateWeekDay(date);* this.updateMonth(date);* 函数获取时间、日、周、月数据**/
private getCurrentDate() {Log.showInfo(TAG, getCurrentDate);this.getDate();timeInterval setInterval(() {this.getDate();}, LOOP_TIME);
}// 实例化Date对象获取系统当前时间并作为参数传入JS内置函数获取想要的时分秒、日、周、月等值
private getDate(){Log.showInfo(TAG, getDate);let date new Date();this.updateTime(date);this.updateDay(date);this.updateWeekDay(date);this.updateMonth(date);
}/*** Update Time.* date.toTimeString()返回一个表示该Date对象时分秒部分的时间字符串substring(0, 5) 截取下标第0个到第5个字符即 xx:xx:xx* param {Object} date - Object of Date.*/
private updateTime(date) {let time date.toTimeString().substring(0, 5);mTimeLink.set(time);
}/*** Update Day.* date.getDate() 获取每个月的第几号-number* param {Object} date - Object of Date.*/
private updateDay(date) {let day date.getDate();mDayLink.set(day);
}/*** Update WeekDay.* date.getDay() 返回每周中的第几天-number想获得星期一这样的value还需要定义数组来获取例如var weekdaylistnew Array(7)weekdaylist[0]周日weekdaylist[1]周一weekdaylist[2]周二weekdaylist[3]周三weekdaylist[4]周四weekdaylist[5]周五weekdaylist[6]周六weekdaylist[this.mWeekDay]* param {Object} date - Object of Date.*/
private updateWeekDay(date) {let weekDay date.getDay();mWeekDayLink.set(weekDay);
}/*** Update Month.* date.getMonth() 返回月份-number月份取值范围【011】这里需要加1* param {Object} date - Object of Date.*/
private updateMonth(date) {let month (date.getMonth() 1);mMonthLink.set(month);
}结语
本文对源码的方法进行了细致的解读目标是节省广大开发者分析源码的时间希望大家阅读本文后可以将源码中从订阅监听事件到调用方法获得枚举值的整个模块直接拿来使用以此助力鸿蒙OS生态搭建
为了能让大家更好的学习鸿蒙HarmonyOS NEXT开发技术这边特意整理了《鸿蒙开发学习手册》共计890页希望对大家有所帮助https://qr21.cn/FV7h05
《鸿蒙开发学习手册》
如何快速入门https://qr21.cn/FV7h05
基本概念构建第一个ArkTS应用…… 开发基础知识https://qr21.cn/FV7h05
应用基础知识配置文件应用数据管理应用安全管理应用隐私保护三方应用调用管控机制资源分类与访问学习ArkTS语言…… 基于ArkTS 开发https://qr21.cn/FV7h05
Ability开发UI开发公共事件与通知窗口管理媒体安全网络与链接电话服务数据管理后台任务(Background Task)管理设备管理设备使用信息统计DFX国际化开发折叠屏系列…… 鸿蒙开发面试真题含参考答案https://qr18.cn/F781PH 鸿蒙开发面试大盘集篇共计319页https://qr18.cn/F781PH
1.项目开发必备面试题 2.性能优化方向 3.架构方向 4.鸿蒙开发系统底层方向 5.鸿蒙音视频开发方向 6.鸿蒙车载开发方向 7.鸿蒙南向开发方向
