Battery Level

Definition

[h2]qg.getBatteryInfo(Object object)

• Description

  Obtains the device battery level.

• Parameters in object

  Parameter	Type	Mandatory	Description
  success	function	No	Callback function triggered upon a successful API call. For details, please refer to Parameters in the success callback function.
  fail	function	No	Callback function triggered upon a failed API call.
  complete	function	No	If a function is passed, it will be called regardless of whether the API call succeeds or fails.

  • Parameters in the success callback function

    Parameter	Type	Description
    isCharging	boolean	Indicates whether the battery is being charged.
    level	string	Device battery level. The value ranges from 1 to 100.

• Sample code

  qg.getBatteryInfo({
          success : function (res) {
                  console.log("getBatteryInfo success level = " + res.level);
          },
          fail:function(){
                  console.log("getBatteryInfo fail");
          },
          complete:function() {
                  console.log("getBatteryInfo complete");
          }
  });

[h2]qg.getBatteryInfoSync() (1078+)

• Description

  Obtains the device battery level in synchronous mode.

• Returns

  Parameter	Type	Description
  isCharging	boolean	Indicates whether the battery is being charged.
  level	string	Device battery level. The value ranges from 1 to 100.

• Sample code

  const batteryInfo = qg.getBatteryInfoSync();
  console.log(batteryInfo.level);
  console.log(batteryInfo.isCharging);