DJI Mobile SDK Documentation

      class AggregationState

      @EXClassNullAway
      class AggregationState
      Package:dji.common.battery
      SDK Key:BatteryKey.AGGREGATION_STATE
      Description:

      Provides a real time summary of the aggregated battery system.

      Class Members:
      method getNumberOfConnectedBatteries
      int getNumberOfConnectedBatteries()
      Package:dji.common.battery
      SDK Key:BatteryKey.NUMBER_OF_CONNECTED_BATTERIES
      Description:

      The number of currently connected batteries.

      Return:
      intAn int value.
      method getBatteryOverviews
      BatteryOverview[] getBatteryOverviews()
      Package:dji.common.battery
      SDK Key:BatteryKey.OVERVIEWS
      Description:

      Returns the overview of batteries in the battery group. When a battery is not connected, the isConnected property is false and the getChargeRemainingInPercent is zero. For Matrice 600, there are 6 elements in this array.

      Return:
      BatteryOverview[]The BatteryOverview instance.
      method isAnyBatteryDisconnected
      boolean isAnyBatteryDisconnected()
      Package:dji.common.battery
      SDK Key:BatteryKey.IS_ANY_BATTERY_DISCONNECTED
      Description:

      true if one of the batteries in the group is disconnected. When true, the aircraft is not allowed to take off.

      Return:
      booleanA boolean value.
      Electrical
      method
      method getCurrent
      int getCurrent()
      Package:dji.common.battery
      SDK Key:BatteryKey.CURRENT
      Description:

      Returns the real time current draw through the batteries. A negative value means the batteries are being discharged.

      Return:
      intAn int value.
      method getVoltage
      int getVoltage()
      Package:dji.common.battery
      SDK Key:BatteryKey.VOLTAGE
      Description:

      Returns the current voltage (mV) provided by the battery group.

      Return:
      intAn int value.
      method isVoltageDifferenceDetected
      boolean isVoltageDifferenceDetected()
      Package:dji.common.battery
      SDK Key:BatteryKey.IS_VOLTAGE_DIFFERENCE_DETECTED
      Description:

      true if there is significant difference between the voltage (above 1.5V) of two batteries. When true, the aircraft is not allowed to take off.

      Return:
      booleanA boolean value.
      method isLowCellVoltageDetected
      boolean isLowCellVoltageDetected()
      Package:dji.common.battery
      SDK Key:BatteryKey.IS_LOW_CELL_VOLTAGE_DETECTED
      Description:

      true if one of the batteries in the group has cells with low voltage. When true, the aircraft is not allowed to take off.

      Return:
      booleanA boolean value.
      Damage
      method
      method isCellDamaged
      boolean isCellDamaged()
      Package:dji.common.battery
      SDK Key:BatteryKey.IS_CELL_DAMAGED
      Description:

      true if one of the batteries in the group has damaged cells. When true, the aircraft is not allowed to take off.

      Return:
      booleanA boolean value.

      Battery Aggregation Properties

      method getFullChargeCapacity
      int getFullChargeCapacity()
      Package:dji.common.battery
      SDK Key:BatteryKey.FULL_CHARGE_CAPACITY
      Description:

      Returns the the total amount of energy, in mAh (milliamp hours), stored in the batteries when the batteries are fully charged.

      Return:
      intAn int value.
      method getChargeRemaining
      int getChargeRemaining()
      Package:dji.common.battery
      SDK Key:BatteryKey.CHARGE_REMAINING
      Description:

      Returns the remaining energy stored in the batteries in mAh (milliamp hours).

      Return:
      intAn int value.
      method getChargeRemainingInPercent
      int getChargeRemainingInPercent()
      Package:dji.common.battery
      SDK Key:BatteryKey.CHARGE_REMAINING_IN_PERCENT
      Description:

      Returns the percentage of energy left in the battery group with range [0,100].

      Return:
      intAn int value.
      method getHighestTemperature
      int getHighestTemperature()
      Package:dji.common.battery
      SDK Key:BatteryKey.HIGHEST_TEMPERATURE
      Description:

      Returns the highest temperature (in Celsius) among the batteries in the group, with range [-128, 127] degrees.

      Return:
      intAn int value.
      method isFirmwareDifferenceDetected
      boolean isFirmwareDifferenceDetected()
      Package:dji.common.battery
      SDK Key:BatteryKey.IS_FIRMWARE_DIFFERENCE_DETECTED
      Description:

      true if one of the batteries in the group has a firmware version different from the others. When it is true, the aircraft is not allowed to take off.

      Return:
      booleanA boolean value.


      Callbacks
      interface
      interface Callback
      interface Callback
      Package:dji.common.battery
      SDK Key:BatteryKey.AGGREGATION_STATE
      Description:

      This interface provides a callback to update the current aggregated battery state.

      Interface Methods:

      Callback Method

      State
      method
      method onUpdate
      void onUpdate(AggregationState aggregationState)
      Package:dji.common.battery
      SDK Key:BatteryKey.AGGREGATION_STATE
      Description:

      Callback to update aggregated battery state.

      Input Parameters:
      AggregationState aggregationStateThe aggregated battery state.
      General
      class