DJI Mobile SDK Documentation

      class IntelligentHotpointMissionOperator

      class IntelligentHotpointMissionOperator
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      The Intelligent hotpoint mission operator is the only object that controls, runs and monitors Intelligent Hotpoint Missions. It can be accessed from MissionControl. IntelligentHotpointMissionOperator has two ways to start an Intelligent hotpoint mission: One is to start a DJIIntelligentHotpointMission, which will repeatedly around a specified point called hotpoint. The other you will target a rect in your FPV view, and send it to Vision system to track, when the state change to DJIIntelligentHotpointMissionOperator_WaitingForConfirmation, you can acceptConfirmation, then the aircraft will fly around the object. When mission executing, it will not need target object, actually track mode only help to set hotpoint at a target object.
      Now only supported by Mavic 2 Zoom and Mavic 2 Pro.

      Class Members:
      interface IntelligentHotpointMissionOperatorListener
      interface IntelligentHotpointMissionOperatorListener
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Listener interface for listening to intelligent hotpoint mission events.

      Interface Methods:
      State Update
      method
      method onExecutionUpdate
      void onExecutionUpdate(@NonNull IntelligentHotpointMissionEvent event)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Called when a new intelligent hotpoint mission event occurs.

      Input Parameters:
      @NonNull IntelligentHotpointMissionEvent eventUpdated event.
      method onExecutionStart
      void onExecutionStart()
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Called when the intelligent hotpoint mission starts.

      method onExecutionFinish
      void onExecutionFinish(@Nullable DJIError error)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Called when the intelligent hotpoint mission ends.

      Input Parameters:
      @Nullable DJIError errorUsed when mission is finishes in an unexpected way.
      POI Mode
      method
      method isPOIModeEnabled
      boolean isPOIModeEnabled()
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      true if POI mode is enabled. Value is undefined if the getCurrentState is one of the following:
      - NOT_SUPPORTED
      - DISCONNECTED
      - RECOVERING.
      Now only supported by Mavic 2 Zoom and Mavic 2 Pro.

      Return:
      booleanA boolean value to check if POI Mode is enabled.
      method enablePOIMode
      void enablePOIMode(@NonNull final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Enable POI mode. enabling POI mode is the pre-condition of starting Intelligent Hotpoint Mission. Now only supported by Mavic 2 Zoom and Mavic 2 Pro.

      Input Parameters:
      @NonNull final CommonCallbacks.CompletionCallback callbackCompletionCallback callback that receives the execution result.
      method disablePOIMode
      void disablePOIMode(@NonNull final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Disable POI mode. When POI mode is disabled, you can not starting Intelligent Hotpoint mission. Now only supported by Mavic 2 Zoom and Mavic 2 Pro.

      Input Parameters:
      @NonNull final CommonCallbacks.CompletionCallback callbackCompletion callback that receives the execution result.
      Current State
      method
      method getCurrentState
      @NonNull
      IntelligentHotpointMissionState getCurrentState()
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      The current state of the executing Intelligent Hotpoint mission.

      Return:
      IntelligentHotpointMissionStateAn object of IntelligentHotpointMissionState.
      Add Listener
      method
      method addListener
      void addListener(@NonNull IntelligentHotpointMissionOperatorListener listener)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Adds listener to receive all of the Intelligent Hotpoint mission operator events.

      Input Parameters:
      @NonNull IntelligentHotpointMissionOperatorListener listenerListener that is interested in the intelligent hotpoint mission operator.
      Remove Listener
      method
      method removeListener
      void removeListener(@NonNull IntelligentHotpointMissionOperatorListener targetListener)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Removes listener. If the listener is listening to events and notifications, then it will stop listening to all if called with this method.

      Input Parameters:
      @NonNull IntelligentHotpointMissionOperatorListener targetListenerListener to be removed.
      method removeAllListeners
      void removeAllListeners()
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Remove all listeners from listener pool.

      Start Mission
      method
      method startMission
      void startMission(@NonNull IntelligentHotpointMission mission, @Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Starts to execute an Intelligent Hotpoint mission. This only be called when the getCurrentState is READY_TO_START. After a mission is started successfully, the getCurrentState will become EXECUTING. If the mission starts successful, the aircraft will fly arround the "hotpoint" of the mission. The current horizontal distance between the aircraft and the hotpoint must be [5,500]. The current vertical distance between the aircraft and the relative takeoff altitude must be [5,500].

      Input Parameters:
      @NonNull IntelligentHotpointMission missionAn object of IntelligentHotpointMission.
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails to start the mission. If it fails, an error will be returned.
      Start Recognize
      method
      method startRecognizeTargetInRect
      void startRecognizeTargetInRect(@NonNull RectF rectF, @Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Send a target rect in video stream to aircraft, the vision system will recognize the target in the rect. This only be called when the getCurrentState is READY_TO_START. After recognize target success, the getCurrentState will become WAITING_FOR_CONFIRMATION means recognize the target successfully or READY_TO_START means can not recognize the target.

      Input Parameters:
      @NonNull RectF rectFThe tracking target rect in video stream.
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails to start recognize target. If it fails, an error will be returned.
      Accept Confirmation
      method
      method acceptConfirmation
      void acceptConfirmation(@Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Confirm the recognized target, only be called when the getCurrentState is WAITING_FOR_CONFIRMATION. If accept successfully, the getCurrentState will become MEASURING_TARGET, the aircraft will measure the the target and calculate surrounding path. Then the aircraft will start circle around the target on the surrounding path and getCurrentState will become EXECUTING.

      Input Parameters:
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      Pause Mission
      method
      method pauseMission
      void pauseMission(@Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Pauses the executing mission. It can only be called when the getCurrentState is EXECUTING. After a mission is paused successfully, the getCurrentState will become EXECUTION_PAUSED.

      Input Parameters:
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      method resumeMission
      void resumeMission(@Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Resumes the paused mission. It can only be called when the getCurrentState is EXECUTION_PAUSED. After a mission is resumed successfully, the getCurrentState will become EXECUTING.

      Input Parameters:
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      Stop Mission
      method
      method stopMission
      void stopMission(@Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Stops the executing or paused mission. It can only be called when getCurrentState is one of the following:
      - EXECUTING
      - EXECUTION_PAUSED After a mission is stopped successfully, getCurrentState will become READY_TO_START.

      Input Parameters:
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      Set Angular Velocity
      method
      method setAngularVelocity
      void setAngularVelocity(float angularVelocity, @Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Sets angular velocity for the executing mission. It can only be called when getCurrentState is one of the following:
      - EXECUTING
      - EXECUTION_PAUSED

      Input Parameters:
      float angularVelocityAngular velocity to set.
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      Set Radius
      method
      method setRadius
      void setRadius(@FloatRange(from = 5, to = 500) float radius, @Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Sets radius for the executing mission. It can only be called when the getCurrentState is one of the following:
      - EXECUTING
      - EXECUTION_PAUSED

      Input Parameters:
      @FloatRange(from = 5, to = 500) float radiusRadius to set.
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      Set Altitude
      method
      method setAltitude
      void setAltitude(@FloatRange(from = 5, to = 500) float altitude, @Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Sets altitude for the executing mission. It can only be called when the getCurrentState is one of the following:
      - EXECUTING
      - EXECUTION_PAUSED

      Input Parameters:
      @FloatRange(from = 5, to = 500) float altitudealtitude to set.
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.
      Reset Gimbal To Center
      method
      method resetGimbalToCenter
      void resetGimbalToCenter(@Nullable final CommonCallbacks.CompletionCallback callback)
      Package:dji.sdk.mission.intelligenthotpoint
      Description:

      Reset gimbal to center for the executing mission, the camera will direct to the target. It can only be called when the getCurrentState is one of the following:
      - EXECUTING
      - EXECUTION_PAUSED
      This feature is only avaliable in recognize mission.

      Input Parameters:
      @Nullable final CommonCallbacks.CompletionCallback callbackCompletion callback that will be called when the operator succeeds or fails. If it fails, an error will be returned.