DJI Mobile SDK Documentation

      class LowBatteryRTHInfo

      class LowBatteryRTHInfo implements DJIValue, JNIProguardKeepTag, ByteStream
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      Smart return-to-home information.

      Class Members:

      Members

      method getRemainingFlightTime
      Integer getRemainingFlightTime()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      Parameter: Integer

      To get the estimated remaining flight time. Unit: second. The estimated remaining flight time is the time required for the aircraft to return home with 10% of the remaining battery power, including the time for the aircraft to land. If the aircraft is using the simulator, the value will be 0.

      Return:
      IntegerReturn the estimated remaining flight time.
      method getTimeNeededToGoHome
      Integer getTimeNeededToGoHome()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      Parameter: Integer

      To get the time required to complete smart return-to-home. Unit: second. The estimated time of the aircraft flying from present location to home point.

      Return:
      IntegerReturn the time required to complete smart return-to-home.
      method getTimeNeededToLand
      Integer getTimeNeededToLand()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      Parameter: Integer

      To get the time required to complete the landing. Unit: second. The estimated time of the aircraft to complete landing in the present position.

      Return:
      IntegerReturn the time required to complete landing.
      method getBatteryPercentNeededToGoHome
      Integer getBatteryPercentNeededToGoHome()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      Parameter: Integer

      To get the remaining power percentage when the aircraft needs smart low battery return-to-home. When the remaining power percentage is lower than this value, low battery return-to-home will be prompted.

      Return:
      IntegerReturn the remaining power percentage when the aircraft needs to return home.
      method getBatteryPercentNeededToLand
      Integer getBatteryPercentNeededToLand()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      Parameter: Integer

      To get the remaining power percentage when the aircraft needs of low battery landing. When the remaining power percentage is lower than this value, the low battery landing will be prompted.

      Return:
      IntegerReturn the remaining power percentage when the aircraft needs to land.
      method getMaxRadiusCanFlyAndGoHome
      Double getMaxRadiusCanFlyAndGoHome()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      To get the maximum safety flight radius with the home point as the center. Unit: meter. The maximum safety flight radius that the aircraft can safely return to the home point, which is calculated based on the flight altitude, distance from the home point, remaining battery power and other information. If the flight distance of the aircraft exceeds the radius, the aircraft may land on the way back.

      Return:
      DoubleReturn the maximum safty flight radius with the home point as the center.
      method getSmartRTHCountdown
      Integer getSmartRTHCountdown()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      To get the user confirmed countdown when returning home in low battery. Unit: second. Once the countdown reaches 0, the aircraft will automatically return home. Only when the getLowBatteryRTHStatus is COUNTING_DOWN, it can work.

      Return:
      IntegerReturn the user confirmed countdown when returning to home in low battery.
      method getLowBatteryRTHStatus
      LowBatteryRTHState getLowBatteryRTHStatus()
      Package:dji.sdk.keyvalue.value.flightcontroller
      Description:

      To get the status of low battery return-to-home.

      Return:
      LowBatteryRTHStateReturn the status of low battery return-to-home.