DJI Mobile SDK Documentation

      class SmartCaptureState

      class SmartCaptureState
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The object includes all information related to SmartCapture.

      Class Members:
      Capture State
      method
      method getSystemStatus
      SmartCaptureSystemStatus getSystemStatus()
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The system status of SmartCapture.

      Return:
      SmartCaptureSystemStatusAn enum value of SmartCaptureSystemStatus.
      method
      method getAction
      SmartCaptureAction getAction()
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The executing SmartCapture action.

      Return:
      SmartCaptureActionAn enum value of SmartCaptureAction.
      method getFollowingMode
      SmartCaptureFollowingMode getFollowingMode()
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The following mode of SmartCapture.

      Return:
      SmartCaptureFollowingModeAn enum value of SmartCaptureFollowingMode.
      method getPhotoCountdown
      float getPhotoCountdown()
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The countdown for shooting photo.

      Return:
      floatAn int value of photo countdown.
      method getTargetRect
      RectF getTargetRect()
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The dimension of the detected target. It is CGRectNull when the target is invalid.

      Return:
      RectFThe detected target's dimension.
      enum SmartCaptureSystemStatus
      @EXClassNullAway
      enum SmartCaptureSystemStatus
      Package:dji.common.flightcontroller.flightassistant
      Description:

      The system status of SmartCapture.

      Enum Members:
      INITIALIZINGSmartCapture is initializing.
      NOT_FLYING_AND_FACE_AWARE_ACTIVATINGThe aircraft is not flying and detecting a human face in front of the camera.
      NOT_FLYING_AND_FACE_AWARE_ACTIVATEDThe aircraft is not flying and FaceAware has been activated. The aircraft will push the dimension of the target through getTargetRect of SmartCaptureState.
      GESTURE_LAUNCHGestureLaunch is recognized and the aircraft is taking off.
      FLYING_AND_FACE_AWARE_ACTIVATINGThe aircraft is flying and detecting human faces in front of the camera.
      FLYING_AND_FACE_AWARE_ACTIVATEDThe aircraft is flying and detected one or more than one human faces in front of the camera. One of the detected human can raise a hand to confirm the control. Then the SmartCapture state will change to FOLLOWING.
      FOLLOWINGThe aircraft is following the target but not SmartCapture action is recognized.
      PALM_CONTROLThe aircraft is executing PalmControl (controlling the position or the distance). See getAction of SmartCaptureState for more detail.
      CAMERA_CAPTURE_ACTIONThe aircraft is executing camera related action (e.g. shoot photos). See getAction of SmartCaptureState for more detail.
      GESTURE_LANDGestureLand is recognized and the aircraft is landing.
      UNKNOWNUnknown.
      Class Members:
      enum SmartCaptureAction
      enum SmartCaptureAction
      Package:dji.common.flightcontroller.flightassistant
      Description:

      Different actions supported by SmartCapture.

      Enum Members:
      NONENo action is being executed.
      ADJUSTING_POSITIONThe user is adjusting the aircraft's position. Move the palm up or down slowly to control the aircraft's altitude. Move the arm left or right to control the aircraft's orientation.
      ADJUSTING_DISTANCEThe user is adjusting distance between the aircraft and the user. Move two hands apart and the aircraft will fly away from the user. The maximum distance is 19.7ft (6m). Move two hands together and the aircraft will fly towards the user. The minimum distance is 6.6ft (2m).
      SWITCHING_CONTROLThe control of the aircraft is being switched from one person to the other. The current user drops hand towards the floor. The Front LEDs will turn solid green. The person who would like to control the aircraft raise palm in front of the aircraft. When the Front LEDs blinks green slowly, it indicates the control is switched successfully.
      SHOOTING_PHOTOThe camera is shooting photos. Make a V gesture with one hand to trigger the action. Once the gesture is recognized, two-second countdown will begin (getPhotoCountdown of SmartCaptureState).
      RECORDING_VIDEOThe camera is recording video. To start this, make a frame gesture with fingers from both hands. Once the gesture is recognized, the aircraft's front LEDs will turn off and the camera will start recording. After five seconds, use the same gesture to stop the recording.
      UNKNOWNUnknown.
      Class Members:
      enum SmartCaptureFollowingMode
      enum SmartCaptureFollowingMode
      Package:dji.common.flightcontroller.flightassistant
      Description:

      Different following modes of SmartCapture.

      Enum Members:
      TRACEAircraft follows the target at constant distance.
      PROFILEAircraft follows the target at constant angle and distance from the side.
      UNKNOWNUnknown.
      Class Members: