| 包: | dji.v5.manager.interfaces |
classSince MSDK 5.0.0
IVirtualStickManager
此类是虚拟摇杆管理类,用于开启、关闭虚拟摇杆模式,并提供虚拟摇杆状态监听,虚拟摇杆移动量的获取与设置等功能。
描述:
method
method
enableVirtualStick
Since MSDK 5.0.0void enableVirtualStick(CommonCallbacks |
开启虚拟摇杆模式。
注意
1. 出于飞行安全考虑,飞行器在靠近限飞区或者限远距离30米时,遥控器会夺取飞行器控制权,虚拟摇杆功能无法使用。
2. 虚拟摇杆普通模式默认支持避障。
3. 虚拟摇杆高级模式下只有在垂直方向控制模式是速度模式,偏航轴控制模式是角速度并且横滚和俯仰轴控制模式是速度模式的组合下才支持避障。
4. 目前只有 M300 RTK,M350 RTK,M30 系列和 Mavic 3E 系列和 Mavic 3M 飞行器支持在虚拟摇杆模式下避障。
5. 若 Mavic 3E 系列和 Mavic 3M 机型固件版本低于 V7.01.10.03,在虚拟摇杆模式启动时,视觉避障不生效,建议升级到最新固件版本。
1. 出于飞行安全考虑,飞行器在靠近限飞区或者限远距离30米时,遥控器会夺取飞行器控制权,虚拟摇杆功能无法使用。
2. 虚拟摇杆普通模式默认支持避障。
3. 虚拟摇杆高级模式下只有在垂直方向控制模式是速度模式,偏航轴控制模式是角速度并且横滚和俯仰轴控制模式是速度模式的组合下才支持避障。
4. 目前只有 M300 RTK,M350 RTK,M30 系列和 Mavic 3E 系列和 Mavic 3M 飞行器支持在虚拟摇杆模式下避障。
5. 若 Mavic 3E 系列和 Mavic 3M 机型固件版本低于 V7.01.10.03,在虚拟摇杆模式启动时,视觉避障不生效,建议升级到最新固件版本。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
method
method
disableVirtualStick
Since MSDK 5.0.0void disableVirtualStick(CommonCallbacks |
关闭虚拟摇杆模式。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
method
method
getLeftStick
Since MSDK 5.0.0IStick getLeftStick() |
获取虚拟摇杆中的左遥杆实例。左摇杆控制飞行器偏航轴和油门:
- 此摇杆向左移动的时候(horizontalPosition为负数),俯视飞行器视角下,飞行器会逆时针转动。
- 此摇杆向右移动的时候(horizontalPosition为正数),俯视飞行器视角下,飞行器会顺时针转动。
- 此摇杆向上移动的时候(verticalPosition为正数),飞行器会升高自身高度。
- 此摇杆向下移动的时候(verticalPosition为负数),飞行器会降低自身高度。
MSDK 5.0.0开始支持
返回值
| 类型 | 说明 |
|---|---|
IStick | 返回左摇杆实例。 |
method
method
getRightStick
Since MSDK 5.0.0IStick getRightStick() |
获取虚拟摇杆中的右遥杆实例。右摇杆控制飞行器横滚轴和俯仰轴:
- 此摇杆往左移动的时候(horizontalPosition为负数),飞行器自身视角下,飞行器会往左飞行。
- 此摇杆往右移动的时候(horizontalPosition为正数),飞行器自身视角下,飞行器会往右边飞行。
- 此摇杆向上移动的时候(verticalPosition为正数),飞行器自身视角下,飞行器会往前飞。
- 此摇杆向下移动的时候(verticalPosition为负数),飞行器自身视角下,飞行器会往后飞。
MSDK 5.0.0开始支持
返回值
| 类型 | 说明 |
|---|---|
IStick | 返回右摇杆实例。 |
method
setVirtualStickAdvancedModeEnabled
void setVirtualStickAdvancedModeEnabled(boolean isEnabled) |
开启虚拟摇杆高级模式。在高级模式下,左摇杆getLeftStick和右摇杆getLeftStick的控制数据将不再生效,你可以调用sendVirtualStickAdvancedParam设置更高级的控制参数,用于使用更复杂的应用场景,比如用虚拟摇杆实现航线相关功能。 MSDK 5.1 .0开始支持
参数
| 名称 | 类型 | 说明 |
|---|---|---|
isEnabled | boolean | true表示开启虚拟摇杆高级模式。 |
method
sendVirtualStickAdvancedParam
Since MSDK 5.1.0void sendVirtualStickAdvancedParam(@NonNull |
发送虚拟摇杆高级控制参数。
setVirtualStickAdvancedModeEnabled把高级模式打开后才能使用此接口。VirtualStickRangeMSDK 5.1.0开始支持
参数
| 名称 | 类型 | 说明 |
|---|---|---|
param | @NonNull | 高级模式参数。 |
method
setVirtualStickStateListener
Since MSDK 5.0.0void setVirtualStickStateListener(VirtualStickStateListener listener) |
设置虚拟遥杆状态的监听器。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | VirtualStickStateListener | 虚拟遥杆状态的监听器 |
method
removeVirtualStickStateListener
Since MSDK 5.0.0void removeVirtualStickStateListener(VirtualStickStateListener listener) |
移除虚拟遥杆状态的监听器。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | VirtualStickStateListener | 虚拟遥杆状态的监听器 |
method
clearAllVirtualStickStateListener
Since MSDK 5.0.0void clearAllVirtualStickStateListener() |
移除所有虚拟遥杆状态的监听器。
Related:
class
class
IStick
Since MSDK 5.0.0interface IStick |
虚拟摇杆类。用于虚拟摇杆移动量的设置和获取。
class
VirtualStickFlightControlParam
Since MSDK 5.1.0class VirtualStickFlightControlParam implements DJIValue, JNIProguardKeepTag, ByteStream |
虚拟摇杆高级控制参数。
class
VirtualStickStateListener
Since MSDK 5.0.0interface VirtualStickStateListener |
虚拟遥杆状态监听器。
class
class
VirtualStickState
Since MSDK 5.0.0class VirtualStickState |
虚拟遥杆功能状态。
enum
FlightControlAuthorityChangeReason
Since MSDK 5.0.0飞行控制权变更原因。