DJI Mobile SDK Documentation

      class DJILandingGear

      @interface DJILandingGear : NSObject
      Header:DJILandingGear.h
      Inherits From:NSObject
      Description:

      This class controls and gives state of the landing gear.

      Class Members:
      State
      property
      property state
      @property(nonatomic, readonly) DJILandingGearState state
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearState
      Description:

      The current state/position of the landing gear.

      See Also:

      DJILandingGearState

      property
      property mode
      @property(nonatomic, readonly) DJILandingGearMode mode
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearMode
      Description:

      The current mode of the landing gear.

      See Also:

      DJILandingGearMode

      Automatic Movement Mode
      method
      method setAutomaticMovementEnabled:withCompletion
      - (void)setAutomaticMovementEnabled:(BOOL)enabled
      withCompletion:(DJICompletionBlock)completion
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearAutomaticMovementEnabled
      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:
      BOOL enabledYES if automatic movement is enabled.
      DJICompletionBlock completionAsynchronous execution result.
      method getAutomaticMovementEnabledWithCompletion
      - (void)getAutomaticMovementEnabledWithCompletion:(void (^_Nonnull)(BOOL enabled, NSError *_Nullable error))completion
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearAutomaticMovementEnabled
      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:
      BOOL enabledYES if automatic movement is enabled.
      NSError *_Nullable errorError retrieving the value.
      void (^_Nonnull)(BOOL enabled, NSError *_Nullable error) completionCompletion block to receive the result.
      method enterTransportModeWithCompletion
      - (void)enterTransportModeWithCompletion:(DJICompletionBlock)completion
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearEnterTransportMode
      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:
      DJICompletionBlock completionCompletion block that receives the execution result.
      method exitTransportModeWithCompletion
      - (void)exitTransportModeWithCompletion:(DJICompletionBlock)completion
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearExitTransportMode
      Description:

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

      Input Parameters:
      DJICompletionBlock completionCompletion block that receives the execution result.
      Retract/Deploy Landing Gear
      method
      method retractWithCompletion
      - (void)retractWithCompletion:(DJICompletionBlock)completion
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearRetractLandingGear
      Description:

      Retracts the landing gear. Should only be used when mode is DJILandingGearModeManual. 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:
      DJICompletionBlock completionCompletion block that receives the execution result.
      method deployWithCompletion
      - (void)deployWithCompletion:(DJICompletionBlock)completion
      Header:DJILandingGear.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearDeployLandingGear
      Description:

      Deploys landing gear. Should only be used when mode is DJILandingGearModeManual. 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:
      DJICompletionBlock completionCompletion block that receives the execution result.
      enum DJILandingGearState
      typedef NS_ENUM (uint8_t, DJILandingGearState)
      Header:DJILandingGearStructs.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearState
      Description:

      Current state of landing gear.

      Enum Members:
      DJILandingGearStateUnknownLanding gear is in unknown state. This will be returned if the aircraft can't get the landing gear status.
      DJILandingGearStateDeployedLanding gear is fully deployed (ready for landing)
      DJILandingGearStateRetractedLanding gear is fully retracted (ready for flying).
      DJILandingGearStateDeployingLanding gear is deploying (getting ready for landing).
      DJILandingGearStateRetractingLanding gear is retracting (getting ready for flying).
      DJILandingGearStateStoppedLanding gear is stopped.
      enum DJILandingGearMode
      typedef NS_ENUM (uint8_t, DJILandingGearMode)
      Header:DJILandingGearStructs.h
      SDK Key:DJIFlightControllerKey.DJIFlightControllerParamLandingGearMode
      Description:

      Current Mode of the landing gear.

      Enum Members:
      DJILandingGearModeManualLanding gear can be deployed and retracted through function calls.
      DJILandingGearModeTransportLanding gear is in transport mode (either it is moving into, moving out of, or stopped in transport position).
      DJILandingGearModeAutoLanding 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.
      DJILandingGearModeUnknownLanding Gear is in an unknown mode.