DJI Mobile SDK Documentation

      class LandingGear

      class LandingGear
      Package:dji.sdk.flightcontroller
      Description:

      This class controls and gives state of the landing gear. Please check isLandingGearMovable before calling the methods in this class.

      Class Members:
      State
      method
      method getState
      LandingGearState getState()
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.LANDING_GEAR_STATUS
      Description:

      The current state/position of the landing gear.

      Return:
      LandingGearStateAn enum value of LandingGearState
      method
      method getMode
      LandingGearMode getMode()
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.LANDING_GEAR_MODE
      Description:

      The current mode of the landing gear.

      Return:
      LandingGearModeAn enum value of LandingGearMode
      Automatic Movement Mode
      method
      method setAutomaticMovementEnabled
      void setAutomaticMovementEnabled(boolean enabled, @Nullable final CompletionCallback callback)
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.LANDING_GEAR_AUTOMATIC_MOVEMENT_ENABLED
      Description:

      Turns on/off self-adaptive landing gear. When turned on, landing gear will automatically lower when aircraft is 0.5m above the ground. After take-off, landing gear will automatically rise when aircraft reaches 0.5m above the ground. If self-adaptive landing gear is turned off, aircraft will not automatically raise or lower its landing gear.

      Input Parameters:
      boolean enabledYES if automatic movement is enabled.
      @Nullable final CompletionCallback callbackAsynchronous execution result.
      method getAutomaticMovementEnabled
      void getAutomaticMovementEnabled(@NonNull CompletionCallbackWith<Boolean> callback)
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.LANDING_GEAR_AUTOMATIC_MOVEMENT_ENABLED
      Description:

      Gets self-adaptive landing gear state (on/off). When turned on, landing gear will automatically lower when aircraft is 0.5m above the ground. After take-off, landing gear will automatically rise when aircraft reaches 0.5m above the ground. If self-adaptive landing gear is turned off, aircraft will not automatically raise or lower its landing gear.

      Input Parameters:
      @NonNull CompletionCallbackWith<Boolean> callbackCompletion callback that receives the execution result.
      Transport Mode
      method
      method enterTransportMode
      void enterTransportMode(@Nullable final CompletionCallback callback)
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.ENTER_TRANSPORT_MODE
      Description:

      Enters transport mode, moving the landing gear to its optimal position for transportation. Note that if the gimbal is not removed, or the ground is not flat, entering transport mode will fail.

      Input Parameters:
      @Nullable final CompletionCallback callbackThe execution callback with the execution result returned.
      method exitTransportMode
      void exitTransportMode(@Nullable CompletionCallback callback)
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.EXIT_TRANSPORT_MODE
      Description:

      Exits transport mode. Note that if the ground is not flat, exit transport mode will fail.

      Input Parameters:
      @Nullable CompletionCallback callbackThe execution callback with the execution result returned.
      Retract/Deploy Landing Gear
      method
      method retract
      void retract(@Nullable CompletionCallback callback)
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.RETRACT_LANDING_GEAR
      Description:

      Retracts the landing gear. Should only be used when getMode is MANUAL. For Matrice 600 and Matrice 600 Pro, landing gear cannot be controlled through the SDK, only automatically by the aircraft or manually by the remote controller.

      Input Parameters:
      @Nullable CompletionCallback callbackThe execution callback with the execution result returned.
      method
      method deploy
      void deploy(@Nullable final CompletionCallback callback)
      Package:dji.sdk.flightcontroller
      SDK Key:FlightControllerKey.DEPLOY_LANDING_GEAR
      Description:

      Deploys landing gear. Should only be used when getMode is MANUAL. For Matrice 600 and Matrice 600 Pro, the landing gear cannot be controlled through the SDK, only automatically by the aircraft or manually by the remote controller.

      Input Parameters:
      @Nullable final CompletionCallback callbackThe execution callback with the execution result returned.
      enum LandingGearState
      @EXClassNullAway
      enum LandingGearState
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.LANDING_GEAR_STATUS
      Description:

      Current state of landing gear.

      Enum Members:
      UNKNOWNLanding gear is in unknown state. This will be returned if the aircraft can't get the landing gear status.
      DEPLOYEDLanding gear is fully deployed (ready for landing)
      RETRACTEDLanding gear is fully retracted (ready for flying).
      DEPLOYINGLanding gear is deploying (getting ready for landing).
      RETRACTINGLanding gear is retracting (getting ready for flying).
      STOPPEDLanding gear is stopped.
      Class Members:
      enum LandingGearMode
      @EXClassNullAway
      enum LandingGearMode
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.LANDING_GEAR_MODE
      Description:

      Current Mode of the landing gear.

      Enum Members:
      MANUALLanding gear can be deployed and retracted through function calls.
      TRANSPORTLanding gear is in transport mode (either it is moving into, moving out of, or stopped in transport position).
      AUTOLanding gear automatically transitions between deployed and retracted depending on altitude. During take-off, the transition point is 1.2m above ground. After take-off (during flight or when landing), the transition point is 0.5m above ground.
      UNKNOWNLanding Gear is in an unknown mode.
      Class Members: