DJI Mobile SDK Documentation

      class DJIActiveTrackMission

      @interface DJIActiveTrackMission : DJIMission
      Header:DJIActiveTrackMission.h
      Inherits From:DJIMission
      Description:

      ActiveTrack Mission allows an aircraft to track a moving subject using the vision system and without a GPS tracker on the subject.

      Class Members:
      Target Rect
      property
      property targetRect
      @property (nonatomic, readwrite) CGRect targetRect
      Header:DJIActiveTrackMission.h
      Description:

      A bounding box for the target. The rectangle is normalized to [0,1] where (0,0) is the top left of the video preview and (1,1) is the bottom right. The size parameter of CGRect can be set to 0 to initialize the mission with a point instead of a rectangle. If the mission is initialized with a point, the vision system will try to recognize the object around the point and return the representative rect in the status delegate.

      This property is used when the DJIActiveTrackMission object is passed to startMission:withCompletion. If the object is passed to startAutoSensingMission:withCompletion, this property will be ignored. Use subjectIndex to select the target to track instead.

      Subject Index
      property
      property subjectIndex
      @property (nonatomic, readwrite) NSInteger subjectIndex
      Header:DJIActiveTrackMission.h
      Description:

      The index of the subject to track. After starting auto sensing (by calling enableAutoSensingWithCompletion or enableAutoSensingForQuickShotWithCompletion), the aircraft will push the sensed subjects (autoSensedSubjects). Select the subject to track by passing the index of the subject.

      This property is used when the DJIActiveTrackMission object is passed to startAutoSensingMission:withCompletion. If the object is passed to startMission:withCompletion, this property will be ignored. Use targetRect to define the target to track.

      Mode
      property
      property mode
      @property (nonatomic, readwrite) DJIActiveTrackMode mode
      Header:DJIActiveTrackMission.h
      Description:

      ActiveTrack Mission mode. Defaults to DJIActiveTrackModeTrace.

      See Also:

      DJIActiveTrackMode

      property quickShotMode
      @property (nonatomic, readwrite) DJIActiveTrackQuickShotMode quickShotMode
      Header:DJIActiveTrackMission.h
      Description:

      The QuickShot mode determines the preset flight path. It is only used when mode is DJIActiveTrackModeQuickShot. Defaults to DJIActiveTrackQuickShotModeUnknown. It is only supported by Spark.

      See Also:

      DJIActiveTrackQuickShotMode

      enum DJIActiveTrackMode
      typedef NS_ENUM (NSInteger, DJIActiveTrackMode)
      Header:DJIActiveTrackMission.h
      Description:

      Different modes of the ActiveTrack Mission. Defaults to DJIActiveTrackModeTrace, set to others to enable the feature.

      Enum Members:
      DJIActiveTrackModeTraceAircraft moves in behind the subject keeping a constant distance to it. Mission with this mode can only be started when the aircraft is flying.
      DJIActiveTrackModeProfileAircraft moves in parallel with the subject in the frame instead of behind. Mission with this mode can only be started when the aircraft is flying.
      DJIActiveTrackModeSpotlightIn Spotlight mode, the aircraft camera automatically follows the subject by rotating the aircraft's yaw, but the aircraft does not automatically keep a constant distance with the subject. Mission with this mode can only be started when the aircraft is flying.
      DJIActiveTrackModeSpotlightProIn Spotlight Pro mode, the aircraft camera automatically follows the subject by rotating the gimbal's yaw, but the aircraft does not automatically keep a constant distance with the subject. Not Supported by Mavic Air 2, DJI Air 2S.
      DJIActiveTrackModeQuickShotIn QuickShot mode, the aircraft will fly in one of four preset paths (see DJIActiveTrackQuickShotMode) while tracking the object recording a video. When a QuickShot mission ends, a 10-second video will be generated. Supported by Spark and Mavic 2 Series.
      DJIActiveTrackModeCircleAircraft will circle around the object it is tracking. Only Supported by Mavic Air 2 and Mavic 2 Series.
      DJIActiveTrackModeUnknownThe active track mode is unknown.
      enum DJIActiveTrackQuickShotMode
      typedef NS_ENUM(NSUInteger, DJIActiveTrackQuickShotMode)
      Header:DJIActiveTrackMission.h
      Description:

      QuickShot modes, which define different preset path for a QuickShot mission.

      Enum Members:
      DJIActiveTrackQuickShotModeCircleAircraft will circle around the object it is tracking.
      DJIActiveTrackQuickShotModeDronieAircraft will fly backward and upward with camera locked on the object it is tracking.
      DJIActiveTrackQuickShotModeHelixAircraft will fly upward, spiraling around the object it is tracking.
      DJIActiveTrackQuickShotModeRocketThe aircraft will ascend with the camera pointing downward on the object it is tracking.
      DJIActiveTrackQuickShotModeBoomerangThe aircraft will fly around the tracking object in an upwardly sloped oval with the video finishing at the start point. Supported by DJI Mavic Air, Mavic 2 Zoom and Mavic 2 Pro.
      DJIActiveTrackQuickShotModeAsteroidThe aircraft will fly backward and upward while recording video, capture a sphere panorama at the end of the flight path, then combine the footage and panorama into a short video. Supported by DJI Mavic Air, Mavic 2 Zoom and Mavic 2 Pro.
      DJIActiveTrackQuickShotModeDollyZoomThe aircraft will fly backward and upward. It will adjust the zoom during flight to keep the selected subject the same while the background changes. Ensure there is sufficient space when using Dolly Zoom. Allow at least triple distance from aircraft to the subject behind the aircraft. Only supported by Mavic 2 Zoom.
      DJIActiveTrackQuickShotModeUnknownUnknown.