DJI Mobile SDK Documentation

      class CameraKey

      @Keep
      class CameraKey extends DJICameraKey
      包:dji.sdk.keyvalue.key
      继承自:DJICameraKey
      描述:

      CameraKey提供了一组方法来设置和获取相机参数。包括相机类型,拍照录像,镜头设置,红外设置等功能。

      MSDK 5.0.0开始支持

      类成员:

      基础信息

      连接状态
      final KeyConnection
      static final DJIKeyInfo<Boolean> KeyConnection = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"Connection", SingleValueConverter.BooleanConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      true表示相机已连接。

      MSDK 5.0.0开始支持

      相机类型
      final KeyCameraType
      static final DJIKeyInfo<CameraType> KeyCameraType = new KeyCameraType()
      .canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: CameraType
      获取相机类型。

      MSDK 5.0.0开始支持

      固件版本号
      final KeyFirmwareVersion
      static final DJIKeyInfo<String> KeyFirmwareVersion = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"FirmwareVersion", SingleValueConverter.StringConverter).canGet(true).canSet(false).canListen(false).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: String

      获取相机固件版本。

      MSDK 5.0.0开始支持


      相机设置

      相机模式
      final KeyCameraModeRange
      static final DJIKeyInfo<List<CameraMode>> KeyCameraModeRange = new KeyCameraModeRange()
      .canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<CameraMode>
      获取当前相机可设置的相机模式。

      MSDK 5.0.0开始支持

      final KeyCameraMode
      static final DJIKeyInfo<CameraMode> KeyCameraMode = new KeyCameraMode()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraMode
      设置相机模式,包括拍照和录像模式。可通过KeyCameraModeRange获取当前相机可设置的工作模式。
      注意:
      全景拍照模式必须在飞行器起飞后才能启动。


      MSDK 5.0.0开始支持

      final KeyIsShootingPhoto
      static final DJIKeyInfo<Boolean> KeyIsShootingPhoto = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"IsShootingPhoto", SingleValueConverter.BooleanConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      true表示相机正在拍照。

      MSDK 5.0.0开始支持

      final KeyStartShootPhoto
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyStartShootPhoto = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"StartShootPhoto", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      开始拍照。相机必须处于拍照模式。对于红外镜头,用户可以在录制视频时拍摄照片。如果拍照模式为PHOTO_INTERVAL,则需要调用KeyStopShootPhoto才能让相机停止拍照。使用此方法前应检查SD卡状态,以确保有足够的空间。

      MSDK 5.0.0开始支持

      final KeyStopShootPhoto
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyStopShootPhoto = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"StopShootPhoto", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      停止拍照。当拍照模式设置为PHOTO_INTERVALPHOTO_SUPER_RESOLUTIONPHOTO_PANORAMA,并且调用了KeyStartShootPhoto开始拍照,你可以调用此接口停止拍照。如果拍照模式设置为单张,拍完单张后相机会自动停止拍照,无需调用此接口。

      MSDK 5.0.0开始支持

      final KeyCaptureCameraStreamSettings
      static final DJIKeyInfo<CameraStreamSettingsInfo> KeyCaptureCameraStreamSettings = new KeyCaptureCameraStreamSettings()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraStreamSettingsInfo
      多镜头拍照存储设置。默认情况下,此相机的所有镜头都会拍照,并且照片会存储到SD卡中。 你可以调用此接口选择需要的镜头进行拍照和存储。在调用该接口之前,您需要调用KeyCameraMode把相机工作模式设置为PHOTO_NORMAL

      注意:
      对于DJI Mavic 3M只支持以下两种设置: 1. 只存储RGB照片:[RGB_CAMERA]
      2. 存储RGB和多光谱照片:[RGB_CAMERA, NDVI_CAMERA, MS_G_CAMERA, MS_R_CAMERA, MS_RE_CAMERA, MS_NIR_CAMERA]



      MSDK 5.0.0开始支持

      final KeyPhotoFileFormatRange
      static final DJIKeyInfo<List<PhotoFileFormat>> KeyPhotoFileFormatRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoFileFormatRange", new SingleValueConverter<>((Class)List.class,PhotoStorageFormatRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("PhotoStorageFormatRange")
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<PhotoFileFormat>
      获取相机的照片格式范围。

      MSDK 5.0.0开始支持

      final KeyPhotoFileFormat
      static final DJIKeyInfo<PhotoFileFormat> KeyPhotoFileFormat = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoFileFormat", new SingleValueConverter<>(PhotoFileFormat.class,PhotoStorageFormatMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("PhotoStorageFormat")
      包:dji.sdk.keyvalue.key
      描述:

      参数:PhotoFileFormat
      设置和获取相机支持的照片格式。只有当KeyCameraMode为拍照模式时才能设置。

      MSDK 5.0.0开始支持

      final KeyPhotoCSize
      static final DJIKeyInfo<PhotoSize> KeyPhotoCSize = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoCSize", new SingleValueConverter<>(PhotoSize.class,PhotoSizeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("PhotoSize")
      包:dji.sdk.keyvalue.key
      描述:

      参数:PhotoSize
      设置和获取相机支持的照片大小。

      注意:
      1. 只有当KeyCameraMode为拍照模式时才能设置。
      2. M30,M30T和Mavic 3T相机支持设置:SIZE_DEFAULTSIZE_LARGE
      3. 其他类型相机的照片尺寸默认为SIZE_DEFAULT,无需设置。


      MSDK 5.6.0开始支持

      final KeyPhotoIntervalShootSettings
      static final DJIKeyInfo<PhotoIntervalShootSettings> KeyPhotoIntervalShootSettings = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoIntervalShootSettings", new DJIValueConverter<>(PhotoIntervalShootSettings.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:PhotoIntervalShootSettings
      设置和获取定时拍照的张数和拍照间隔时间。在KeyCameraModePHOTO_INTERVAL时才能使用。

      MSDK 5.0.0开始支持

      final KeyPhotoIntervalCountdown
      static final DJIKeyInfo<Integer> KeyPhotoIntervalCountdown = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoIntervalCountdown", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Integer
      获取定时拍照的倒计时,当设置了定时拍照模式后,调用KeyStartShootPhoto启动拍照后,相机会以拍照间隔时间进行倒数,倒数到0后会进行一次拍照。在KeyCameraModePHOTO_INTERVAL时使用。

      MSDK 5.0.0开始支持

      final KeySuperResolutionInfo
      static final DJIKeyInfo<SuperResolutionInfo> KeySuperResolutionInfo = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"SuperResolutionInfo", new DJIValueConverter<>(SuperResolutionInfo.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("SuperResolutionState")
      包:dji.sdk.keyvalue.key
      描述:

      参数:SuperResolutionInfo
      获取超清矩阵拍照的状态和信息。在KeyCameraModePHOTO_SUPER_RESOLUTION时使用。

      MSDK 5.0.0开始支持

      final KeySuperResolutionCaptureArea
      static final DJIKeyInfo<DoubleRect4Sides> KeySuperResolutionCaptureArea = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"SuperResolutionCaptureArea", new DJIValueConverter<>(DoubleRect4Sides.class)).canGet(true).canSet(true).canListen(false).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:DoubleRect4Sides
      设置超清矩阵拍照的区域。区域范围:getMaxArea。在KeyCameraModePHOTO_SUPER_RESOLUTION时使用。

      MSDK 5.0.0开始支持

      final KeyPhotoPanoramaMode
      static final DJIKeyInfo<PhotoPanoramaMode> KeyPhotoPanoramaMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoPanoramaMode", new SingleValueConverter<>(PhotoPanoramaMode.class,VisionPhotoPanoramaModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("VisionPhotoPanoramaMode")
      包:dji.sdk.keyvalue.key
      描述:

      参数:PhotoPanoramaMode
      设置全景拍照模式。在KeyCameraModePHOTO_PANORAMA时使用。

      MSDK 5.0.0开始支持

      final KeyIsShootingPhotoPanorama
      static final DJIKeyInfo<Boolean> KeyIsShootingPhotoPanorama = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"IsShootingPhotoPanorama", SingleValueConverter.BooleanConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("IsShootingVisionPanoramaPhoto")
      包:dji.sdk.keyvalue.key
      描述:

      参数:Boolean
      true表示正在进行全景拍照中。在KeyCameraModePHOTO_PANORAMA时使用。

      MSDK 5.0.0开始支持

      final KeyPhotoPanoramaProgress
      static final DJIKeyInfo<Integer> KeyPhotoPanoramaProgress = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoPanoramaProgress", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("PanoramaPhotoCaptureProgress")
      包:dji.sdk.keyvalue.key
      描述:

      参数:Integer
      获取全景拍照的进度百分比。在KeyCameraModePHOTO_PANORAMA时使用。

      MSDK 5.0.0开始支持

      final KeyIsRecording
      static final DJIKeyInfo<Boolean> KeyIsRecording = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"IsRecording", SingleValueConverter.BooleanConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      true表示相机正在录像。

      MSDK 5.0.0开始支持

      final KeyStartRecord
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyStartRecord = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"StartRecord", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      开始录制视频。需要先调用KeyCameraMode把相机工作模式设置为VIDEO_NORMAL。对于红外镜头,用户可以在录制视频时拍摄照片。使用此方法前应检查SD卡状态,以确保有足够的空间。

      MSDK 5.0.0开始支持

      final KeyStopRecord
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyStopRecord = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"StopRecord", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      停止录制视频。

      MSDK 5.0.0开始支持

      final KeyRecordingTime
      static final DJIKeyInfo<Integer> KeyRecordingTime = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"RecordingTime", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      相机当前录制视频的时长,单位:秒。

      MSDK 5.0.0开始支持

      final KeyVideoRecordPlan
      static final DJIKeyInfo<VideoRecordPlanInfo> KeyVideoRecordPlan = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoRecordPlan", new DJIValueConverter<>(VideoRecordPlanInfo.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoRecordPlanInfo
      开启或者关闭相机预录制功能。预录制将会在录制视频前自动录制您设置的秒数并添加到录像中,对设备存储空间有所消耗并影响SD卡写入寿命。请尽量避免在预录制过程中拔卡。可调用KeyVideoPreRecordDuration设置预录制时长。可调用KeyVideoRecordingStatus获取预录制状态。

      注意:
      只有H30系列相机支持此功能。



      MSDK 5.9.0开始支持

      final KeyVideoPreRecordDuration
      static final DJIKeyInfo<VideoPreRecordDurationInfo> KeyVideoPreRecordDuration = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoPreRecordDuration", new DJIValueConverter<>(VideoPreRecordDurationInfo.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoPreRecordDurationInfo
      设置相机预录制时长。

      注意:
      只有H30系列相机支持此功能。



      MSDK 5.9.0开始支持

      final KeyVideoRecordingStatus
      static final DJIKeyInfo<VideoRecordingStatus> KeyVideoRecordingStatus = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoRecordingStatus", new DJIValueConverter<>(VideoRecordingStatus.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("IsRecordingInfo")
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoRecordingStatus
      获取相机预录制状态。当状态为STARTINGSTOPPING时,无法进行相机拍照和录像操作。

      注意:
      只有H30系列相机支持此功能。



      MSDK 5.9.0开始支持

      final KeyRecordCameraStreamSettings
      static final DJIKeyInfo<CameraStreamSettingsInfo> KeyRecordCameraStreamSettings = new KeyRecordCameraStreamSettings()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraStreamSettingsInfo
      多镜头录像存储设置。默认情况下,此相机的所有镜头都会录像,并且视频会存储到SD卡中。 你可以调用此接口选择需要的镜头进行录像和存储。在调用该接口之前,您需要调用KeyCameraMode把相机工作模式设置为VIDEO_NORMAL

      注意:
      对于DJI Mavic 3M只支持以下两种设置:
      1. 只存储RGB视频:[RGB_CAMERA]
      2. 存储RGB和NDVI视频:[RGB_CAMERA, NDVI_CAMERA]



      MSDK 5.0.0开始支持

      final KeyVideoFileFormatRange
      static final DJIKeyInfo<List<VideoFileFormat>> KeyVideoFileFormatRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoFileFormatRange", new SingleValueConverter<>((Class)List.class,VideoStorageFormatRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("VideoStorageFormatRange")
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<VideoFileFormat>
      获取相机的录像格式范围。

      MSDK 5.0.0开始支持

      final KeyVideoFileFormat
      static final DJIKeyInfo<VideoFileFormat> KeyVideoFileFormat = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoFileFormat", new SingleValueConverter<>(VideoFileFormat.class,VideoStorageFormatMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("VideoStorageFormat")
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoFileFormat
      设置和获取相机支持的视频格式。只有当KeyCameraMode为录像模式时才能设置。

      MSDK 5.0.0开始支持

      视频码率
      final KeyVideoBitrateMode
      static final DJIKeyInfo<VideoBitrateMode> KeyVideoBitrateMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoBitrateMode", new SingleValueConverter<>(VideoBitrateMode.class,VideoEncryptStrategyMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("VideoEncryptStrategy")
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoBitrateMode
      设置和获取相机支持的视频码率。只有当KeyCameraMode为录像模式时才能设置。

      注意:
      只有H30系列相机支持此功能。



      MSDK 5.9.0开始支持

      视频编码格式
      final KeyVideoMimeType
      static final DJIKeyInfo<VideoMimeType> KeyVideoMimeType = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoMimeType", new SingleValueConverter<>(VideoMimeType.class,VideoFileCompressionStandardMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("VideoFileCompressionStandard")
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoMimeType
      设置和获取相机支持的视频编码格式。只有当KeyCameraMode为录像模式时才能设置。

      注意:
      只有H30系列相机支持此功能。



      MSDK 5.9.0开始支持

      final KeyNewlyGeneratedMediaFile
      static final DJIKeyInfo<GeneratedMediaFileInfo> KeyNewlyGeneratedMediaFile = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"NewlyGeneratedMediaFile", new DJIValueConverter<>(GeneratedMediaFileInfo.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:GeneratedMediaFileInfo
      当启动拍照或者录像后,相机会产生新的照片或者视频,可以通过这个接口获取产生的媒体文件信息。

      MSDK 5.0.0开始支持

      final KeyCustomExpandDirectoryNameSettings
      static final DJIKeyInfo<CustomExpandNameSettings> KeyCustomExpandDirectoryNameSettings = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CustomExpandDirectoryNameSettings", new DJIValueConverter<>(CustomExpandNameSettings.class)).canGet(true).canSet(true).canListen(false).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CustomExpandNameSettings
      设置和获取自定义文件夹的扩展名称。调用此接口后,新生成的媒体文件(视频或照片)将存储在新文件夹中,默认文件夹名加上你设置的扩展名称将成为新文件夹的名称。例如,默认文件夹名为“DJI_202001012359_01”,你设置的自定义文件夹扩展名称为“Mission1”,因此新文件夹的名称将为“DJI_202001012359_01_Mission1”。在一次飞行中,您可以设置多个扩展目录名称以创建多个自定义文件夹。

      注意:
      1. 请勿在录像过程中设置自定义文件夹的扩展名称。
      2. 请勿使用纯数字和特殊字符作为扩展名称,否则多媒体文件将会下载失败。建议使用数字+字母组合字符串作为扩展名称。
      3. 多媒体文件名称[原始文件名+扩展名称]的长度小于128字节。


      MSDK 5.0.0开始支持

      final KeyCustomExpandFileNameSettings
      static final DJIKeyInfo<CustomExpandNameSettings> KeyCustomExpandFileNameSettings = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CustomExpandFileNameSettings", new DJIValueConverter<>(CustomExpandNameSettings.class)).canGet(true).canSet(true).canListen(false).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CustomExpandNameSettings
      设置和获取自定义文件的扩展名称。调用此接口后,默认的文件名加上你设置的扩展名称将成为下一个媒体文件(视频或照片)的名称。例如,默认照片名称为“DJI_2020012091415_999_WIDE.JPG”,您设置的自定义文件的扩展名称为“Waypoint1”,因此新照片的名称将为“DJI_2020012091415_999_WIDE_Waypoint1.JPG”,此操作仅生效一次。如果希望在一次飞行中所有媒体文件的扩展名称相同,则需要在拍摄每张照片之前设置相同的扩展名称。

      注意:

      1. 请勿在录像过程中设置自定义文件的扩展名称。
      2. 请勿使用纯数字和特殊字符作为扩展名称,否则多媒体文件将会下载失败。 建议使用数字+字母组合字符串作为扩展名称。
      3. 多媒体文件名称[原始文件名+扩展名称]的长度小于128字节。



      MSDK 5.0.0开始支持

      final KeyCameraStorageInfos
      static final DJIKeyInfo<CameraStorageInfos> KeyCameraStorageInfos = new KeyCameraStorageInfo()
      .canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraStorageInfos
      获取相机SD卡和机载存储器的存储信息。M30和M30T相机机载存储器仅供内部使用。

      MSDK 5.0.0开始支持

      final KeyCameraVideoCaptionEnabled
      static final DJIKeyInfo<Boolean> KeyCameraVideoCaptionEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraVideoCaptionEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Boolean
      true表示开启视频字幕。飞行器的位置、飞行时间和相机参数将保存在SD卡上的视频字幕srt文件中。

      注意: 需要调用KeyCameraMode把相机模式设置为VIDEO_NORMAL才能使用此接口。

      MSDK 5.0.0开始支持

      final KeyCameraWatermarkSettings
      static final DJIKeyInfo<CameraWatermarkSettings> KeyCameraWatermarkSettings = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraWatermarkSettings", new DJIValueConverter<>(CameraWatermarkSettings.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraWatermarkSettings
      相机水印设置。可以设置照片和视频中是否生成水印。你可以通过KeyWatermarkDisplayContentSettings设置需要水印中显示的内容。通过KeyWatermarkUserCustomInfo设置自定义水印文案。

      MSDK 5.0.0开始支持

      final KeyWatermarkDisplayContentSettings
      static final DJIKeyInfo<WatermarkDisplayContentSettings> KeyWatermarkDisplayContentSettings = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"WatermarkDisplayContentSettings", new DJIValueConverter<>(WatermarkDisplayContentSettings.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:WatermarkDisplayContentSettings
      相机水印内容设置。可以设置照片和视频中需要显示的水印内容。你可以通过KeyWatermarkUserCustomInfo设置自定义水印文案。

      MSDK 5.0.0开始支持

      final KeyWatermarkUserCustomInfo
      static final DJIKeyInfo<String> KeyWatermarkUserCustomInfo = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"WatermarkUserCustomInfo", SingleValueConverter.StringConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:String
      设置和获取水印中自定义文案。你可以通过KeyWatermarkDisplayContentSettings设置是否显示自定义文案。

      MSDK 5.0.0开始支持

      final KeyLockGimbalDuringShootPhotoEnabled
      static final DJIKeyInfo<Boolean> KeyLockGimbalDuringShootPhotoEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LockGimbalDuringShootPhotoEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      true表示相机拍照时会锁定云台。此功能开启后可避免飞行器运动对成像效果造成影响。

      MSDK 5.0.0开始支持

      final KeyAutoTurnOffLEDMode
      static final DJIKeyInfo<AutoTurnOffLEDMode> KeyAutoTurnOffLEDMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"AutoTurnOffLEDMode", new SingleValueConverter<>(AutoTurnOffLEDMode.class,AutoTurnOffLEDModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: AutoTurnOffLEDMode

      设置相机设置时自动关闭LED灯。包括前后机臂灯和夜航灯。

      MSDK 5.0.0开始支持

      激光模式
      final KeyLaserWorkMode
      static final DJIKeyInfo<LaserWorkMode> KeyLaserWorkMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LaserWorkMode", new SingleValueConverter<>(LaserWorkMode.class,LaserWorkModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: LaserWorkMode

      设置激光工作模式。可选择增强模式或按需开启激光。重启相机后激光模块将恢复为增强模式。

      MSDK 5.0.0开始支持

      final KeyLaserMeasureEnabled
      static final DJIKeyInfo<Boolean> KeyLaserMeasureEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LaserMeasureEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("LaserMeasureEnable")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      开启或者关闭激光模块。当把KeyLaserWorkMode设置为 OPEN_ON_DEMAND时,可通过此接口按需要开启激光模块。

      MSDK 5.0.0开始支持

      final KeyLaserMeasureInformation
      static final DJIKeyInfo<LaserMeasureInformation> KeyLaserMeasureInformation = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LaserMeasureInformation", new DJIValueConverter<>(LaserMeasureInformation.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: LaserMeasureInformation

      获取激光传感器信息,包括目标点的位置信息,目标点距离激光传感器的距离,目标点在相机屏幕上位置和激光传感器状态。激光传感器必须距离目标点至少3m。

      MSDK 5.1.0开始支持

      指点对焦
      final KeyTapZoomAtTarget
      static final DJIActionKeyInfo<ZoomTargetPointInfo,EmptyMsg> KeyTapZoomAtTarget = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"TapZoomAtTarget", new DJIValueConverter<>(ZoomTargetPointInfo.class),EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: ZoomTargetPointInfo

      指点对准功能,双击画面上的目标点,云台会自动转动使该目标点置于画面中心。只需要传入画面目标坐标即可,其他参数是预留字段可忽略。

      MSDK 5.9.0开始支持

      final KeyInfinityCalibrationState
      static final DJIKeyInfo<InfinityCalibrationState> KeyInfinityCalibrationState = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"InfinityCalibrationState", new SingleValueConverter<>(InfinityCalibrationState.class,MFDemarcateStateMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("MFDemarcateState")
      包:dji.sdk.keyvalue.key
      描述:

      参数: InfinityCalibrationState

      获取无穷远标定的状态。如果状态为NOT_CALIBRATE,请调用KeyStartInfinityCalibration进行无穷远标定。

      注意:
      只有Zenmuse P1支持无穷远标定。


      MSDK 5.9.0开始支持

      final KeyStartInfinityCalibration
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyStartInfinityCalibration = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"StartInfinityCalibration", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false).setInnerIdentifier("StartMFDemarcate")
      包:dji.sdk.keyvalue.key
      描述:

      开始相机无穷远标定。如果遇到以下情况,请调用此接口进行无穷远标定。

    • Zemmuse P1支持更换多种定焦镜头,因此更换镜头后,建议您重新进行标定。
    • 请监听KeyInfinityCalibrationState,如果状态为NOT_CALIBRATE,请重新进行标定。
    • 请通过addDJIDeviceHealthInfoChangeListener监听设备健康信息,如果监听到以下错误码,请重新进行标定。

    •       1. hms_0x1C000D02:相机标定文件加载失败,请进行无穷远标定。
            2. hms_0x1C000D03:无穷远标定数据已过期,重新进行无穷远标定。
            3. hms_0x1C000D04:无穷远标定数据已过期,重新进行无穷远标定。


      以下是无穷远标定步骤:

    • 起飞并上升至102米(335英尺)或更高以开始标定。
    • 调用KeyStartInfinityCalibration开始标定,标定状态将更改为WAITING_FOR_CALIBRATE
    • 设置云台角度为-90度(垂直于地面)。 调用KeyCameraFocusTarget将相机画面中心区域中的纹理丰富的物体设置为对焦目标,然后标定状态将更改为CALIBRATING
    • 标定完成后,标定状态将变为CALIBRATED。您可以使用KeyInfinityCalibrationResult来监听标定结果。


    • 注意:
      只有Zenmuse P1支持无穷远标定。


      MSDK 5.9.0开始支持

      final KeyStopInfinityCalibration
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyStopInfinityCalibration = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"StopInfinityCalibration", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false).setInnerIdentifier("StopMFDemarcate")
      包:dji.sdk.keyvalue.key
      描述:

      停止相机无穷远标定。

      注意:
      只有Zenmuse P1支持无穷远标定。


      MSDK 5.9.0开始支持

      final KeyInfinityCalibrationResult
      static final DJIKeyInfo<InfinityCalibrationResult> KeyInfinityCalibrationResult = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"InfinityCalibrationResult", new SingleValueConverter<>(InfinityCalibrationResult.class,MFDemarcateResultMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("MFDemarcateResult")
      包:dji.sdk.keyvalue.key
      描述:

      参数: InfinityCalibrationResult

      获取无穷远标定的结果。

      注意:
      只有Zenmuse P1支持无穷远标定。


      MSDK 5.9.0开始支持

      final KeyLensCalibratedInfinityValue
      static final DJIKeyInfo<Integer> KeyLensCalibratedInfinityValue = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LensCalibratedInfinityValue", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      标定对焦值对焦,需要确保已经调用KeyStartInfinityCalibration对镜头无穷远标定,作业时镜头将按照无穷远标定值对焦。当航线飞行作业环境与无穷远标定是环境温差较大(大于15°)时,建议重新标定无穷远,以保证对焦准确性。

      注意:
      只有Zenmuse P1支持无穷远标定。


      MSDK 5.9.0开始支持

      抗闪烁
      final KeyAntiFlicker
      static final DJIKeyInfo<CameraAntiFlicker> KeyAntiFlicker = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"AntiFlicker", new SingleValueConverter<>(CameraAntiFlicker.class,CameraAntiFlickerMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: CameraAntiFlicker

      设置抗闪烁,通常用于消费类机型。

      MSDK 5.3.0开始支持

      final KeyCameraWhiteBalanceRange
      static final DJIKeyInfo<List<CameraWhiteBalanceMode>> KeyCameraWhiteBalanceRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraWhiteBalanceRange", new SingleValueConverter<>((Class)List.class,WhiteBalanceRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: list<CameraWhiteBalanceMode>
      获取相机的白平衡范围。

      Supported since MSDK 5.3.0

      final KeyWhiteBalance
      static final DJIKeyInfo<CameraWhiteBalanceInfo> KeyWhiteBalance = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"WhiteBalance", new DJIValueConverter<>(CameraWhiteBalanceInfo.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: CameraWhiteBalanceInfo

      设置白平衡。可KeyCameraWhiteBalanceRange获得可设置的白平衡。

      Supported since MSDK 5.3.0

      final KeyCameraNightSceneMode
      static final DJIKeyInfo<CameraNightSceneMode> KeyCameraNightSceneMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraNightSceneMode", new SingleValueConverter<>(CameraNightSceneMode.class,CameraNightSceneModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: CameraNightSceneMode

      夜景模式设置。开启夜景模式可以提升相机在低密度环境下的拍摄效果。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA或者WIDE_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOMCAMERA_LENS_WIDE。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT
      3. 夜景模式下拍照录像仅支持1080P。


      MSDK 5.9.0开始支持

      final KeyCameraDenoiseLevel
      static final DJIKeyInfo<CameraDenoiseLevel> KeyCameraDenoiseLevel = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraDenoiseLevel", new SingleValueConverter<>(CameraDenoiseLevel.class,CameraDenoiseLevelMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: CameraDenoiseLevel

      增强降噪等级设置,增强降噪等级越高帧率越低。以H30系列相机为例:默认状态下图传和视频帧率为25fps,当增强降噪等级为低时帧率是25fps,当增强降噪等级为中时帧率是15fps,当增强降噪等级为高时帧率是5fps。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA或者WIDE_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOMCAMERA_LENS_WIDE。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT
      3. 请调用KeyCameraNightSceneMode将夜景模式设置为 ENABLE
      4. 只有H20N和H30系列相机才支持增强降噪等级功能。


      MSDK 5.9.0开始支持

      final KeyLaserFillLightEnabled
      static final DJIKeyInfo<Boolean> KeyLaserFillLightEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LaserFillLightEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("EnableLaserFillLight")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      红外补光功能。红外补光开启时红外增强KeyIRCutEnabled会同时开启。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA或者WIDE_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOMCAMERA_LENS_WIDE。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT
      3. 请调用KeyCameraNightSceneMode将夜景模式设置为 ENABLE
      4. 只有H20N和H30系列相机才支持红外补光功能。


      MSDK 5.9.0开始支持

      红外增强
      final KeyIRCutEnabled
      static final DJIKeyInfo<Boolean> KeyIRCutEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"IRCutEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("IRCutEnable")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      true表示开启红外增强功能。红外增强开启后,变焦镜头的图传会变成黑白。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA或者WIDE_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOMCAMERA_LENS_WIDE。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT
      3. 请调用KeyCameraNightSceneMode将夜景模式设置为 ENABLE


      MSDK 5.0.0开始支持

      电子去雾
      final KeyDehazeMode
      static final DJIKeyInfo<DehazeMode> KeyDehazeMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"DehazeMode", new SingleValueConverter<>(DehazeMode.class,DehazeModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      Parameter:DehazeMode

      设置电子去雾模式,开启电子去雾功能可以在雾霾天气时提高画面通透性。只有H30系列相机才支持此功能。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOM。 如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT
      3. 夜景模式KeyCameraNightSceneMode关闭状态才能使用此功能。


      MSDK 5.9.0开始支持

      final KeyDehazeLevel
      static final DJIKeyInfo<DehazeLevel> KeyDehazeLevel = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"DehazeLevel", new SingleValueConverter<>(DehazeLevel.class,DehazeLevelMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      Parameter:DehazeLevel

      设置电子去雾等级。只有当KeyDehazeMode设置为ENABLE时才能设置电子去雾等级。只有H30系列相机才支持此功能。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOM。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.9.0开始支持

      镜头去雾
      final KeyCleanFog
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyCleanFog = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"CleanFog", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      进行一次镜头去雾操作,镜头去雾需要持续加热5秒。

      MSDK 5.0.0开始支持


      镜头设置

      final KeyCameraVideoStreamSourceRange
      static final DJIKeyInfo<List<CameraVideoStreamSourceType>> KeyCameraVideoStreamSourceRange = new KeyCameraVideoStreamSourceRange()
      .canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<CameraVideoStreamSourceType>
      获取相机视频源范围。

      MSDK 5.0.0开始支持

      final KeyCameraVideoStreamSource
      static final DJIKeyInfo<CameraVideoStreamSourceType> KeyCameraVideoStreamSource = new KeyCameraVideoStreamSource()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraVideoStreamSourceType
      设置相机视频源。对于多镜头相机,视频有不同的镜头来源。设置相机视频源后,当前的实时视频流会切换为设置的镜头视频流。可通过KeyCameraVideoStreamSourceRange获取当前相机支持的镜头类型列表。对于单镜头相机,默认使用DEFAULT_CAMERA类型。

      注意: 当CameraModePHOTO_SUPER_RESOLUTION的时候,无法把视频源设置为INFRARED_CAMERA

      MSDK 5.0.0开始支持

      final KeyExposureModeRange
      static final DJIKeyInfo<List<CameraExposureMode>> KeyExposureModeRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ExposureModeRange", new SingleValueConverter<>((Class)List.class,CameraExposureModeRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<CameraExposureMode>
      获取所选镜头的曝光模式范围。

      MSDK 5.0.0开始支持

      final KeyExposureMode
      static final DJIKeyInfo<CameraExposureMode> KeyExposureMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ExposureMode", new SingleValueConverter<>(CameraExposureMode.class,CameraExposureModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraExposureMode
      设置所选镜头的曝光模式。曝光模式决定了光圈、快门速度、ISO是否可被自动或手动设置。可通过KeyExposureModeRange获取可设置的曝光模式。 CameraVideoStreamSourceTypeINFRARED_CAMERA时,不能设置曝光模式。

      注意: 1. 只能选择当前视频源的镜头进行曝光设置,否则将设置不成功。
      2. 可通过KeyCameraVideoStreamSource获取当前视频源的镜头。 然后在使用KeyTools创建DJIKey实例的时候设置CameraLensType为当前视频源的镜头。
      3. 在超清矩阵拍照模式下,曝光模式不可设置。


      MSDK 5.0.0开始支持

      final KeyExposureCompensationRange
      static final DJIKeyInfo<List<CameraExposureCompensation>> KeyExposureCompensationRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ExposureCompensationRange", new SingleValueConverter<>((Class)List.class,CameraExposureCompensationRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<CameraExposureCompensation>
      获取相机镜头的曝光补偿值范围。

      MSDK 5.0.0开始支持

      final KeyExposureCompensation
      static final DJIKeyInfo<CameraExposureCompensation> KeyExposureCompensation = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ExposureCompensation", new SingleValueConverter<>(CameraExposureCompensation.class,CameraExposureCompensationMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraExposureCompensation
      设置相机镜头的曝光补偿值。可通过KeyExposureCompensationRange获取可设置的曝光补偿值。必须把当前视频源的CameraExposureMode设置为PROGRAM才能设置相机镜头的曝光补偿值。

      注意: 只能选择当前视频源的镜头进行曝光补偿设置,否则将设置不成功。可通过KeyCameraVideoStreamSource获取当前视频源的镜头。 然后在使用KeyTools创建DJIKey实例的时候设置CameraLensType为当前视频源的镜头。

      MSDK 5.0.0开始支持

      自动曝光
      final KeyAELockEnabled
      static final DJIKeyInfo<Boolean> KeyAELockEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"AELockEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Boolean
      相机镜头的自动曝光锁定。必须把当前视频源的CameraExposureMode设置为PROGRAM才能设置相机镜头的自动曝光锁定。

      MSDK 5.0.0开始支持

      final KeyCameraMeteringMode
      static final DJIKeyInfo<CameraMeteringMode> KeyCameraMeteringMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraMeteringMode", new SingleValueConverter<>(CameraMeteringMode.class,CameraMeteringModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraMeteringMode
      设置相机镜头的测光模式。如果你想使用中心测光或者平均测光功能,你只需要设置一次CENTER或者AVERAGE,镜头会进行一次测光。如果你想使用点测光或者区域测光功能,则需要调用KeySpotMeteringPoint或者KeyRegionMeteringArea设置测光参数后,镜头会进行一次点测光或者区域测光。

      注意:如果你想使用测光功能,请使用KeyExposureMode把曝光模式设置为PROGRAMSHUTTER_PRIORITY或者APERTURE_PRIORITY,并且调用KeyAELockEnabled把自动曝光锁定设置为false

      MSDK 5.2.0开始支持

      final KeySpotMeteringPoint
      static final DJIKeyInfo<DoublePoint2D> KeySpotMeteringPoint = new KeySpotMeteringPoint()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      Parameter:DoublePoint2D
      相机镜头点测光。DoublePoint2D中的(x,y)为归一化为(0-1)的中心点坐标。

      MSDK 5.2.0开始支持

      final KeyRegionMeteringArea
      static final DJIKeyInfo<DoubleRect> KeyRegionMeteringArea = new KeyRegionMeteringArea()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:DoubleRect
      相机镜头区域测光。DoubleRect中的(x,y)为归一化为(0-1)的左上角坐标位置,width和height是归一化为(0-1)的区域宽和高。width和height不可为0。

      MSDK 5.2.0开始支持

      final KeyISORange
      static final DJIKeyInfo<List<CameraISO>> KeyISORange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ISORange", new SingleValueConverter<>((Class)List.class,CameraISORangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<CameraISO>
      获取相机镜头的ISO范围。

      注意: 如果你想使用ISO功能,请调用KeyExposureMode把曝光模式设置为MANUAL

      MSDK 5.0.0开始支持

      final KeyISO
      static final DJIKeyInfo<CameraISO> KeyISO = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ISO", new SingleValueConverter<>(CameraISO.class,CameraISOMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraISO
      设置和获取相机镜头的ISO数值。可通过KeyISORange获取ISO范围。

      注意:
      1.只能选择当前视频源的镜头进行ISO设置,否则将设置不成功。可通过KeyCameraVideoStreamSource获取当前视频源的镜头。 然后在使用KeyTools创建DJIKey实例的时候设置CameraLensType为当前视频源的镜头。
      2. 调用KeyExposureMode把曝光模式设置为MANUAL


      MSDK 5.0.0开始支持

      final KeyShutterSpeedRange
      static final DJIKeyInfo<List<CameraShutterSpeed>> KeyShutterSpeedRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ShutterSpeedRange", new SingleValueConverter<>((Class)List.class,CameraShutterSpeedRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<CameraShutterSpeed>
      获取相机镜头的快门速度范围。

      注意: 如果你想使用快门功能,请调用KeyExposureMode把曝光模式设置为MANUAL

      MSDK 5.0.0开始支持

      final KeyShutterSpeed
      static final DJIKeyInfo<CameraShutterSpeed> KeyShutterSpeed = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ShutterSpeed", new SingleValueConverter<>(CameraShutterSpeed.class,CameraShutterSpeedMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraShutterSpeed
      设置相机镜头的快门速度数值。可通过KeyShutterSpeedRange获取可设置的快门速度。

      注意:
      1. 只能选择当前视频源的镜头进行快门设置,否则将设置不成功。可通过KeyCameraVideoStreamSource获取当前视频源的镜头。 然后在使用KeyTools创建DJIKey实例的时候设置CameraLensType为当前视频源的镜头。
      2. 调用KeyExposureMode把曝光模式设置为MANUAL


      MSDK 5.0.0开始支持

      照片比例
      final KeyPhotoRatioRange
      static final DJIKeyInfo<List<PhotoRatio>> KeyPhotoRatioRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"PhotoRatioRange", new SingleValueConverter<>((Class)List.class,PhotoRatioRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<PhotoRatio>
      获取相机镜头照片比例范围。

      注意:
      1. 只能选择当前视频源的镜头进行照片比例设置,否则将设置不成功。可通过KeyCameraVideoStreamSource获取当前视频源的镜头。 然后在使用KeyTools创建DJIKey实例的时候设置CameraLensType为当前视频源的镜头。
      2. 只有当KeyCameraMode为拍照模式时才能设置。


      MSDK 5.0.0开始支持

      final KeyPhotoRatio
      static final DJIKeyInfo<PhotoRatio> KeyPhotoRatio = new KeyPhotoRatio()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:PhotoRatio
      设置相机镜头的照片比例。可通过KeyPhotoRatioRange获取可设置的照片比例。

      注意:
      1. 只能选择当前视频源的镜头进行照片比例设置,否则将设置不成功。可通过KeyCameraVideoStreamSource获取当前视频源的镜头。 然后在使用KeyTools创建DJIKey实例的时候设置CameraLensType为当前视频源的镜头。
      2. 只有当KeyCameraMode为拍照模式时才能设置。


      MSDK 5.0.0开始支持

      视频分辨率和帧率
      final KeyVideoResolutionFrameRateRange
      static final DJIKeyInfo<List<VideoResolutionFrameRate>> KeyVideoResolutionFrameRateRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoResolutionFrameRateRange", new SingleValueConverter<>((Class)List.class,VideoResolutionFrameRateRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<VideoResolutionFrameRate>
      获取相机镜头视频分辨率和帧率范围。

      MSDK 5.0.0开始支持

      final KeyVideoResolutionFrameRate
      static final DJIKeyInfo<VideoResolutionFrameRate> KeyVideoResolutionFrameRate = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"VideoResolutionFrameRate", new DJIValueConverter<>(VideoResolutionFrameRate.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:VideoResolutionFrameRate
      设置相机镜头的视频分辨率和帧率。可通过KeyVideoResolutionFrameRateRange获取可设置的视频分辨率和帧率。

      注意: 需要调用KeyCameraMode把相机模式设置为VIDEO_NORMAL才能使用此接口。

      MSDK 5.0.0开始支持

      final KeyCameraZoomRatiosRange
      static final DJIKeyInfo<ZoomRatiosRange> KeyCameraZoomRatiosRange = new KeyCameraZoomRatiosRange()
      .canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:list<ZoomRatiosRange>
      获取相机镜头变焦倍率范围。

      MSDK 5.3.0开始支持

      final KeyCameraZoomRatios
      static final DJIKeyInfo<Double> KeyCameraZoomRatios = new KeyCameraZoomRatios()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Double
      设置相机镜头变焦倍率。建议设置的最小精度为0.1。不同的镜头的相机倍率范围不一样,请调用KeyCameraZoomRatiosRange获取该镜头支持的变焦倍率。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.0.0开始支持

      final KeyCameraZoomFocalLength
      static final DJIKeyInfo<Integer> KeyCameraZoomFocalLength = new KeyCameraZoomFocalLength()
      .canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Interger
      获取变焦镜头的焦距,单位:mm。请使用KeyCameraZoomRatios设置变焦倍率。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.0.0开始支持

      final KeyCameraFocusMode
      static final DJIKeyInfo<CameraFocusMode> KeyCameraFocusMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraFocusMode", new SingleValueConverter<>(CameraFocusMode.class,CameraFocusModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraFocusMode
      设置和获取变焦镜头的对焦模式。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候, 把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT
      3. Zenmuse P1,Mini 3和Mini 3 Pro只支持设置:MANUALAF


      MSDK 5.0.0开始支持

      final KeyCameraFocusRingMinValue
      static final DJIKeyInfo<Integer> KeyCameraFocusRingMinValue = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraFocusRingMinValue", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Integer
      相机手动对焦时所能设置的最小数值。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.0.0开始支持

      final KeyCameraFocusRingMaxValue
      static final DJIKeyInfo<Integer> KeyCameraFocusRingMaxValue = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraFocusRingMaxValue", SingleValueConverter.IntegerConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Integer
      相机手动对焦时所能设置的最大数值。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.0.0开始支持

      final KeyCameraFocusRingValue
      static final DJIKeyInfo<Integer> KeyCameraFocusRingValue = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraFocusRingValue", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:Integer
      相机的手动对焦值。通过模拟调整对焦环来设置焦距。通过KeyCameraFocusRingMinValueKeyCameraFocusRingMaxValue获取手动对焦数值的最小和最大值。在MANUAL模式下,设置对焦值后,相机将会以屏幕中心点为对焦目标进行一次对焦。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.0.0开始支持

      final KeyCameraFocusTarget
      static final DJIKeyInfo<DoublePoint2D> KeyCameraFocusTarget = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"CameraFocusTarget", new DJIValueConverter<>(DoublePoint2D.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:DoublePoint2D
      相机自动对焦的对焦目标。[0,0]代表相机屏幕的左上角,[1,1]代表相机屏幕的右下角。在AF模式下,设置对焦目标后,相机将自动以对焦目标为中心点进行一次对焦。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为ZOOM_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_ZOOM。如果是M3M机型,则设置为CAMERA_LENS_RGB。如果是DJI单镜头相机或者PSDK单镜头相机,则设置为CAMERA_LENS_DEFAULT


      MSDK 5.0.0开始支持


      红外功能

      final KeyThermalTemperatureMeasureMode
      static final DJIKeyInfo<ThermalTemperatureMeasureMode> KeyThermalTemperatureMeasureMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalTemperatureMeasureMode", new SingleValueConverter<>(ThermalTemperatureMeasureMode.class,CameraThermalMeasurementModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalMeasurementMode")
      包:dji.sdk.keyvalue.key
      描述:

      参数:ThermalTemperatureMeasureMode
      设置和获取测温模式。支持点测温和区域测温两种模式。

      MSDK 5.0.0开始支持

      final KeyThermalSpotMetersurePoint
      static final DJIKeyInfo<DoublePoint2D> KeyThermalSpotMetersurePoint = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalSpotMetersurePoint", new DJIValueConverter<>(DoublePoint2D.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("ThermalSpotMeteringTargetPoint")
      包:dji.sdk.keyvalue.key
      描述:

      参数: DoublePoint2D

      设置需要测温的点的位置。[0,0]代表相机屏幕的左上角,[1,1]代表相机屏幕的右下角。设置了测温点的位置以后,可以通过KeyThermalSpotMetersureTemperature获取当前测温点的温度。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL
      3. 调用KeyThermalTemperatureMeasureModeThermalTemperatureMeasureMode设置为SPOT


      MSDK 5.0.0开始支持

      final KeyThermalSpotMetersureTemperature
      static final DJIKeyInfo<Double> KeyThermalSpotMetersureTemperature = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalSpotMetersureTemperature", SingleValueConverter.DoubleConverter).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("ThermalTemperatureData")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Double

      获取当前测温点的温度。调用KeyThermalSpotMetersurePoint可以设置当前测温点的位置。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL
      3. 调用KeyThermalTemperatureMeasureModeThermalTemperatureMeasureMode设置为SPOT


      MSDK 5.0.0开始支持

      final KeyThermalRegionMetersureArea
      static final DJIKeyInfo<DoubleRect> KeyThermalRegionMetersureArea = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalRegionMetersureArea", new DJIValueConverter<>(DoubleRect.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("ThermalSpotMeteringArea")
      包:dji.sdk.keyvalue.key
      描述:

      参数: DoubleRect

      设置需要测温的区域位置。[0,0]代表相机屏幕的左上角,[1,1]代表相机屏幕的右下角。设置了测温点的位置以后,可以通过KeyThermalRegionMetersureTemperature获取当前测温区域的温度信息。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL
      3. 调用KeyThermalTemperatureMeasureModeThermalTemperatureMeasureMode设置为REGION


      MSDK 5.0.0开始支持

      final KeyThermalRegionMetersureTemperature
      static final DJIKeyInfo<ThermalAreaMetersureTemperature> KeyThermalRegionMetersureTemperature = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalRegionMetersureTemperature", new DJIValueConverter<>(ThermalAreaMetersureTemperature.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("ThermalAreaTemperatureAggregations")
      包:dji.sdk.keyvalue.key
      描述:

      参数: ThermalAreaMetersureTemperature

      获取当前测温区域的温度信息。包括测温区域的平均温度、最小温度和最大温度。调用KeyThermalRegionMetersureArea可以设置需要的测温的区域位置。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL
      3. 调用KeyThermalTemperatureMeasureModeThermalTemperatureMeasureMode设置为REGION


      MSDK 5.0.0开始支持

      增益模式
      final KeyThermalGainMode
      static final DJIKeyInfo<ThermalGainMode> KeyThermalGainMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalGainMode", new SingleValueConverter<>(ThermalGainMode.class,CameraThermalGainModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalGainMode")
      包:dji.sdk.keyvalue.key
      描述:

      参数: ThermalGainMode

      设置和获取增益模式。设置操作比较耗时,需要等待3到5秒后才能生效。 可通过KeyThermalGainModeTemperatureRange获取不同增益模式下的温度适用范围。 当选择高增益时,相机对温度差异更灵敏,但相机测量的温度范围较小。低增益模式时,相机测量的温度范围较大,对温度差异灵敏度会降低。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalGainModeTemperatureRange
      static final DJIKeyInfo<ThermalGainModeTemperatureRange> KeyThermalGainModeTemperatureRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalGainModeTemperatureRange", new DJIValueConverter<>(ThermalGainModeTemperatureRange.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: ThermalGainModeTemperatureRange

      获取不同增益模式的温度范围。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalPaletteRange
      static final DJIKeyInfo<List<CameraThermalPalette>> KeyThermalPaletteRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalPaletteRange", new SingleValueConverter<>((Class)List.class,CameraThermalPaletteRangeMsg.class)).canGet(true).canSet(false).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalPaletteRange")
      包:dji.sdk.keyvalue.key
      描述:


      参数:list<CameraThermalPalette>
      获取红外镜头可设置的调色盘类型。
      注意:

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalPalette
      static final DJIKeyInfo<CameraThermalPalette> KeyThermalPalette = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalPalette", new SingleValueConverter<>(CameraThermalPalette.class,CameraThermalPaletteMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalPalette")
      包:dji.sdk.keyvalue.key
      描述:


      参数: CameraThermalPalette

      设置调色盘类型。可通过KeyThermalPaletteRange获取可设置的调色盘类型。热成像图片中的颜色用来表示温度,画面中的温度范围将被映射到256个色阶上,在8bit的JPEG图片以及MP4视频中显示出来,每种调色盘对应不同的色阶。
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalIsothermEnabled
      static final DJIKeyInfo<Boolean> KeyThermalIsothermEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalIsothermEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalIsothermEnabled")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      启用或禁用等温线。开启等温线功能可以更直观地看出指定温度区间的物体。通过高温、低温两个阈值来设置温度区间。等温线禁用时,所有256个值(8位)都用于场景的温度直方图。启用等温线后,只有128个值(0-127)与温度线性映射。然后将三个颜色区间(128-175)、(176-223)和(224-255)映射到用户定义的温度,以向用户突出显示它们。使用一些调色板(例如RAINBOW)会生成灰度级的热图像,红色、蓝色或绿色将用于突出显示的三个特定的温度。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalIsothermUnit
      static final DJIKeyInfo<ThermalIsothermUnit> KeyThermalIsothermUnit = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalIsothermUnit", new SingleValueConverter<>(ThermalIsothermUnit.class,CameraThermalIsothermUnitMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalIsothermUnit")
      包:dji.sdk.keyvalue.key
      描述:

      参数: ThermalIsothermUnit

      等温线的单位。将等温线范围的单位设置为摄氏度或者百分比。不同的单位导致等温线的值范围不同。 如果是单位是百分比,可设置的值范围是[0,100]。如果单位是摄氏度,可设置的最高值和最低值请参考KeyThermalGainModeTemperatureRange

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为 INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL
      3. H20系列相机不支持设置等温线单位。

      MSDK 5.0.0开始支持

      final KeyThermalIsothermUpperValue
      static final DJIKeyInfo<Integer> KeyThermalIsothermUpperValue = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalIsothermUpperValue", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalIsothermUpperValue")
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      等温线最高值。高于此值的所有温度值将使用调色板中的颜色224-255。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalIsothermLowerValue
      static final DJIKeyInfo<Integer> KeyThermalIsothermLowerValue = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalIsothermLowerValue", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalIsothermLowerValue")
      包:dji.sdk.keyvalue.key
      描述:


      参数: Integer

      等温线最低值。较低和中等等温线阈值之间的温度值将以调色板中的128-175色显示。
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalDisplayMode
      static final DJIKeyInfo<ThermalDisplayMode> KeyThermalDisplayMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalDisplayMode", new SingleValueConverter<>(ThermalDisplayMode.class,CameraDisplayModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraDisplayMode")
      包:dji.sdk.keyvalue.key
      描述:


      参数: ThermalDisplayMode

      设置红外镜头的显示模式。包括红外显示和分屏显示。
      如果需要设置把红外镜头设置成分屏显示模式,请先调用此接口把显示模式设置为PIP,然后调用KeyThermalPIPPosition把显示位置设置为SIDE_BY_SIDE
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalPIPPosition
      static final DJIKeyInfo<ThermalPIPPosition> KeyThermalPIPPosition = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalPIPPosition", new SingleValueConverter<>(ThermalPIPPosition.class,PIPPositionMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:


      参数: ThermalPIPPosition

      设置红外镜头分屏显示位置。请先调用KeyThermalDisplayMode把显示模式设置成分屏显示PIP。然后调用此接口把显示位置设置为SIDE_BY_SIDE
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalFFCMode
      static final DJIKeyInfo<ThermalFFCMode> KeyThermalFFCMode = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalFFCMode", new SingleValueConverter<>(ThermalFFCMode.class,CameraThermalFFCModeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalFFCMode")
      包:dji.sdk.keyvalue.key
      描述:


      参数: ThermalFFCMode

      设置FFC校准模式。FFC校准是红外镜头的一个功能,校准以后的图像质量将得到优化。
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalTriggerFFC
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyThermalTriggerFFC = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalTriggerFFC", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      手动触发一次FFC校准模式。校准过程中相机画面可能会有1秒的停顿,同时相机会有“咔嚓”一声。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalZoomRatios
      static final DJIKeyInfo<Double> KeyThermalZoomRatios = new KeyThermalZoomRatios()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:


      参数: Double

      设置红外变焦倍率。支持1x、2x、4x、8x等变焦倍率。
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      联动变焦
      final KeyLinkZoomEnabled
      static final DJIKeyInfo<Boolean> KeyLinkZoomEnabled = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"LinkZoomEnabled", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("EnableZoomLinkage")
      包:dji.sdk.keyvalue.key
      描述:


      参数: Boolean

      开启或者关闭联动变焦功能。开启联动变焦功能后,调用KeyThermalZoomRatios 可实现红外镜头和变焦镜头同步变焦。用户在分屏模式PIP下,可以更高效得比对红外镜头和变焦镜头的画面。
      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.3.0开始支持

      final KeyThermalSuperResolution
      static final DJIKeyInfo<Boolean> KeyThermalSuperResolution = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalSuperResolution", SingleValueConverter.BooleanConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Boolean

      设置开启和关闭红外超分辨率。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      兴趣区域
      final KeyThermalROI
      static final DJIKeyInfo<ThermalROI> KeyThermalROI = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalROI", new SingleValueConverter<>(ThermalROI.class,CameraThermalROIMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false).setInnerIdentifier("CameraThermalROI")
      包:dji.sdk.keyvalue.key
      描述:

      参数: ThermalROI

      设置热成像兴趣区域。用户可根据需要选择兴趣区域范围。当兴趣区域为全屏时,整个图像的色阶将按默认配置分布。当画面中有大片天空时,由于天空的温度较低,大量色阶被分配到低温区域,将导致地 面部分不同温度显示的色彩变化不明显。选择剔除天空区域(33%)或剔除天空区域(50%),意味着将分配在天空区域的色阶数量减少,而将更多色阶分配在地面区域,使地面区域内的色彩变化较明显、图像更清晰,从而更利于观测。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalScene
      static final DJIKeyInfo<ThermalScene> KeyThermalScene = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalScene", new SingleValueConverter<>(ThermalScene.class,ThermalSceneMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: ThermalScene

      设置热成像场景。支持默认以及巡检场景,同时支持自定义场景,用户可以根据需求设置并保存自定义参数。相机将根据不同的场景调整相机参数,对图像进行优化处理。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalDDE
      static final DJIKeyInfo<Integer> KeyThermalDDE = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalDDE", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      设置热成像DDE(Digital Detail Enhancement)数字细节增强技术。可以提高图像及轮廓的清晰度。仅当场景模式KeyThermalSceneMANUAL时,才能手动设置。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持

      final KeyThermalContrast
      static final DJIKeyInfo<Integer> KeyThermalContrast = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalContrast", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      设置热成像对比度。画面黑与白的比值。比值越大,色彩表现越丰富。仅当场景模式KeyThermalSceneMANUAL时,才能手动设置。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0开始支持</code

      final KeyThermalBrightness
      static final DJIKeyInfo<Integer> KeyThermalBrightness = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"ThermalBrightness", SingleValueConverter.IntegerConverter).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: Integer

      设置热成像图像亮度。仅当场景模式KeyThermalSceneMANUAL时,才能手动设置。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为INFRARED_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_THERMAL


      MSDK 5.0.0开始支持


      多光谱功能

      final KeyMultiSpectralFusionType
      static final DJIKeyInfo<MultiSpectralFusionType> KeyMultiSpectralFusionType = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"MultiSpectralFusionType", new SingleValueConverter<>(MultiSpectralFusionType.class,MultiSpectralFusionTypeMsg.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: MultiSpectralFusionType

      设置多光谱融合类型,用于融合RGB传感器和单波段传感器的视频码流。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为NDVI_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_MS_NDVI


      MSDK 5.2.0开始支持

      final KeyMultiSpectralFusionDisplayRange
      static final DJIKeyInfo<MultiSpectralFusionDisplayRange> KeyMultiSpectralFusionDisplayRange = new DJIKeyInfo<>(componentType.value(),subComponentType.value(),"MultiSpectralFusionDisplayRange", new DJIValueConverter<>(MultiSpectralFusionDisplayRange.class)).canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: MultiSpectralFusionDisplayRange

      设置多光谱融合显示范围。可设置的范围:[-10,10]。在Pilot中这个范围被映射为[-1,1]。

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为NDVI_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_MS_NDVI


      MSDK 5.2.0开始支持

      final KeyMultiSpectralDisplayMode
      static final DJIKeyInfo<MultiSpectralDisplayMode> KeyMultiSpectralDisplayMode = new KeyMultiSpectralDisplayMode()
      .canGet(true).canSet(true).canListen(true).canPerformAction(false).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数: MultiSpectralDisplayMode

      设置多光谱镜头的显示模式。包括NDVI显示和分屏显示。
      如果需要设置把多光谱镜头设置成分屏显示模式,请调用此接口把显示模式设置为PIP

      注意:
      1. 要使用此功能,请调用KeyCameraVideoStreamSource把视频源设置为NDVI_CAMERA
      2. 使用KeyTools创建DJIKey实例的时候,把CameraLensType设置为CAMERA_LENS_MS_NDVI


      MSDK 5.2.0开始支持


      基本设置

      final KeyResetCameraSetting
      static final DJIActionKeyInfo<EmptyMsg,EmptyMsg> KeyResetCameraSetting = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"ResetCameraSetting", EmptyValueConverter.converter,EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      重置相机参数。

      MSDK 5.0.0开始支持

      格式化存储器
      final KeyFormatStorage
      static final DJIActionKeyInfo<CameraStorageLocation,EmptyMsg> KeyFormatStorage = new DJIActionKeyInfo<>(componentType.value(),subComponentType.value(),"FormatStorage", new SingleValueConverter<>(CameraStorageLocation.class,CameraStorageLocationMsg.class),EmptyValueConverter.converter).canGet(false).canSet(false).canListen(false).canPerformAction(true).setIsEvent(false)
      包:dji.sdk.keyvalue.key
      描述:

      参数:CameraStorageLocation
      格式化存储器。M30和M30T相机只支持SD卡。

      MSDK 5.0.0开始支持