void enableVirtualStick(CommonCallbacks.CompletionCallback callback)

Description:

Open the virtual stick mode.
Note:
1. For flight safety, when the aircraft is close(about 30 meters) to the restricted flight zone or restricted distance, the remote controller will get the control of the aircraft, and the virtual stick cannot be used.
2. The virtual stick normal mode supports obstacle avoidance by default.
3. In the virtual stick advanced mode, obstacle avoidance is supported only when the vertical control Mode is velocity mode, the yaw control mode is angular velocity mode, and the roll pitch control mode is velocity mode.
4. Currently, only M300 RTK, M350 RTK, M30 series, Mavic 3E series and Mavic 3M aircraft support obstacle avoidance in virtual joystick mode.
5. For aircraft models Mavic 3E series, and Mavic 3M, if the firmware version is below V7.01.10.03, obstacle sensing will be disabled when virtual stick mode is activated. We recommend updating the aircraft to the latest firmware version for optimal functionality.


Supported since MSDK 5.0.0

Input Parameters:

void disableVirtualStick(CommonCallbacks.CompletionCallback callback)

Description:

Close the virtual stick mode.

Supported since MSDK 5.0.0

Input Parameters:

IStick getLeftStick()

Description:

To get the left stick instance of the virtual stick. Left stick controls the yaw axis and throttle of the aircraft.

• When the stick moves left, the horizontalPosition is negative. The aircraft will rotate counterclockwise when looking down at the aircraft.
• When the stick moves right, the horizontalPosition is positive. The aircraft will rotate clockwise when looking down at the aircraft.
• When the stick moves upward, the verticalPosition is positive. The aircraft will increase its altitude.
• When the stick moves downward, the verticalPosition is negative. The aircraft will lower its altitude.

Return:

IStick getRightStick()

Description:

To get the right stick instance of the virtual stick. Right stick controls the roll axis and pitch axis of the aircraft.

• When the stick moves left, the horizontalPosition is negative. The aircraft will fly left when looking down at the aircraft.
• When the stick moves right, the horizontalPosition is positive. The aircraft will fly right when looking down at the aircraft.
• When the stick moves upward, the verticalPosition is positive. The aircraft will fly forward when looking down at the aircraft.
• When the stick moves downward, the verticalPosition is negative. The aircraft will fly backward when looking down at the aircraft.

Return:

void setVirtualStickAdvancedModeEnabled(boolean isEnabled)

Description:

Enable virtual stick advanced mode. In advanced mode, the control data of left stick getLeftStick and right stick getLeftStick will no longer take effect, you can call sendVirtualStickAdvancedParam to set more advanced control parameters for use with more complex application scenarios, such as using a virtual stick to implement waypoint-related functions.

Supported since MSDK 5.1.0

Input Parameters:

void sendVirtualStickAdvancedParam(@NonNull VirtualStickFlightControlParam param)

Description:

Send virtual stick advanced control parameters.

Input Parameters:

void setVirtualStickStateListener(VirtualStickStateListener listener)

Description:

To set the listener of the virtual stick status.

Supported since MSDK 5.0.0

Input Parameters:

void removeVirtualStickStateListener(VirtualStickStateListener listener)

Description:

Remove the listener of the virtual stick status.

Supported since MSDK 5.0.0

Input Parameters:

void clearAllVirtualStickStateListener()

Description:

Clean all the listener of the virtual stick status.

Supported since MSDK 5.0.0

enum FlightControlAuthority implements JNIProguardKeepTag

Description:

Flight control authority.

Supported since MSDK 5.0.0

Enum Members:

Class Members:

enum FlightControlAuthorityChangeReason implements JNIProguardKeepTag

Description:

Flight control authority change reason.

Supported since MSDK 5.0.0

Enum Members:

Class Members: