模块维护策略：

- 对于Lite Wearable设备类型，该模块长期维护，正常使用。

- 对于支持该模块的其他设备类型，该模块从API Version 6开始不再维护，建议使用@ohos.batteryInfo替代。
本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

收起
自动换行
深色代码主题
复制
import {Battery, BatteryResponse } from '@kit.BasicServicesKit';

Battery.getStatus^(deprecated)

Wearable18+Lite Wearable12+

getStatus(options?: GetStatusOptions): void;

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

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

参数：

展开

参数名	类型	必填	说明
options	GetStatusOptions	否	包含接口调用结果的对象。可选，默认为空。

示例：

ArkTS示例：

收起
自动换行
深色代码主题
复制
Battery.getStatus({
    success: (data: BatteryResponse) => {
        console.info('success get battery level:' + data.level);
    },
    fail: (data: string, code: number) => {
        console.error('fail to get battery level code:' + code + ', data: ' + data);
    }
});

JS示例：

收起
自动换行
深色代码主题
复制
<!-- xxx.hml -->
<div class="container">
    <input type="button" value="Get Data" style="width: 240px; height: 50px; margin: 5px;" onclick="getBatteryInfo"></input>
    <text class="title">level: {{ capacity }}</text>
    <text class="title">charging: {{ charging }}</text>
</div>

收起
自动换行
深色代码主题
复制
/* xxx.css */
.container {
  width: 100%;
  height: 100%;
  justify-content: center;
  align-items: center;
  flex-direction: column;
}
.title {
  width: 200px;
  font-size: 30px;
  text-align: center;
}

收起
自动换行
深色代码主题
复制
// xxx.js
import Battery from '@system.battery';

export default {
    data: {
        capacity: '',
        charging: ''
    },
    getBatteryInfo() {
        let TAG = 'get_status_success_test';
        Battery.getStatus({
            success: (batteryResponse) => {
                this.capacity = batteryResponse.level;
                this.charging = batteryResponse.charging;
                console.info(`${TAG} batteryResponse.level: ${batteryResponse.level}`);
                console.info(`${TAG} batteryResponse.charging: ${batteryResponse.charging}`);
            },
            fail: (data, code) => {
                console.error(`${TAG} fail data: ${data}, code: ${code}`);
            },
            complete: () => {
                console.info(`${TAG} getStatus complete`);
            }
        });
    },
}

GetStatusOptions^(deprecated)

Wearable18+Lite Wearable12+

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

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

展开

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

BatteryResponse^(deprecated)

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

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

展开

名称	类型	只读	可选	说明
charging	boolean	否	否	当前电池是否在充电中。true表示在充电，false表示没有充电，默认为false。说明：除Lite Wearable外，从API Version 6开始不再维护，建议使用batteryInfo.chargingStatus替代。
level	number	否	否	当前电池的电量百分比，取值范围：0.00~1.00。说明：除Lite Wearable外，从API Version 6开始不再维护，建议使用batteryInfo.batterySOC替代。

名称

类型

只读

可选

说明

charging

boolean

否

当前电池是否在充电中。true表示在充电，false表示没有充电，默认为false。

说明： 除Lite Wearable外，从API Version 6开始不再维护，建议使用batteryInfo.chargingStatus替代。

level

number

否

当前电池的电量百分比，取值范围：0.00~1.00。

说明： 除Lite Wearable外，从API Version 6开始不再维护，建议使用batteryInfo.batterySOC替代。

@system.brightness (屏幕亮度)

@system.device (设备信息)

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问

@system.battery (电量信息)

导入模块

Battery.getStatus(deprecated)

GetStatusOptions(deprecated)

BatteryResponse(deprecated)

Battery.getStatus^(deprecated)

GetStatusOptions^(deprecated)

BatteryResponse^(deprecated)