uniapp中可通过uni.getBatteryInfo API获取手机电量百分比，使用时需注意，该接口需用户授权设备信息权限，调用后通过success回调函数返回的batteryInfo对象中，level属性即为当前电量百分比（0-100），同时可获取charging状态（是否充电），示例：uni.getBatteryInfo({ success: (res) => { console.log('当前电量：' + res.level + '%'); } });此接口支持主流平台，但需确保用户授权通过，避免因权限问题导致获取失败。
UniApp获取手机电量百分比：实现方法与跨平台注意事项
在移动应用开发中,获取手机电量百分比是一项常见需求，例如低电量提醒、电量监控、设备状态展示等功能，UniApp作为跨端开发框架，支持一套代码编译到iOS、Android、H5、小程序等多个平台，但不同平台获取电量的API和实现方式存在差异，本文将详细介绍UniApp中获取手机电量百分比的方法，并针对不同平台的兼容性和注意事项进行说明。
实现方法：分平台获取电量百分比
UniApp获取电量百分比的核心思路是：优先使用官方提供的通用API，针对不支持通用API的平台，使用平台特定的原生API或降级方案，以下是不同平台的实现方式。
通用方法：uni.getBatteryInfo（APP端推荐）
UniApp官方在基础库5+版本中提供了uni.getBatteryInfo API，专门用于获取设备电量信息，支持iOS和Android平台，该方法返回包含电量百分比、是否充电等信息的对象，是APP端获取电量的首选方案。
代码示例：
// 获取电量百分比（APP端）
function getBatteryInfo() {
// 检查基础库版本是否支持
if (uni.getSystemInfoSync().SDKVersion >= '2.5.5') {
uni.getBatteryInfo({
success: (res) => {
console.log('当前电量：', res.level + '%'); // 电量百分比（0-100）
console.log('是否充电：', res.isCharging); // 是否正在充电
// 这里可以处理电量数据，例如更新UI或触发提醒
updateBatteryUI(res.level, res.isCharging);
},
fail: (err) => {
console.error('获取电量失败：', err);
// 失败时降级处理（见下文"注意事项"）
handleBatteryError();
}
});
} else {
console.warn('当前基础库版本低于2.5.5，不支持uni.getBatteryInfo');
// 降级方案：使用原生插件（见下文）
useNativePluginForBattery();
}
}
// 更新UI显示电量状态
function updateBatteryUI(level, isCharging) {
// 示例：更新页面上的电量显示
const batteryElement = document.getElementById('battery-level');
if (batteryElement) {
batteryElement.textContent = `${level}%`;
batteryElement.style.width = `${level}%`;
// 根据电量状态改变颜色
if (isCharging) {
batteryElement.classList.add('charging');
} else if (level < 20) {
batteryElement.classList.add('low-battery');
}
}
}
// 处理获取电量失败的情况
function handleBatteryError() {
// 可以显示默认值或提示用户
console.warn('无法获取设备电量，将显示默认值');
updateBatteryUI(100, false);
}
// 使用原生插件作为降级方案
function useNativePluginForBattery() {
// 这里可以调用原生插件方法
// 需要先在manifest.json中配置插件
if (uni.requireNativePlugin) {
const batteryInfo = uni.requireNativePlugin('battery-info');
batteryInfo.getInfo({
success: (res) => {
console.log('原生插件获取电量：', res.level);
updateBatteryUI(res.level, res.isCharging);
},
fail: (err) => {
console.error('原生插件获取电量失败：', err);
handleBatteryError();
}
});
} else {
handleBatteryError();
}
}
// 调用示例
getBatteryInfo();
返回参数说明：
level：当前电量百分比（整数，0-100）。isCharging：布尔值，表示设备是否正在充电。
小程序端：使用平台特定API
小程序平台（如微信、支付宝、百度等）没有直接提供uni.getBatteryInfo，但各小程序平台有自己的电量API，需通过条件编译调用。
微信小程序：wx.getBatteryInfo
微信小程序基础库0+支持wx.getBatteryInfo，获取方式与APP端uni.getBatteryInfo类似，但返回参数略有不同。
代码示例（需条件编译）：
// #ifdef MP-WEIXIN
// 微信小程序获取电量
function getWeChatBattery() {
if (wx.getBatteryInfo) {
wx.getBatteryInfo({
success: (res) => {
console.log('微信小程序电量：', res.level + '%');
console.log('是否充电：', res.isCharging);
// 微信小程序返回的level是字符串类型，需要转换
updateBatteryUI(parseInt(res.level), res.isCharging);
},
fail: (err) => {
console.error('获取电量失败：', err);
handleBatteryError();
}
});
} else {
console.warn('微信小程序基础库低于2.11.0，不支持获取电量');
handleBatteryError();
}
}
// #endif
// 调用示例（需在微信环境中）
// #ifdef MP-WEIXIN
getWeChatBattery();
// #endif
支付宝/百度小程序：降级处理
支付宝、百度等小程序暂未提供直接获取电量的API，可通过以下方式降级：
- 提示用户手动输入：不适合大多数场景。
- 结合设备状态栏电量图标：无法精确获取百分比。
- 使用原生插件：通过小程序插件市场搜索"电量"相关插件，集成后调用（需额外开发）。
- 监听系统事件：部分平台支持通过
onMemoryWarning等事件间接判断电量状态。
H5平台实现方案
H5端由于浏览器安全限制,无法直接获取设备电量信息，但可以通过以下方式实现：
// H5端获取电量
function getH5Battery() {
if ('getBattery' in navigator) {
navigator.getBattery().then(battery => {
const level = Math.round(battery.level * 100);
const isCharging = battery.charging;
console.log('H5端电量：', level + '%');
updateBatteryUI(level, isCharging);
// 监听电量变化
battery.addEventListener('levelchange', () => {
console.log('电量变化：', Math.round(battery.level * 100) + '%');
updateBatteryUI(Math.round(battery.level * 100), battery.charging);
});
battery.addEventListener('chargingchange', () => {
console.log('充电状态变化：', battery.charging);
updateBatteryUI(Math.round(battery.level * 100), battery.charging);
});
}).catch(err => {
console.error('H5获取电量失败：', err);
handleBatteryError();
});
} else {
console.warn('当前浏览器不支持获取电量信息');
handleBatteryError();
}
}
// 在H5端调用
// #ifdef H5
getH5Battery();
// #endif
跨平台兼容性注意事项
版本兼容性检查
不同平台的API支持版本不同,调用前务必进行版本检查：
// 统一获取电量的方法
function getUnifiedBatteryInfo() {
// H5端
// #ifdef H5
getH5Battery();
return;
// #endif
// 微信小程序
// #ifdef MP-WEIXIN
if (wx.getBatteryInfo) {
getWeChatBattery();
} else {
handleBatteryError();
}
return;
// #endif
// APP端
// #ifdef APP-PLUS
if (uni.getSystemInfoSync().SDKVersion >= '2.5.5') {
getBatteryInfo
