DJI Mobile SDK Documentation
      包:dji.v5.manager.interfaces
      继承自:IVisualManager, IPerceptionCommon
      classSince MSDK 5.0.0

      IPerceptionManager

      此类是感知避障管理类,用于开启、关闭感知避障开关,设置避障类型, 设置避障告警距离和刹停距离以及获取障碍物测距数据等功能。同时可以调用getRadarManager获取毫米波雷达配件(如有安装)的信息和数据。

      Package dji.v5.manager.interfacesAndroid · Java / Kotlin

      此类是感知避障管理类,用于开启、关闭感知避障开关,设置避障类型, 设置避障告警距离和刹停距离以及获取障碍物测距数据等功能。同时可以调用getRadarManager获取毫米波雷达配件(如有安装)的信息和数据。

      MSDK 5.0.0开始支持

      成员

      28 个成员

      监听

      6

      方法

      15

      枚举

      2

      Class

      5
      method

      setObstacleAvoidanceType

      Since MSDK 5.0.0
      void setObstacleAvoidanceType(ObstacleAvoidanceType type, CommonCallbacks.CompletionCallback callback)

      设置感知避障类型。

      参数

      名称类型说明
      typeObstacleAvoidanceType 感知避障类型。
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getObstacleAvoidanceType

      Since MSDK 5.0.0
      void getObstacleAvoidanceType( CommonCallbacks.CompletionCallbackWithParam<ObstacleAvoidanceType> callback)

      获取设置的感知避障类型。

      参数

      名称类型说明
      callbackCommonCallbacks.CompletionCallbackWithParam<ObstacleAvoidanceType> 返回执行结果的回调。
      method

      setOverallObstacleAvoidanceEnabled

      Since MSDK 5.0.0
      void setOverallObstacleAvoidanceEnabled(boolean isEnabled,
      CommonCallbacks.CompletionCallback callback)

      开启或者关闭感知避障总开关。MSDK同时会自动开启或者关闭所有的感知避障子开关。如果安装了毫米波雷达配件,同时也会自动开启或者关闭所有的毫米波雷达的避障子开关。

      注意

      该接口从MSDK 5.1.0版本开始废弃。请调用setObstacleAvoidanceType把避障类型设置为BRAKE或CLOSE来开启或者关闭避障开关。对于毫米波雷达配件,需要调用setObstacleAvoidanceEnabled来开启或者关闭避障开关。

      参数

      名称类型说明
      isEnabledboolean true表示开启感知避障总开关。
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getOverallObstacleAvoidanceEnabled

      Since MSDK 5.0.0
      void getOverallObstacleAvoidanceEnabled( CommonCallbacks.CompletionCallbackWithParam<Boolean> callback)

      返回是否开启感知避障总开关。

      注意

      该接口从MSDK 5.1.0版本开始废弃。请调用getObstacleAvoidanceType来获取是否开启避障开关。对于毫米波雷达配件,需要调用getObstacleAvoidanceEnabled来获取是否开启避障开关。

      参数

      名称类型说明
      callbackCommonCallbacks.CompletionCallbackWithParam<Boolean> 返回执行结果的回调。
      method

      setObstacleAvoidanceEnabled

      Since MSDK 5.0.0
      void setObstacleAvoidanceEnabled(boolean isEnabled, @NonNull
      PerceptionDirection direction, CommonCallbacks.CompletionCallback callback)

      开启或者关闭感知避障子开关。

      注意
      对于不支持BRAKE类型的机型,比如Mini 3和Mini 3 Pro无法独立开启或者关闭感知避障子开关。

      参数

      名称类型说明
      isEnabledboolean true表示开启感知避障子开关。
      direction@NonNull PerceptionDirection 感知避障子开关的方向。
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getObstacleAvoidanceEnabled

      Since MSDK 5.0.0
      void getObstacleAvoidanceEnabled(@NonNull PerceptionDirection direction, @NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> callback)

      返回是否开启感知避障子开关。

      参数

      名称类型说明
      direction@NonNull PerceptionDirection 感知避障子开关的方向。
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> 返回执行结果的回调。
      method

      setObstacleAvoidanceWarningDistance

      Since MSDK 5.0.0
      void setObstacleAvoidanceWarningDistance(double distance, @NonNull PerceptionDirection direction,
      CommonCallbacks.CompletionCallback callback)

      设置避障告警距离,单位:米。

    • 以M30系列机型为例:(其他机型请参考DJI Pilot 2的范围)
    • 水平告警距离范围:[1.1, 33.0]。
    • 上方告警距离范围:[1.1, 33.0]。
    • 下方告警距离范围:[0.6, 33.0]。


    • MSDK 5.0.0开始支持

      参数

      名称类型说明
      distancedouble 感知避障告警距离。
      direction@NonNull PerceptionDirection 感知避障方向。
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getObstacleAvoidanceWarningDistance

      Since MSDK 5.0.0
      void getObstacleAvoidanceWarningDistance(@NonNull PerceptionDirection direction,
      CommonCallbacks.CompletionCallbackWithParam<Double> callback)

      获取避障告警距离。

      参数

      名称类型说明
      direction@NonNull PerceptionDirection 感知避障方向。
      callbackCommonCallbacks.CompletionCallbackWithParam<Double> 返回执行结果的回调。
      method

      setObstacleAvoidanceBrakingDistance

      Since MSDK 5.0.0
      void setObstacleAvoidanceBrakingDistance(double distance, @NonNull PerceptionDirection direction,
      CommonCallbacks.CompletionCallback callback)

      设置避障刹停距离,单位:米。

    • 以M30系列机型为例:(其他机型请参考DJI Pilot 2的范围)
    • 水平刹停距离范围:[1.0, 10.0]。
    • 上方刹停距离范围:[1.0, 10.0]。
    • 下方刹停距离范围:[0.5, 3.0]。


    • MSDK 5.0.0开始支持

      参数

      名称类型说明
      distancedouble 感知避障刹停距离。
      direction@NonNull PerceptionDirection 感知避障方向。
      callbackCommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getObstacleAvoidanceBrakingDistance

      Since MSDK 5.0.0
      void getObstacleAvoidanceBrakingDistance(@NonNull PerceptionDirection direction,
      CommonCallbacks.CompletionCallbackWithParam<Double> callback)

      获取避障刹停距离。

      参数

      名称类型说明
      direction@NonNull PerceptionDirection 感知避障方向。
      callbackCommonCallbacks.CompletionCallbackWithParam<Double> 返回执行结果的回调。
      method

      setVisionPositioningEnabled

      Since MSDK 5.0.0
      void setVisionPositioningEnabled(boolean isEnabled, @NonNull CommonCallbacks.CompletionCallback callback)

      开启或者关闭视觉定位。视觉定位系统帮助你在GPS信号不佳的地方稳定悬停,并对降落保护等功能提供支持。关闭下视避障将关闭降落保护功能。

      参数

      名称类型说明
      isEnabledboolean true表示开启视觉定位。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getVisionPositioningEnabled

      Since MSDK 5.0.0
      void getVisionPositioningEnabled(@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> callback)

      返回是否开启视觉定位。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> 返回执行结果的回调。
      method

      setPrecisionLandingEnabled

      Since MSDK 5.0.0
      void setPrecisionLandingEnabled(boolean isEnabled, @NonNull CommonCallbacks.CompletionCallback callback)

      开启或者关闭精准降落。飞行器垂直起飞7米以上,将自动搜集起飞点附近信息,如果信息搜集充分,一键返航时会精准降落到起飞点。

      参数

      名称类型说明
      isEnabledboolean true表示开启精准降落。
      callback@NonNull CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      getPrecisionLandingEnabled

      Since MSDK 5.0.0
      void getPrecisionLandingEnabled(@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> callback)

      返回是否开启精准降落。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<Boolean> 返回执行结果的回调。
      method

      addPerceptionInformationListener

      Since MSDK 5.0.0
      void addPerceptionInformationListener(@NonNull PerceptionInformationListener listener)

      设置感知信息的监听器。

      参数

      名称类型说明
      listener@NonNull PerceptionInformationListener 感知信息的监听器
      method

      removePerceptionInformationListener

      Since MSDK 5.0.0
      void removePerceptionInformationListener(@NonNull PerceptionInformationListener listener)

      移除感知信息的监听器。

      参数

      名称类型说明
      listener@NonNull PerceptionInformationListener 感知信息的监听器
      method

      clearAllPerceptionInformationListener

      Since MSDK 5.0.0
      void clearAllPerceptionInformationListener()

      移除所有感知信息的监听器。

      method

      addObstacleDataListener

      Since MSDK 5.1.0
      void addObstacleDataListener(ObstacleDataListener listener)

      设置感知数据的监听器,用于获取障碍物测距数据。

      参数

      名称类型说明
      listenerObstacleDataListener 感知数据的监听器
      method

      removeObstacleDataListener

      Since MSDK 5.1.0
      void removeObstacleDataListener(ObstacleDataListener listener)

      移除感知数据的监听器。

      参数

      名称类型说明
      listenerObstacleDataListener 感知数据的监听器
      method

      clearAllObstacleDataListener

      Since MSDK 5.1.0
      void clearAllObstacleDataListener()

      移除所有感知数据的监听器。

      method

      getRadarManager

      Since MSDK 5.1.0
      IRadarManager getRadarManager()

      获取RadarManager实例。只有安装了毫米波雷达配件才能获取到该实例。

      返回值

      类型说明
      IRadarManager返回RadarKManager实例。
      enum

      PerceptionDirection

      Since MSDK 5.0.0

      感知避障方向。

      枚举成员

      名称说明
      UPWARD上方。
      DOWNWARD下方。
      HORIZONTAL水平,前后左右四个方向。
      enum

      ObstacleAvoidanceType

      Since MSDK 5.0.0

      感知避障类型。

      枚举成员

      名称说明
      BRAKE刹停。飞行器遇到障碍物将自动悬停。
      BYPASS绕行。飞行器遇到障碍物将自动选择绕过障碍物或者悬停。
      CLOSE关闭。飞行器全向避障系统将不可用,飞行器全向有障碍物时将不会自动刹停和绕行。
      class

      PerceptionInfo

      Since MSDK 5.0.0
      class PerceptionInfo

      感知信息,包括感知避障开关状态、避障刹停距离和避障告警距离。

      class

      PerceptionInformationListener

      Since MSDK 5.0.0
      interface PerceptionInformationListener

      感知信息监听器。

      class

      ObstacleData

      Since MSDK 5.1.0
      class ObstacleData

      感知数据,包括障碍物测距数据。

      class

      ObstacleDataListener

      Since MSDK 5.1.0
      interface ObstacleDataListener

      感知数据监听器。

      class

      IRadarManager

      Since MSDK 5.1.0
      interface IRadarManager

      此类是雷达管理类,用于开启、关闭雷达避障开关,获取障碍物测距数据。