HarmonyOS API:设备管理

joytrian
发布于 2023-4-10 17:48
浏览
0收藏

版本: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

​BatteryChargeState​

表示当前设备电池的充电状态。

healthStatus

​BatteryHealthState​

表示当前设备电池的健康状态。

pluggedType

​BatteryPluggedType​

表示当前设备连接的充电器类型。

voltage

number

表示当前设备电池的电压,单位微伏。

technology

string

表示当前设备电池的技术型号。

batteryTemperature

number

表示当前设备电池的温度,单位0.1摄氏度。

isBatteryPresent7+

boolean

表示当前设备是否支持电池或者电池是否在位。

batteryCapacityLevel9+

​BatteryCapacityLevel​

表示当前设备电池电量的等级。

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,该权限为系统权限


文章转载自:​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-device-info-0000001428061996-V3?catalogVersion=V3​

已于2023-4-10 17:48:28修改
收藏
回复
举报
回复