| 包: | dji.sdk.keyvalue.key |
| 继承自: | DJIGimbalKey |
GimbalKey
GimbalKey提供了一组方法来设置和获取云台数据。包括获取云台姿态数据、控制云台转动、以及云台的相关参数设置。
描述:
基础信息
KeyConnection
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Boolean
true表示云台已连接。
KeyFirmwareVersion
Since MSDK 5.0.0static final DJIKeyInfo |
参数: String
获取云台固件版本。
KeyGimbalAttitude
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Attitude
获取云台姿态数据。其中偏航角度使用的是北东地坐标系,如需要获取云台相对于飞行器机头朝向的偏航角度,请调用KeyYawRelativeToAircraftHeading获取。
KeyYawRelativeToAircraftHeading
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Double
获取云台相对于飞行器机头朝向的偏航角度。
基本操作
KeyGimbalMode
Since MSDK 5.0.0static final DJIKeyInfo |
参数: GimbalMode
设置云台模式。
KeyRotateByAngle
Since MSDK 5.0.0static final DJIActionKeyInfo |
参数: GimbalAngleRotation
用角度模式旋转云台的俯仰角度、横滚角度和偏航角度。支持相对角度模式和绝对角度模式。
不同的云台负载的可控制角度不一样,以下提供了一种方法获取云台的最大最小限位角度:请通过遥控器的滚轮控制云台到俯仰,横滚和偏航的最大最小限位,然后调用
KeyGimbalAttitude即可获取到该云台的可调限位角度。KeyRotateBySpeed
Since MSDK 5.0.0static final DJIActionKeyInfo |
参数: GimbalSpeedRotation
用速度模式旋转云台的俯仰角度、横滚角度和偏航角度。单位:0.1度/秒,范围:[-359.9, 359.9]。设置的值越大,单位时间转动的角度越大,设置频率和链路信号强弱会对最终转动角度造成偏差。
KeyGimbalReset
Since MSDK 5.0.0static final DJIActionKeyInfo |
参数: GimbalResetType
云台重置,可以通过设置GimbalResetType让俯仰轴,偏航轴和横滚轴回中或者朝下。
KeyFineTunePitchInDegrees
Since MSDK 5.0.0static final DJIActionKeyInfo |
参数: Double
云台俯仰轴可以通过自定义偏移量进行微调。当云台回中后仍然有小角度偏移,可用此功能进行云台调平。单次可微调的范围是[-2.0, 2.0],单位:度,总共可微调的范围是[-10.0, 10.0],单位:度, 如果偏移量为负数,云台将在逆时针方向微调指定的度数。可通过KeyFineTunePitchTotalDegree获取总共微调的偏移量。
KeyFineTuneYawInDegrees
Since MSDK 5.0.0static final DJIActionKeyInfo |
参数: Double
云台偏航轴可以通过自定义偏移量进行微调。当云台回中后仍然有小角度偏移,可用此功能进行云台微调,使得云台水平居中。单次可微调的范围是[-2.0, 2.0],单位:度,总共可微调的范围是[-10.0, 10.0],单位:度, 如果偏移量为负数,云台将在逆时针方向微调指定的度数。可通过KeyFineTuneYawTotalDegree获取总共微调的偏移量。
KeyFineTuneRollInDegrees
Since MSDK 5.0.0static final DJIActionKeyInfo |
参数: Double
云台横滚轴可以通过自定义偏移量进行微调。当云台回中后仍然有小角度偏移,可用此功能进行云台调平,使得云台水平居中。单次可微调的范围是[-2.0, 2.0],单位:度,总共可微调的范围是[-10.0, 10.0],单位:度, 如果偏移量为负数,云台将在逆时针方向微调指定的度数。可通过KeyFineTuneRollTotalDegree获取总共微调的偏移量。
KeyFineTunePitchTotalDegree
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Double
获取云台俯仰轴总偏移量。可通过KeyFineTunePitchInDegrees进行微调。
KeyFineTuneYawTotalDegree
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Double
获取云台偏航轴总偏移量。可通过KeyFineTuneYawInDegrees进行微调。
KeyFineTuneRollTotalDegree
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Double
获取云台横滚轴总偏移量。可通过KeyFineTuneRollInDegrees进行微调。
KeyLightGimbalCalibrate
Since MSDK 5.12.0static final DJIActionKeyInfo |
启动探照灯云台自动校准。可通过KeyLightGimbalCalibrationStatus监听校准状态。 仅支持AL1 探照灯。
KeyLightGimbalCalibrationStatus
Since MSDK 5.12.0static final DJIKeyInfo |
参数: GimbalCalibrationStatusInfo
获取探照灯云台校准状态和校准进度。调用KeyLightGimbalCalibrate启动探照灯云台校准后才能获取探照灯云台校准状态和校准进度。
KeyLightGimbalFineTunePitchInDegrees
Since MSDK 5.12.0static final DJIActionKeyInfo |
参数: LightGimbalAdjustInfo
探照灯云台俯仰轴可以通过自定义偏移量进行微调。当探照灯云台回中后仍然有小角度偏移,可用此功能进行云台调平。单次可微调的范围是[-2.0, 2.0],单位:度,总共可微调的范围是[-10.0, 10.0],单位:度, 如果偏移量为负数,探照灯云台将在逆时针方向微调指定的度数。可通过KeyLightGimbalPitchTotalInDegrees获取总共微调的偏移量。
KeyLightGimbalPitchTotalInDegrees
Since MSDK 5.12.0static final DJIKeyInfo |
参数: LightGimbalTotalAdjustInfo
获取探照灯云台俯仰轴总偏移量。可通过KeyLightGimbalFineTunePitchInDegrees进行微调。
KeyGimbalCalibrate
Since MSDK 5.0.0static final DJIActionKeyInfo |
启动云台自动校准。可通过KeyGimbalCalibrationStatus监听校准状态。
KeyGimbalCalibrationStatus
Since MSDK 5.0.0static final DJIKeyInfo |
参数: GimbalCalibrationStatusInfo
获取云台校准状态和校准进度。调用KeyGimbalCalibrate启动云台校准后才能获取云台校准状态和校准进度。
KeyRestoreFactorySettings
Since MSDK 5.0.0static final DJIActionKeyInfo |
将云台参数恢复到出厂设置。
基本设置
KeyPitchRangeExtensionEnabled
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Boolean
设置开启或者关闭云台俯仰限位扩展。以M30系列机型为例,它们的云台是下置的,在未开启限位扩展时,云台俯仰限位的角度范围为[45, -90],在开启限位扩展后,角度范围扩展到[45, -120]。也就是说开启俯仰限位扩展后,当云台俯仰轴往下调节时,角度可以控制到-120度。
KeyPitchControlMaxSpeed
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Integer
设置云台俯仰控制的最大速度,该数值为百分比,范围:[1,100]。数值越大速度越快,100%则表示云台所能达到的最大物理速度进行控制。
KeyYawControlMaxSpeed
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Integer
设置云台偏航控制的最大速度,该数值为百分比,范围:[1,100]。数值越大速度越快,100%则表示云台所能达到的最大物理速度进行控制。
KeyPitchSmoothingFactor
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Integer
设置云台俯仰缓启/停,范围:[0,30],数值越大,控制云台俯仰轴启动/停止转动的缓冲距离越长。
KeyYawSmoothingFactor
Since MSDK 5.0.0static final DJIKeyInfo |
参数: Integer
设置云台偏航缓启/停,范围:[0,30],数值越大,控制云台偏航轴启动/停止转动的缓冲距离越长。
KeyGimbalVerticalShotEnabled
Since MSDK 5.3.0static final DJIKeyInfo |
参数: Boolean
设置开启或者关闭竖拍。通常用于消费类机型。