DJI Mobile SDK Documentation

      class VisionControlState

      @EXClassNullAway
      class VisionControlState
      Package:dji.common.flightcontroller
      Description:

      This class gives the aircraft's state, which is controlled by the intelligent flight assistant.

      Class Members:

      State Updates

      interface
      interface Callback
      interface Callback
      Package:dji.common.flightcontroller
      Description:

      This protocol provides an interface to update the Intelligent Flight Assistant vision control state.

      Interface Methods:

      Callback Method

      State
      method
      method onUpdate
      void onUpdate(VisionControlState state)
      Package:dji.common.flightcontroller
      Description:

      Callback function that updates the aircraft state controlled by the intelligent flight assistant.

      Input Parameters:
      VisionControlState stateThe vision control state.
      Collision Avoidance
      method
      method isBraking
      boolean isBraking()
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.IS_BRAKING
      Description:

      true if the aircraft is braking automatically to avoid collision.

      Return:
      booleanA boolean value.
      method isAvoidingActiveObstacleCollision
      boolean isAvoidingActiveObstacleCollision()
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.IS_AVOIDING_ACTIVE_OBSTACLE_COLLISION
      Description:

      true if the aircraft is avoiding collision from an obstacle moving towards the aircraft.

      Return:
      booleanA boolean value.
      method isAscentLimitedByObstacle
      boolean isAscentLimitedByObstacle()
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.IS_ASCENT_LIMITED_BY_OBSTACLE
      Description:

      YES if the aircraft will not ascend further because of an obstacle detected within 1m above it.

      Return:
      booleanA boolean value.
      Precision Landing
      method
      method isPerformingPrecisionLanding
      boolean isPerformingPrecisionLanding()
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.IS_PERFORMING_PRECISION_LANDING
      Description:

      YES if the aircraft is landing precisely.

      Return:
      booleanA boolean value.
      method landingProtectionState
      VisionLandingProtectionState landingProtectionState()
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.LANDING_PROTECTION_STATE
      Description:

      Gets the aircraft's landing protection state. This status is valid when landing protection is enabled.

      Return:
      VisionLandingProtectionStateAn enum value of VisionLandingProtectionState, which will show the state of landing protection.
      method isAdvancedPilotAssistanceSystemActive
      boolean isAdvancedPilotAssistanceSystemActive()
      Package:dji.common.flightcontroller
      Description:

      true if Advanced Pilot Assistance System (APAS) is active. When it is active, the aircraft will change flight path automatically to avoid obstacles.

      Return:
      booleanA boolean value.


      enum VisionLandingProtectionState
      @EXClassNullAway
      enum VisionLandingProtectionState
      Package:dji.common.flightcontroller
      SDK Key:FlightControllerKey.LANDING_PROTECTION_STATE
      Description:

      Landing protection status returned by the downward vision sensor.

      Enum Members:
      NONEThe aircraft is not executing auto-landing or the downward vision sensor has not started to analyze the ground yet.
      ANALYZINGThe downward vision sensor is analyzing the ground at the landing zone.
      ANALYSIS_FAILEDThe downward vision sensor's analysis failed. Either the auto-landing can be attempted again, or the user needs to land the aircraft manually.
      SAFE_TO_LANDThe ground is flat and the aircraft is safe to land automatically.
      NOT_SAFE_TO_LANDLanding area is not flat enough to be considered safe for landing. The aircraft should be moved to an area that is more flat and an auto-land should be attempted again or the user should land the aircraft manually.
      UNKNOWNUnknown.
      Class Members: