Get Battery Percentage (OS)

[ausername97531]

There was once a function like this - OS.get_power_percent_left()
I dont know why it was removed but I would like to request the following functions:
OS.get_battery_percent()
OS.get_battery_status()
With status "-1" = stationary PC, "0" = not connected, "1" = charging.
I have a Windows implementation that looks like this:

---

#include <iostream>
#include "Windows.h"

// range 0 - 100, value 255 is *unknown*
int get_battery_percent(){
    SYSTEM_POWER_STATUS container;
    GetSystemPowerStatus(&container);
    int batteryPercent = container.BatteryLifePercent;
    if(batteryPercent<101){return batteryPercent;}
    return 100;
}

// 1 = High—the battery capacity is at more than 66 percent
// 2 = Low—the battery capacity is at less than 33 percent
// 4 = Critical—the battery capacity is at less than five percent
// 8 = Charging
// 128 = No System BATTERY
// 255 = *unknown* status
// FUNCTION TO RETURN 1 IF CHARGING, 0 IF NOT, OR -1 IF STATIONARY PC.
int get_battery_status(){
    SYSTEM_POWER_STATUS container;
    GetSystemPowerStatus(&container);
    int batteryFlag = container.BatteryFlag;
    if(batteryFlag == 8){return 1;}
    if(batteryFlag == 128 || batteryFlag == 255){return -1;}
    return 0;
}

int main() {
    std::cout << "Status = " << get_battery_status() << std::endl;
    std::cout << "Percentage = " << get_battery_percent() << std::endl;

    return 0;
}

[Calinou]

This was attempted a while ago, but was removed because the implementation was never completed.

That said, the Web platform has also removed its battery status API (as it could be used to fingerprint users, leading to privacy issues). This means an implementation in Godot wouldn't be able to work in web exports.

[ausername97531]

How about returning standard values for all platforms that havent or cant be implemented, and if a platform isnt supported yet then a developer for that platform if they want that function could add an implementation?

get_battery_status() - could return "-2" if a platform isnt implemented and when checking the documentation the user would find out what it means.

[Mickeon]

Getting the power status and percentage sounds pretty useful, especially for mobile games, which may want to account for it without user intervention. Never had a chance to use the methods in 3.x, but I always thought their existence was neat.