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:withCompletion must also be enabled.
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.
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.
Determines whether advanced gesture control is enabled. When enabled, users can use PalmLaunch, PalmLand, PalmControl and Beckon. It is only supported by Spark.
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 YES.
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 YES.
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.
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.
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.
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:
BOOL enabled
YES 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.
Input Parameters:
BOOL enabled
YES if Remote RTH Obstacle Avoidance is enabled during RTH.
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.
Callback function that updates the FaceAware state. When starting a PalmLaunch, the aircraft will start FaceAware. If FaceAware activates successfully, the motors will start spinning and the aircraft will hover after releasing it.
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:
DJIVisionFaceAwareStateIdle
The aircraft is not executing FaceAware.
DJIVisionFaceAwareStateActivating
The aircraft is in the process of detecting a human face in front of the camera.
DJIVisionFaceAwareStateActivated
FaceAware has been activated. The aircraft will beep twice and the motors will start spinning.
DJIVisionFaceAwareStateFailedNoFaceDetected
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 DJIVisionPalmControlStateFollowing 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.
DJIVisionPalmControlStateFollowing
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.
DJIVisionPalmControlStateAdjustingPosition
The aircraft's position is being adjusted by the moving palm.
DJIVisionPalmControlStatePalmControlStopped
PalmControl is stopped. PalmControl can be stopped by moving the sticks on the physical remote controller or sending commands through DJIMobileRemoteController when the physical remote controller is absent.
Modes for the fill light at the bottom or top of the aircraft.
Enum Members:
DJIFillLightModeAuto
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.
DJIFillLightModeOn
The auxiliary light is on.
DJIFillLightModeOff
The auxiliary light is off.
DJIFillLightModeBeacon
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.