Enables/disables active obstacle avoidance. When enabled, and an obstacle is moving toward the aircraft, the aircraft will actively fly away from it. If while actively avoiding a moving obstacle, the aircraft detects another obstacle in its avoidance path, it will stop. setCollisionAvoidanceEnabled must also be enabled.
Input Parameters:
boolean enabled
true to enable the active avoidance.
@Nullable CompletionCallback callback
Completion callback that receives the setter result.
Enables/disables upward avoidance. When the Inspire 2's upwards-facing infrared sensor detects an obstacle, the aircraft will slow its ascent and maintain a minimum distance of 1 meter from the obstacle. The sensor has a 10-degree horizontal field of view (FOV) and 10-degree vertical FOV. The maximum detection distance is 5m.
Input Parameters:
Boolean enabled
true to enable the upwards avoidance.
@Nullable CompletionCallback callback
Completion callback that receives the setter result.
Enables/disables advanced gesture control. When enabled, users can use PalmLaunch, PalmLand, PalmControl and Beckon. When enabled, the various modes can be initiated by the user. In summary: - Aircraft starts idle on users hand - User double clicks the power button and FaceAware becomes active - Once a face is recogized, PalmLaunch will happen - When flying, the user can control the aircraft position by moving their palm - If the user waves one hand, the aircraft will fly up and backwards and start following the user. - If the user waves both hands, the aircraft will execute Beckon and return to the user. It is only supported by Spark.
Input Parameters:
boolean enabled
true to enable advanced gesture control.
@Nullable CompletionCallback callback
The completion callback with the returned execution result.
Determines whether advanced gesture control is enabled. When enabled, users can use PalmLaunch, PalmLand, PalmControl and Beckon. It is only supported by Spark.
Input Parameters:
@NonNull CompletionCallbackWith<Boolean> callback
The completion callback with the returned execution result.
Enables/disables SmartCapture. When enabled, deep learning gesture recognition allows the user to take selfies, record videos, and control the aircraft (GestureLaunch, Follow and GestureLand) using simple hand gestures. It is only supported when isSmartCaptureSupported returns true.
Determines whether SmartCapture is enabled. When enabled, users can When enabled, deep learning gesture recognition allows the user to take selfies, record videos, and control the aircraft (GestureLaunch, Follow and GestureLand) using simple hand gestures. It is only supported when isSmartCaptureSupported returns true.
Input Parameters:
@NonNull CompletionCallbackWith<Boolean> callback
Completion block with the returned execution result.
Enables the Advanced Pilot Assistance System (APAS). When APAS is enabled, the aircraft continues to respond to user commands and plans its path according to both control stick inputs and the flight environment. APAS makes it easier to avoid obstacles and obtain smoother footage, and gives a better fly experiences. It is only valid when the aircraft is in P-mode. It is only supported by Mavic Air, Mavic 2 Pro, Mavic 2 Zoom, Mavic 2 Enterprise.
Input Parameters:
boolean enabled
true to enable APAS.
@Nullable CompletionCallback callback
The completion callback with the returned execution result.
Determines whether the Advanced Pilot Assistance System (APAS) is enabled or not. When APAS is enabled, the aircraft continues to respond to user commands and plans its path according to both control stick inputs and the flight environment. APAS makes it easier to avoid obstacles and obtain smoother footage, and gives a better fly experiences. It It is only supported by Mavic Air, Mavic 2 Pro, Mavic 2 Zoom, Mavic 2 Enterprise.
Input Parameters:
@NonNull CompletionCallbackWith<Boolean> callback
The completion callback with the returned execution result.
Enables/Disabled the Forbid Side Fly Switch. In APAS mode when the Forbid Side Fly Switch is turned on, the aircraft cannot fly sideways. Supported by DJI Air 2S.
Input Parameters:
boolean enabled
true to enable forbid side fly.
@Nullable CompletionCallback callback
The completion callback with the returned execution result.
Enables Obstacle Avoidance during RTH. This is only active when the environment is bright enough. It is not active when the aircraft is landing. CAUTION: If RTH Obstacle Avoidance is disabled, aircraft will not check obstacles during RTH or ascend to avoid obstacles, which may cause great risks.
Determines if Obstacle Avoidance is enabled during RTH. This is only active when the environment is bright enough. It is not active when the aircraft is landing. CAUTION: If RTH Obstacle Avoidance is disabled, aircraft will not check obstacles during RTH or ascend to avoid obstacles, which may cause great risks.
Enables Remote Obstacle Avoidance during RTH. Enabling this, the aircraft will adjust its RTH route automatically to avoid obstacles in far distance. The gimbal will not respond to any commands from the application or the remote controller.
Input Parameters:
boolean enabled
true to enable Remote Obstacle Avoidance during RTH.
Determines if RTH Remote Obstacle Avoidance is enabled or not. When it is enabled, the aircraft will adjust its RTH route automatically to avoid obstacles in far distance. The gimbal will not respond to any commands from the application or the remote controller.
Sets the upward fill light mode. It is only supported by Matrice 300 RTK. The distance range for Horizontal is 1m~5m. The distance range for Upward is 1m~10m. The distance range for Downward is 1dm~30dm.
The perception direction. If is DJIFlightController_DJIFlightAssistantObstacleSensingDirection_Downward, the distance range is [0.1, 3], For Matrice 300 RTK the range is [0.4, 3]. If is DJIFlightController_DJIFlightAssistantObstacleSensingDirection_Upward, the distance range is [1.0, 10]. If is DJIFlightController_DJIFlightAssistantObstacleSensingDirection_Horizontal, the distance range is [1.0, 5].
Enable vision positioning. Vision positioning is used to augment GPS to improve location accuracy when hovering and improve velocity calculation when flying.
Enables/disables precision landing. When enabled, the aircraft will record its take-off location visually (as well as with GPS). On a Return-To-Home action the aircraft will attempt to perform a precision landing using the additional visual information. This method only works on a Return-To-Home action when the home location is successfully recorded during take-off, and not changed during flight, It will take effect only after flying 10 meters high at the return point.
Enables/disables landing protection. During auto-landing, the downwards facing vision sensor will check if the ground surface is flat enough for a safe landing. If it is not and landing protection is enabled, then landing will abort and need to be manually performed by the user.
Input Parameters:
boolean enabled
true to enable the landing protection.
@Nullable final CompletionCallback callback
<<>android:Callback> that receives the setter result.
FaceAware states. FaceAware is a step of PalmLaunch. Tapping the battery battery power button twice, FaceAware will start to work automatically. If FaceAware is activated successfully, the aircraft will takeoff from the palm.
Enum Members:
IDLE
The aircraft is not executing FaceAware.
ACTIVATING
The aircraft is in the process of detecting a human face in front of the camera.
ACTIVATED
FaceAware has been activated. The aircraft will beep twice and the motors will start spinning.
FAILED_NO_FACE_DETECTED
FaceAware has failed to activate because no face was detected.
The aircraft is moving into position for the PalmControl Follow command. In this state, the aircraft is ascending and flying backward to a position that is 3m horizontally away from the user and 2.3m above the ground. Once it has reached this position, the state will move to FOLLOWING and the aircraft will then follow the user. The Follow command can be initiated by raising one arm and quickly waving your hand at the camera.
FOLLOWING
The aircraft is currently following the user. To reach this state, the user first raises one arm and quickly waves their hand at the aircraft's camera. The aircraft will then move into position (3m from the user and 2.3m above the ground), and reach this state.
ADJUSTING_POSITION
The aircraft's position is being adjusted by the moving palm.
PALM_CONTROL_STOPPED
PalmControl is stopped. PalmControl can be stopped by moving the sticks on the physical remote controller or sending commands through MobileRemoteController when the physical remote controller is absent.
Modes for the fill light at the bottom or top of the aircraft.
Enum Members:
AUTO
The auto mode. In this mode, the auxiliary light will be turned on automatically when the downward or top vision system is active but the environment is too dark.
ON
The auxiliary light is on.
OFF
The auxiliary light is off.
BEACON
Beacon mode. In this mode, the auxiliary light will have different behaviors in different conditions: - When the aircraft just takes off, the auxiliary light will have the same behavior as ''DJIFillLightMode_Auto''. - When the aircraft ascends above 5.5 meters, the auxiliary light starts to blink in 1Hz. - When the aircraft descends below 4.5 meters, the auxiliary light will have the same behavior as ''DJIFillLightMode_Auto''. This mode is only supported by Mavic 2 Enterprise.