DJI Mobile SDK Documentation
      包:dji.v5.manager.interfaces
      classSince MSDK 5.2.0

      IPayloadManager

      负载管理类,提供负载信息获取,Widget信息获取和操作以及数据收发等功能。

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

      负载管理类,提供负载信息获取,Widget信息获取和操作以及数据收发等功能。


      MSDK 5.2.0开始支持

      成员

      28 个成员

      监听

      9

      方法

      3

      枚举

      3

      Class

      13
      method

      addPayloadBasicInfoListener

      Since MSDK 5.2.0
      void addPayloadBasicInfoListener(@NonNull PayloadBasicInfoListener listener)

      设置负载基础信息的监听器。

      参数

      名称类型说明
      listener@NonNull PayloadBasicInfoListener 负载基础信息的监听器。
      method

      removePayloadBasicInfoListener

      Since MSDK 5.2.0
      void removePayloadBasicInfoListener(@NonNull PayloadBasicInfoListener listener)

      移除负载基础信息的监听器。

      参数

      名称类型说明
      listener@NonNull PayloadBasicInfoListener 负载基础信息的监听器。
      method

      clearAllPayloadBasicInfoListener

      Since MSDK 5.2.0
      void clearAllPayloadBasicInfoListener()

      移除所有负载基础信息的监听器。

      method

      addPayloadWidgetInfoListener

      Since MSDK 5.2.0
      void addPayloadWidgetInfoListener(@NonNull PayloadWidgetInfoListener listener)

      设置控件信息的监听器。

      参数

      名称类型说明
      listener@NonNull PayloadWidgetInfoListener 控件信息的监听器。
      method

      removePayloadWidgetInfoListener

      Since MSDK 5.2.0
      void removePayloadWidgetInfoListener(@NonNull PayloadWidgetInfoListener listener)

      移除负载控件信息的监听器。

      参数

      名称类型说明
      listener@NonNull PayloadWidgetInfoListener 控件信息的监听器。
      method

      clearAllPayloadWidgetInfoListener

      Since MSDK 5.2.0
      void clearAllPayloadWidgetInfoListener()

      移除所有负载控件信息的监听器。

      method

      addPayloadDataListener

      Since MSDK 5.2.0
      void addPayloadDataListener(@NonNull final PayloadDataListener listener)

      设置负载数据的监听器。

      参数

      名称类型说明
      listener@NonNull final PayloadDataListener 负载数据的监听器。
      method

      removePayloadDataListener

      Since MSDK 5.2.0
      void removePayloadDataListener(@NonNull PayloadDataListener listener)

      移除负载数据的监听器。

      参数

      名称类型说明
      listener@NonNull PayloadDataListener 负载数据的监听器。
      method

      clearAllPayloadDataListener

      Since MSDK 5.2.0
      void clearAllPayloadDataListener()

      移除所有负载数据的监听器。

      method

      pullWidgetInfoFromPayload

      Since MSDK 5.2.0
      void pullWidgetInfoFromPayload(@NonNull CommonCallbacks.CompletionCallback callback)

      从负载中拉取控件信息。在飞行器成功连接负载后,MSDK会在默认从负载中拉取一次控件信息,你可以调用addPayloadWidgetInfoListener设置控件信息监听器来获取控件信息,如果该监听器没有任何回调信息,你可以尝试调用此接口重新从负载中拉取控件信息。

      参数

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

      setWidgetValue

      Since MSDK 5.2.0
      void setWidgetValue(@NonNull WidgetValue value, @NonNull final CommonCallbacks.CompletionCallback callback)

      设置负载中不同类型控件的值。

      参数

      名称类型说明
      value@NonNull WidgetValue 需要设置的控件值。
      callback@NonNull final CommonCallbacks.CompletionCallback 返回执行结果的回调。
      method

      sendDataToPayload

      Since MSDK 5.2.0
      void sendDataToPayload(byte[] data, @NonNull final CommonCallbacks.CompletionCallback callback)

      向负载发送命令数据。该通道的最大带宽为3KBytes/s。

      注意

      M300 RTK单次最大只能发送100字节。其他支持机型单次最大发送255字节。

      参数

      名称类型说明
      databyte[] 需要发送给负载的数据。
      callback@NonNull final CommonCallbacks.CompletionCallback 返回执行结果的回调。
      class

      PayloadBasicInfoListener

      Since MSDK 5.2.0
      interface PayloadBasicInfoListener

      负载基础信息监听器。

      class

      PayloadWidgetInfoListener

      Since MSDK 5.2.0
      interface PayloadWidgetInfoListener

      控件信息监听器。

      class

      PayloadDataListener

      Since MSDK 5.2.0
      interface PayloadDataListener

      负载数据监听器。

      class

      PayloadBasicInfo

      Since MSDK 5.2.0
      class PayloadBasicInfo

      负载基础信息类。

      class

      PayloadWidgetInfo

      Since MSDK 5.2.0
      class PayloadWidgetInfo

      控件信息类。

      class

      PayloadWidget

      Since MSDK 5.2.0
      class PayloadWidget

      负载类型的控件。

      class

      FloatingWindowWidget

      Since MSDK 5.2.0
      class FloatingWindowWidget

      浮窗类型的控件。

      class

      SpeakerWidget

      Since MSDK 5.2.0
      class SpeakerWidget

      喊话器类型的控件。

      class

      TextInputBoxWidget

      Since MSDK 5.2.0
      class TextInputBoxWidget

      文本输入框类型的控件。

      class

      IconFilePath

      Since MSDK 5.2.0
      class IconFilePath

      控件图标文件路径类。

      class

      SubItems

      Since MSDK 5.2.0
      class SubItems

      负载控件子项信息类。

      class

      CustomizeRcButtonConfig

      Since MSDK 5.2.0
      class CustomizeRcButtonConfig implements DJIValue, JNIProguardKeepTag, ByteStream

      遥控器自定义按键配置类。

      enum

      WidgetType

      Since MSDK 5.2.0

      负载控件类型。

      枚举成员

      名称说明
      BUTTON按钮控件,通常默认值为0,当按下按钮时,控件值将更改为1。
      SWITCH开关控件,当开关状态为“ON”时,控件值将更改为1,当开关状态变为“OFF”时,控件值会更改为0。
      RANGE范围控件,可以返回范围在[0,100]的控件值。
      LIST列表控件,可以返回范围在[0,N]的int值,N由第三方负载设备制造商的固件决定,PayloadWidget中getSubItems方法返回的子项个数将为N+1。
      INPUT输入控件,可以设置为任何int值,默认值由第三方负载设备制造商的固件确定。
      class

      WidgetValue

      Since MSDK 5.2.0
      class WidgetValue implements DJIValue, JNIProguardKeepTag, ByteStream

      负载控件值。

      enum

      PayloadType

      Since MSDK 5.2.0

      负载类型。

      枚举成员

      名称说明
      SKYPORT_1SkyPort 1.0。
      SKYPORT_2SkyPort 2.0。
      X_PORTXPort(SkyPort2.0 + 标准云台)。
      enum

      PayloadProductPhaseType

      Since MSDK 5.2.0

      负载产品阶段。

      枚举成员

      名称说明
      PHASE_DEVELOPMENT开发阶段。
      PHASE_RELEASE发布阶段。