DJI Mobile SDK Documentation

      class BatteryKey

      @Keep
      class BatteryKey extends DJIBatteryKey
      包:dji.sdk.keyvalue.key
      继承自:DJIBatteryKey
      描述:

      BatteryKey提供了一组方法来管理飞行器电池的信息和实时状态。通过设置componentIndex来获取对应电池的信息和实时状态。 以M30系列飞行器为例:0表示Pilot中的电池1(左)、1表示Pilot中的电池2(右)。

      MSDK 5.0.0开始支持

      类成员:

      基础信息

      连接状态
      final KeyConnection
      static final DJIKeyInfo<Boolean> KeyConnection = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"Connection", SingleValueConverter.BooleanConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      true表示飞行器电池已连接。

      MSDK 5.0.0开始支持

      final KeyFullChargeCapacity
      static final DJIKeyInfo<Integer> KeyFullChargeCapacity = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"FullChargeCapacity", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取电池充满时的电池容量,单位:mAh。随着电池的持续使用,充满电时电池的容量会随着时间而减小。

      MSDK 5.0.0开始支持

      剩余电量
      final KeyChargeRemaining
      static final DJIKeyInfo<Integer> KeyChargeRemaining = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ChargeRemaining", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取电池剩余容量,单位:mAh。

      MSDK 5.0.0开始支持

      剩余电量百分比
      final KeyChargeRemainingInPercent
      static final DJIKeyInfo<Integer> KeyChargeRemainingInPercent = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ChargeRemainingInPercent", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取电池剩余电量百分比。如果你需要获取所有电池的总电量百分比,可以通过设置不同的componentIndex获取到所有的电池剩余电量和电池容量进行计算获取。

      MSDK 5.0.0开始支持

      final KeyBatteryHighVoltageStorageTime
      static final DJIKeyInfo<Long> KeyBatteryHighVoltageStorageTime = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"BatteryHighVoltageStorageTime", SingleValueConverter.LongConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("BatteryHighVoltageStorageSec")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Long

      获取高电压存储时间。单位:秒。电池电量90%(含)以上状态存储时间。12个月内,电池高电压存储累计时间少于120天,其循环次数可达400次。可通过修改电池自放电天数调整高电压存储时间。

      MSDK 5.3.0开始支持

      final KeyBatteryTemperature
      static final DJIKeyInfo<Double> KeyBatteryTemperature = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"BatteryTemperature", SingleValueConverter.DoubleConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Double

      获取电池温度,单位:摄氏度。范围区间:[-128, 127]。

      MSDK 5.0.0开始支持

      电压
      final KeyVoltage
      static final DJIKeyInfo<Integer> KeyVoltage = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"Voltage", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取单个电池的电压,单位:mV。

      MSDK 5.0.0开始支持

      电流
      final KeyCurrent
      static final DJIKeyInfo<Integer> KeyCurrent = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"Current", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取电池的实时电流消耗,单位:mA。 负值表示电池正在放电,正值表示正在充电。

      MSDK 5.0.0开始支持

      final KeyNumberOfDischarges
      static final DJIKeyInfo<Integer> KeyNumberOfDischarges = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"NumberOfDischarges", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取电池在其生命周期内经历的总放电次数。放电总数包括通过正常使用发生的放电和手动设置的放电。

      MSDK 5.0.0开始支持

      电芯信息
      final KeyNumberOfCells
      static final DJIKeyInfo<Integer> KeyNumberOfCells = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"NumberOfCells", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      获取电池包含的电芯个数。

      MSDK 5.0.0开始支持

      final KeyCellVoltages
      static final DJIKeyInfo<List<Integer>> KeyCellVoltages = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CellVoltages", new SingleValueConverter<>((Class)List.class,BatteryCellVoltages.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: List

      获取电池中包含的每个电芯的电压。单位:mV。

      MSDK 5.0.0开始支持

      final KeyBatteryManufacturedDate
      static final DJIKeyInfo<Date> KeyBatteryManufacturedDate = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"BatteryManufacturedDate", new DJIValueConverter<>(Date.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Date

      获取电池生产日期。
      注意:
      该接口从MSDK 5.9.0版本开始废弃。


      MSDK 5.0.0开始支持

      序列号
      final KeySerialNumber
      static final DJIKeyInfo<String> KeySerialNumber = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"SerialNumber", SingleValueConverter.StringConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: String

      获取电池序列号。

      MSDK 5.0.0开始支持

      固件版本号
      final KeyFirmwareVersion
      static final DJIKeyInfo<String> KeyFirmwareVersion = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"FirmwareVersion", SingleValueConverter.StringConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: String

      获取电池固件版本。

      MSDK 5.0.0开始支持


      基本设置

      final KeyBatterySelfDischargeInDays
      static final DJIKeyInfo<Integer> KeyBatterySelfDischargeInDays = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"BatterySelfDischargeInDays", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      设置和获取电池开始自放电天数,范围区间:[1, 10]。为了保证电池安全,当长时间放置电池的天数超过自放电天数时,电池会自动放电到安全放置电量。

      MSDK 5.0.0开始支持