DJI Mobile SDK Documentation
      包:dji.sdk.keyvalue.key
      classSince MSDK 5.0.0

      KeyTools

      Key工具类。DJI封装了一系列更加简洁易用的方法创建DJIKey实例。

      Package dji.sdk.keyvalue.keyAndroid · Java / Kotlin

      Key工具类。DJI封装了一系列更加简洁易用的方法创建DJIKey实例。


      MSDK 5.0.0开始支持

      成员

      11 个成员

      方法

      8

      枚举

      2

      Class

      1
      method
      method

      createKey

      Since MSDK 5.0.0
      @NonNull
      static <T> DJIKey<T> createKey(DJIKeyInfo<T> mKeyInfo, int productId, int componentIndex, int subComponentType, int subComponentIndex)

      创建Key实例的默认方法。

      参数

      名称类型说明
      mKeyInfoDJIKeyInfo<T> DJIKey中某个Key接口。例如CameraKey.KeyCameraType,表示相机类型的Key。
      productIdint 当前连接上的设备的产品ID,默认为0。
      componentIndexint 云台负载位置。请参考ComponentIndexType设置相应的int值。
      subComponentTypeint 相机镜头类型。请参考CameraLensType设置相应的int值。
      subComponentIndexint 预留参数。

      返回值

      类型说明
      static <T> DJIKey<T>返回DJIKey实例。
      method
      method

      createKey

      Since MSDK 5.0.0
      @NonNull
      static <T> DJIKey<T> createKey(DJIKeyInfo<T> mKeyInfo)

      传入某个Key接口的DJIKeyInfo实例的方式创建Key实例。此方法适用于跟云台负载和相机无关的Key的实例创建。

      参数

      名称类型说明
      mKeyInfoDJIKeyInfo<T> DJIKey中某个Key接口。例如FlightControllerKey.KeyAircraftAttitude,表示获取飞行器姿态的Key。

      返回值

      类型说明
      static <T> DJIKey<T>返回DJIKey实例。
      method
      method

      createKey

      Since MSDK 5.0.0
      @NonNull
      static <T> DJIKey<T> createKey(DJIKeyInfo<T> mKeyInfo, @NonNull ComponentIndexType componentIndexType)

      传入某个Key接口的DJIKeyInfo实例和云台负载位置的方式创建Key实例。此方法适用于跟云台负载相关的Key的实例创建。

      参数

      名称类型说明
      mKeyInfoDJIKeyInfo<T> DJIKey中某个Key接口。例如GimbalKey.KeyGimbalReset,表示云台重置的Key。
      componentIndexType@NonNull ComponentIndexType 云台负载位置。

      返回值

      类型说明
      static <T> DJIKey<T>返回DJIKey实例。
      method

      createCameraKey

      @NonNull
      static <T> DJIKey<T> createCameraKey(DJIKeyInfo<T> mKeyInfo, ComponentIndexType componentIndexType, CameraLensType cameraLensType)

      传入某个Key接口的DJIKeyInfo实例、云台负载位置和相机镜头类型的方式创建Key实例。此方法适用于跟相机相关的Key的实例创建。

      参数

      名称类型说明
      mKeyInfoDJIKeyInfo<T> DJIKey中某个Key接口。例如CameraKey.KeyCameraType,表示相机类型的Key。
      componentIndexTypeComponentIndexType 云台负载位置。
      cameraLensTypeCameraLensType 相机镜头类型。

      返回值

      类型说明
      static <T> DJIKey<T>返回DJIKey实例。
      method
      method

      createKey

      Since MSDK 5.0.0
      @NonNull
      static <T, R> DJIKey.ActionKey<T, R> createKey(DJIActionKeyInfo<T, R> mKeyInfo, int productId, int componentIndex, int subComponentType, int subComponentIndex)

      创建ActionKey实例的默认方法。

      参数

      名称类型说明
      mKeyInfoDJIActionKeyInfo<T, R> DJIKey中某个Key接口。例如CameraKey.KeyCameraType,表示相机类型的Key。
      productIdint 当前连接上的设备的产品ID,默认为0。
      componentIndexint 云台负载位置。请参考ComponentIndexType设置相应的int值。
      subComponentTypeint 相机镜头类型。请参考CameraLensType设置相应的int值。
      subComponentIndexint 预留参数。

      返回值

      类型说明
      static <T, R> DJIKey.ActionKey<T, R>返回DJIKey实例。
      method
      method

      createKey

      Since MSDK 5.0.0
      @NonNull
      static <T, R> DJIKey.ActionKey<T, R> createKey(DJIActionKeyInfo<T, R> mKeyInfo)

      传入某个Key接口的DJIKeyInfo实例的方式创建ActionKey实例。此方法适用于跟云台负载和相机无关的ActionKey的实例创建。

      参数

      名称类型说明
      mKeyInfoDJIActionKeyInfo<T, R> DJIKey中某个Key接口。例如CameraKey.KeyCameraType,表示相机类型的Key。

      返回值

      类型说明
      static <T, R> DJIKey.ActionKey<T, R>返回DJIKey实例。
      method
      method

      createKey

      Since MSDK 5.0.0
      static <T, R> DJIKey.ActionKey<T, R> createKey(DJIActionKeyInfo<T, R> mKeyInfo, ComponentIndexType componentIndexType) 

      传入某个ActionKey接口的DJIKeyInfo实例和云台负载位置的方式创建Key实例。此方法适用于跟云台负载相关的ActionKey的实例创建。

      参数

      名称类型说明
      mKeyInfoDJIActionKeyInfo<T, R> DJIKey中某个Key接口。例如CameraKey.KeyCameraType,表示相机类型的Key。
      componentIndexTypeComponentIndexType 云台负载位置。

      返回值

      类型说明
      static <T, R> DJIKey.ActionKey<T, R>返回DJIKey实例。
      method

      createCameraKey

      @NonNull
      static <T, R> DJIKey.ActionKey<T, R> createCameraKey(DJIActionKeyInfo<T, R> mKeyInfo, ComponentIndexType componentIndexType, CameraLensType cameraLensType)

      传入某个ActionKey接口的DJIKeyInfo实例、云台负载位置和相机镜头类型的方式创建Key实例。此方法适用于跟相机相关的ActionKey的实例创建。

      参数

      名称类型说明
      mKeyInfoDJIActionKeyInfo<T, R> DJIKey中某个Key接口。例如CameraKey.KeyCameraType,表示相机类型的Key。
      componentIndexTypeComponentIndexType 云台负载位置。
      cameraLensTypeCameraLensType 相机镜头类型。

      返回值

      类型说明
      static <T, R> DJIKey.ActionKey<T, R>返回DJIKey实例。
      class

      DJIKeyInfo

      Since MSDK 5.0.0
      class DJIKeyInfo<T>

      Key信息类,定义了Key的能力。

      enum

      ComponentIndexType

      云台负载位置。

      枚举成员

      名称说明
      LEFT_OR_MAIN位于飞行器左舷侧(主)。
      RIGHT位于飞行器右舷侧。
      UP位于飞行器上侧。
      FPV位于飞行器机头侧,一般是FPV的位置。
      PORT_1位于飞机端口1。
      PORT_2位于飞机端口2。
      PORT_3位于飞机端口3。
      PORT_4位于飞机端口4。
      PORT_5位于飞机端口5。
      PORT_6位于飞机端口6。
      PORT_7位于飞机端口7。
      PORT_8位于飞机端口8。
      enum

      CameraLensType

      相机镜头类型。

      枚举成员

      名称说明
      CAMERA_LENS_ZOOM变焦镜头。
      CAMERA_LENS_WIDE广角镜头。
      CAMERA_LENS_THERMAL红外镜头。
      CAMERA_LENS_RGB多光谱RGB镜头。在Pilot中显示为可见光。
      CAMERA_LENS_MS_NDVI多光谱NDVI镜头。
      CAMERA_LENS_MS_G多光谱G镜头。
      CAMERA_LENS_MS_R多光谱R镜头。
      CAMERA_LENS_MS_RE多光谱RE镜头。
      CAMERA_LENS_MS_NIR多光谱NIR镜头。
      CAMERA_LENS_DEFAULT默认镜头,对于只有一个镜头的相机,则无需区分变焦,广角或者红外镜头,使用此默认镜头类型。