Device APIs
getBatteryInfo
Get battery level and charging state of the device.
Overview
my.getBatteryInfo asynchronously obtains the battery level and the charging state of the current device. No input parameters are required.
Sample Code
my.getBatteryInfo({
success: (res) => {
my.alert({
content: "Battery: " + res.level + "%, Charging: " + res.isCharging,
});
},
fail: (err) => {
my.alert({ content: "Inquiry failed: " + JSON.stringify(err) });
},
complete: () => {
console.log("Complete callback");
},
});
Parameters
| Property | Type | Required | Description |
|---|---|---|---|
success | Function | No | Callback function upon call success. |
fail | Function | No | Callback function upon call failure. |
complete | Function | No | Callback function upon call completion (executed whether the call succeeds or fails). |
Success Callback Function
The incoming parameter is an Object with the following attributes:
| Property | Type | Description |
|---|---|---|
level | Number | Battery level of the current device (0–100). |
isCharging | Boolean | Whether the device is currently charging. |
Related Links
- my.getSystemInfo - Get system information
- my.getNetworkType - Get network type