HarmonyOS API:设备管理
版本:v3.1 Beta
@ohos.batteryInfo (电量信息)
更新时间: 2023-02-17 09:19
该模块主要提供电池状态和充放电状态的查询接口。
说明
本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import batteryInfo from '@ohos.batteryInfo';
属性
描述电池信息。
系统能力:SystemCapability.PowerManager.BatteryManager.Core
名称 | 类型 | 可读 | 可写 | 说明 |
batterySOC | number | 是 | 否 | 表示当前设备剩余电池电量百分比。 |
chargingStatus | 是 | 否 | 表示当前设备电池的充电状态。 | |
healthStatus | 是 | 否 | 表示当前设备电池的健康状态。 | |
pluggedType | 是 | 否 | 表示当前设备连接的充电器类型。 | |
voltage | number | 是 | 否 | 表示当前设备电池的电压,单位微伏。 |
technology | string | 是 | 否 | 表示当前设备电池的技术型号。 |
batteryTemperature | number | 是 | 否 | 表示当前设备电池的温度,单位0.1摄氏度。 |
isBatteryPresent7+ | boolean | 是 | 否 | 表示当前设备是否支持电池或者电池是否在位。 |
batteryCapacityLevel9+ | 是 | 否 | 表示当前设备电池电量的等级。 | |
estimatedRemainingChargeTime9+ | number | 是 | 否 | 表示当前设备充满电的预估时间,单位毫秒。 |
BatteryPluggedType
表示连接的充电器类型的枚举。
系统能力:SystemCapability.PowerManager.BatteryManager.Core
名称 | 值 | 说明 |
NONE | 0 | 表示连接充电器类型未知。 |
AC | 1 | 表示连接的充电器类型为交流充电器。 |
USB | 2 | 表示连接的充电器类型为USB。 |
WIRELESS | 3 | 表示连接的充电器类型为无线充电器。 |
BatteryChargeState
表示电池充电状态的枚举。
系统能力: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_NONE | 0 | 表示电池电量等级未知。 |
LEVEL_FULL | 1 | 表示电池电量等级为满电量。 |
LEVEL_HIGH | 2 | 表示电池电量等级为高电量。 |
LEVEL_NORMAL | 3 | 表示电池电量等级为正常电量。 |
LEVEL_LOW | 4 | 表示电池电量等级为低电量。 |
LEVEL_CRITICAL | 5 | 表示电池电量等级为极低电量。 |
CommonEventBatteryChangedCode9+
表示COMMON_EVENT_BATTERY_CHANGED通用事件附加信息的查询键。
系统能力:SystemCapability.PowerManager.BatteryManager.Core
名称 | 值 | 说明 |
EXTRA_SOC | 0 | 表示剩余电池电量百分比的查询键。 |
EXTRA_VOLTAGE | 1 | 表示当前设备电池电压的查询键。 |
EXTRA_TEMPERATURE | 2 | 表示当前设备电池温度的查询键。 |
EXTRA_HEALTH_STATE | 3 | 表示当前设备电池健康状态的查询键。 |
EXTRA_PLUGGED_TYPE | 4 | 表示当前设备连接的充电器类型的查询键。 |
EXTRA_MAX_CURRENT | 5 | 表示当前设备电池最大电流的查询键。 |
EXTRA_MAX_VOLTAGE | 6 | 表示当前设备电池最大电压的查询键。 |
EXTRA_CHARGE_STATE | 7 | 表示当前设备电池充电状态的查询键。 |
EXTRA_CHARGE_COUNTER | 8 | 表示当前设备电池充电次数的查询键。 |
EXTRA_PRESENT | 9 | 表示当前设备是否支持电池或者电池是否在位的查询键。 |
EXTRA_TECHNOLOGY | 10 | 表示当前设备电池技术型号的查询键。 |
@ohos.deviceInfo (设备信息)
更新时间: 2023-02-17 09:19
本模块提供产品信息。
说明
本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import deviceInfo from '@ohos.deviceInfo'
属性
系统能力:SystemCapability.Startup.SystemInfo。
权限:以下各项所需要的权限有所不同,详见下表。
名称 | 类型 | 可读 | 可写 | 说明 |
deviceType | string | 是 | 否 | 设备类型。 |
manufacture | string | 是 | 否 | 设备厂家名称。 |
brand | string | 是 | 否 | 设备品牌名称。 |
marketName | string | 是 | 否 | 外部产品系列。 |
productSeries | string | 是 | 否 | 产品系列。 |
productModel | string | 是 | 否 | 认证型号。 |
softwareModel | string | 是 | 否 | 内部软件子型号。 |
hardwareModel | string | 是 | 否 | 硬件版本号。 |
hardwareProfile | string | 是 | 否 | 硬件Profile。 |
serial | string | 是 | 否 | 设备序列号。 需要权限:ohos.permission.sec.ACCESS_UDID,该权限为系统权限 |
bootloaderVersion | string | 是 | 否 | Bootloader版本号。 |
abiList | string | 是 | 否 | 应用二进制接口(Abi)列表。 |
securityPatchTag | string | 是 | 否 | 安全补丁级别。 |
displayVersion | string | 是 | 否 | 产品版本。 |
incrementalVersion | string | 是 | 否 | 差异版本号。 |
osReleaseType | string | 是 | 否 | 系统的发布类型,取值为: - Canary:面向特定开发者发布的早期预览版本,不承诺API稳定性。 - Beta:面向开发者公开发布的Beta版本,不承诺API稳定性。 - Release:面向开发者公开发布的正式版本,承诺API稳定性。 |
osFullName | string | 是 | 否 | 系统版本。 |
majorVersion | number | 是 | 否 | Major版本号,随主版本更新增加。 |
seniorVersion | number | 是 | 否 | Senior版本号,随局部架构、重大特性增加。 |
featureVersion | number | 是 | 否 | Feature版本号,标识规划的新特性版本。 |
buildVersion | number | 是 | 否 | Build版本号,标识编译构建的版本号。 |
sdkApiVersion | number | 是 | 否 | 系统软件API版本。 |
firstApiVersion | number | 是 | 否 | 首个版本系统软件API版本。 |
versionId | string | 是 | 否 | 版本ID。 |
buildType | string | 是 | 否 | 构建类型。 |
buildUser | string | 是 | 否 | 构建用户。 |
buildHost | string | 是 | 否 | 构建主机。 |
buildTime | string | 是 | 否 | 构建时间。 |
buildRootHash | string | 是 | 否 | 构建版本Hash。 |
udid7+ | string | 是 | 否 | 设备Udid。 需要权限:ohos.permission.sec.ACCESS_UDID,该权限为系统权限 |