@ohos.batteryStatistics (耗电统计)

该模块提供软硬件耗电统计信息的查询接口。

说明：

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

• 本模块接口为系统接口。

导入模块

import batteryStats from '@ohos.batteryStatistics';

batteryStats.getBatteryStats

getBatteryStats(): Promise<Array<BatteryStatsInfo>>

获取耗电信息列表。使用Promise异步回调。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

返回值：

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

示例：

batteryStats.getBatteryStats()
.then(data => {
    console.info('battery statistics info: ' + data);
})
.catch(err => {
    console.error('get battery statistics failed, err: ' + err);
});

batteryStats.getBatteryStats

getBatteryStats(callback: AsyncCallback<Array<BatteryStatsInfo>>): void

获取耗电信息列表。使用callback异步回调。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

参数：

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

示例：

batteryStats.getBatteryStats((err, data) => {
    if (typeof err === 'undefined') {
        console.info('battery statistics info: ' + data);
    } else {
        console.error('get battery statistics failed, err: ' + err);
    }
});

batteryStats.getAppPowerValue

getAppPowerValue(uid: number): number

获取应用的耗电量。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

参数：

返回值：

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

示例：

try {
    var value = batteryStats.getAppPowerValue(10021);
    console.info('battery statistics value of app is: ' + value);
} catch(err) {
    console.error('get battery statistics value of app failed, err: ' + err);
}

batteryStats.getAppPowerPercent

getAppPowerPercent(uid: number): number

获取应用的耗电百分比。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

参数：

返回值：

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

示例：

try {
    var percent = batteryStats.getAppPowerPercent(10021);
    console.info('battery statistics percent of app is: ' + percent);
} catch(err) {
    console.error('get battery statistics percent of app failed, err: ' + err);
}

batteryStats.getHardwareUnitPowerValue

getHardwareUnitPowerValue(type: ConsumptionType): number

根据耗电类型获取硬件单元的耗电量。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

参数：

返回值：

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

示例：

try {
    var value = batteryStats.getHardwareUnitPowerValue(batteryStats.ConsumptionType.CONSUMPTION_TYPE_SCREEN);
    console.info('battery statistics value of hardware is: ' + value);
} catch(err) {
    console.error('get battery statistics percent of hardware failed, err: ' + err);
}

batteryStats.getHardwareUnitPowerPercent

getHardwareUnitPowerPercent(type: ConsumptionType): number

根据耗电类型获取硬件单元的耗电百分比。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

参数：

返回值：

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

示例：

try {
    var percent = batteryStats.getHardwareUnitPowerPercent(batteryStats.ConsumptionType.CONSUMPTION_TYPE_SCREEN);
    console.info('battery statistics percent of hardware is: ' + percent);
} catch(err) {
    console.error('get battery statistics percent of hardware failed, err: ' + err);
}

BatteryStatsInfo

设备的耗电信息。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics

属性

ConsumptionType

表示电量消耗类型的枚举值。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.PowerManager.BatteryStatistics