鸿蒙API14开发【@ohos.batteryInfo (电量信息)】设备管理

该模块主要提供电池状态和充放电状态的查询接口。

说明

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import {batteryInfo} from '@kit.BasicServicesKit';

属性

描述电池信息。

系统能力：SystemCapability.PowerManager.BatteryManager.Core

名称	类型	可读	可写	说明
batterySOC	number	是	否	表示当前设备剩余电池电量百分比。元服务API： 从API version 12开始，该接口支持在元服务中使用。
chargingStatus	[BatteryChargeState]	是	否	表示当前设备电池的充电状态。元服务API： 从API version 12开始，该接口支持在元服务中使用。
healthStatus	[BatteryHealthState]	是	否	表示当前设备电池的健康状态。
pluggedType	[BatteryPluggedType]	是	否	表示当前设备连接的充电器类型。
voltage	number	是	否	表示当前设备电池的电压，单位微伏。
technology	string	是	否	表示当前设备电池的技术型号。
batteryTemperature	number	是	否	表示当前设备电池的温度，单位0.1摄氏度。
isBatteryPresent7+	boolean	是	否	表示当前设备是否支持电池或者电池是否在位。
batteryCapacityLevel9+	[BatteryCapacityLevel]	是	否	表示当前设备电池电量的等级。
nowCurrent12+	number	是	否	表示当前设备电池的电流，单位毫安。

示例：

import {batteryInfo} from '@kit.BasicServicesKit';

let batterySOCInfo: number = batteryInfo.batterySOC;
console.info("The batterySOCInfo is: " + batterySOCInfo);

let chargingStatusInfo = batteryInfo.chargingStatus;
console.info("The chargingStatusInfo is: " + chargingStatusInfo);

let healthStatusInfo = batteryInfo.healthStatus;
console.info("The healthStatusInfo is: " + healthStatusInfo);

let pluggedTypeInfo = batteryInfo.pluggedType;
console.info("The pluggedTypeInfo is: " + pluggedTypeInfo);

let voltageInfo: number = batteryInfo.voltage;
console.info("The voltageInfo is: " + voltageInfo);

let technologyInfo: string = batteryInfo.technology;
console.info("The technologyInfo is: " + technologyInfo);

let batteryTemperatureInfo: number = batteryInfo.batteryTemperature;
console.info("The batteryTemperatureInfo is: " + batteryTemperatureInfo);

let isBatteryPresentInfo: boolean = batteryInfo.isBatteryPresent;
console.info("The isBatteryPresentInfo is: " + isBatteryPresentInfo);

let batteryCapacityLevelInfo = batteryInfo.batteryCapacityLevel;
console.info("The batteryCapacityLevelInfo is: " + batteryCapacityLevelInfo);

let nowCurrentInfo: number = batteryInfo.nowCurrent;
console.info("The nowCurrentInfo is: " + nowCurrentInfo);

BatteryPluggedType

表示连接的充电器类型的枚举。

系统能力：SystemCapability.PowerManager.BatteryManager.Core

名称	值	说明
NONE	0	表示未获取到连接充电器类型。
AC	1	表示连接的充电器类型为交流充电器。
USB	2	表示连接的充电器类型为USB。
WIRELESS	3	表示连接的充电器类型为无线充电器。

BatteryChargeState

表示电池充电状态的枚举。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力：SystemCapability.PowerManager.BatteryManager.Core

名称	值	说明
NONE	0	表示电池充电状态未知。
ENABLE	1	表示电池充电状态为使能状态。
DISABLE	2	表示电池充电状态为停止状态。
FULL	3	表示电池充电状态为已充满状态。

BatteryHealthState

表示电池健康状态的枚举。

系统能力：SystemCapability.PowerManager.BatteryManager.Core

名称	值	说明
UNKNOWN	0	表示电池健康状态未知。
GOOD	1	表示电池健康状态为正常。
OVERHEAT	2	表示电池健康状态为过热。
OVERVOLTAGE	3	表示电池健康状态为过压。
COLD	4	表示电池健康状态为低温。
DEAD	5	表示电池健康状态为僵死状态。

BatteryCapacityLevel9+

表示电池电量等级的枚举。

系统能力：SystemCapability.PowerManager.BatteryManager.Core

名称	值	说明
LEVEL_FULL	1	表示电池电量等级为满电量。
LEVEL_HIGH	2	表示电池电量等级为高电量。
LEVEL_NORMAL	3	表示电池电量等级为正常电量。
LEVEL_LOW	4	表示电池电量等级为低电量。
LEVEL_WARNING	5	表示电池电量等级为告警电量。
LEVEL_CRITICAL	6	表示电池电量等级为极低电量。
LEVEL_SHUTDOWN	7	表示电池电量等级为关机电量。

CommonEventBatteryChangedKey9+

表示COMMON_EVENT_BATTERY_CHANGED通用事件附加信息的查询键。

系统能力：SystemCapability.PowerManager.BatteryManager.Core

名称	值	说明
EXTRA_SOC	“soc”	表示剩余电池电量百分比的查询键。
EXTRA_CHARGE_STATE	“chargeState”	表示当前设备电池充电状态的查询键。
EXTRA_HEALTH_STATE	“healthState”	表示当前设备电池健康状态的查询键。
EXTRA_PLUGGED_TYPE	“pluggedType”	表示当前设备连接的充电器类型的查询键。
EXTRA_VOLTAGE	“voltage”	表示当前设备电池电压的查询键。
EXTRA_TECHNOLOGY	“technology”	表示当前设备电池技术型号的查询键。
EXTRA_TEMPERATURE	“temperature”	表示当前设备电池温度的查询键。
EXTRA_PRESENT	“present”	表示当前设备是否支持电池或者电池是否在位的查询键。
EXTRA_CAPACITY_LEVEL	“capacityLevel”	表示当前设备电池电量等级的查询键。

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
• 《鸿蒙生态应用开发V2.0白皮书》
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
• OpenHarmony北向、南向开发环境搭建
• 《鸿蒙开发基础》
• 《鸿蒙开发进阶》
• 《鸿蒙开发实战》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿