@system.battery (电量信息)


@system.battery (电量信息)

该模块提供充电状态及剩余电量的查询功能。

说明:

  • 从API Version 6开始不再维护,建议使用@ohos.batteryInfo替代。
  • 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import battery from '@system.battery';
1

battery.getStatus

getStatus(options?: GetStatusOptions): void;

获取设备当前的充电状态及剩余电量。

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

参数:

参数名 类型 必填 说明
options GetStatusOptions 包含接口调用结果的对象。

示例:

battery.getStatus({
    success: function(data) {
        console.log('success get battery level:' + data.level);
    },
    fail: function(data, code) {
        console.error('fail to get battery level code:' + code + ', data: ' + data);
    }
});
1
2
3
4
5
6
7
8

GetStatusOptions

包含接口调用结果的对象。

参数名 类型 必填 说明
success (data: BatteryResponse) => void 接口调用成功的回调函数,data为BatteryResponse类型的返回值。
fail (data: string, code: number) => void 接口调用失败的回调函数。data为错误信息,code为错误码。
complete () => void 接口调用结束的回调函数。

BatteryResponse

包含充电状态及剩余电量的对象。

参数名 类型 说明
charging boolean 当前电池是否在充电中。
level number 当前电池的电量,取值范围:0.00 - 1.00 。