This class contains the media manager and playback manager, which manage the camera's media content. It provides methods to change camera settings and perform camera actions. This object is available from the DJIAircraft or DJIHandheld object, which is a subclass of DJIBaseProduct.
Sets the camera's flat mode to take photo, record video, or enter intelligent camera modes. Please note that you cannot change the mode when a certain task is executing. This is available only when isFlatCameraModeSupported returns YES.
Enter playback mode, in which users can preview photos or videos, begin the video playback, and download media to the mobile device. This is available only when isFlatCameraModeSupported returns YES. Please note that only after exiting playback mode, last flat camera mode will be recovered.
Sets the camera's work mode to taking pictures, video, playback or download. Please note that you cannot change the mode when a certain task is executing, such as taking photo(s), recording video, or downloading and saving files. Also supported by thermal imaging camera.
Camera starts to take photo with one of the camera capture modes (shoot photo modes).Also,
Precondition: 1. Camera must be in ShootPhoto mode. Check the enum named CameraShootPhotoMode in DJICameraSettingsDef to find all possible camera capture modes. For thermal imaging camera, Single photo can be taken while recording video. 2. The SD card state should be checked before this method is used to ensure sufficient space exists.
Post condition: If the capture mode is either Burst or Interval, calling stopShootPhoto will be required for the camera to stop taking photos.
Precondition: 1. startShootPhotoWithCompletion has been invoked and the shoot mode is either Interval or Time-lapse. 2. If the capture mode is set to Single, the camera will automatically stop taking the photo once the individual photo is taken.
Sets the camera's exposure mode. Check DJICameraExposureMode to view all possible camera exposure modes. Please note that in different exposure mode, it will have different values for the same setting. For Mavic 2 Enterprise Dual, the exposure mode is always DJICameraExposureModeProgram. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera's ISO value. See DJICameraISO to view all possible ISO settings for the camera. For the X5, X5R, Phantom 4 Pro camera, X4S and X5S, the ISO value can be set for all modes. For the other cameras, the ISO value can only be set when the camera exposure mode is in Manual mode. See the setExposureMode:withCompletion method for how to set exposure mode. For Mavic 2 Enterprise Dual, the ISO value is always DJICameraISOAuto. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera shutter speed. To see all available shutterSpeed value settings, see DJICameraShutterSpeed. The shutter speed should not be set slower than the video frame rate when the camera's mode is DJICameraModeRecordVideo. For example, if the video frame rate is 30fps, the shutterSpeed must be <= 1/30. Precondition: The shutter speed can be set only when the camera exposure mode is Shutter mode or Manual mode. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Shutter speed value to be set for the camera. For all available values shutterSpeed can be set to, please check DJICameraShutterSpeed. <br> The shutter speed should not be set slower than the video frame rate when the camera's mode is DJICameraModeRecordVideo. For example, if the video frame rate = 30fps, then the shutterSpeed must be <= 1/30.
Check if the current device supports Metering. This is only supported by payload camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Determines whether the camera supports an adjustable aperture. Currently adjustable aperture is supported only by the X5, X5R, X4S, X5S cameras and Mavic 2 Pro. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the lens aperture. This feature is available only when isAdjustableApertureSupported returns YES. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera's exposure metering. See DJICameraMeteringMode to view all possible exposure metering settings for the camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the spot metering area index. The camera image is divided into 96 spots defined by 12 columns and 8 rows. The row index range is [0,7], where the values increase top to bottom across the image. The column index range is [0, 11], where the values increase left to right. In order to make the method work, The camera exposure mode should be Program, Shutter or Aperture, the exposure metering mode must be DJICameraMeteringModeSpot, and setAELock:withCompletion must be NO. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Input Parameters:
uint8_t rowIndex
Spot metering row index to be set. The value should falls in [0, 7], where the values increase top to bottom across the image.
uint8_t columnIndex
Spot metering column index to be set. The value should falls in [0, 11], where the values increase left to right.
Sets the camera's exposure compensation. See DJICameraExposureCompensation to view all possible exposure compensations to which the camera can be set. In order to use this function, set the camera exposure mode to shutter, program or aperture. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Locks or unlocks the camera's AE (auto exposure). Post condition: If the AE lock is enabled, the spot metering area cannot be set. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Input Parameters:
BOOL isLocked
YES if the camera AE is locked, NO if it is unlocked.
Enables/disables auto-unlocking of AE lock after shooting a photo. If it is enabled, the Auto Exposure will unlock after each shot. If disabled, Auto Exposure will change when calling setAELock:withCompletion. It is only supported X4S, X5S and Phantom 4 Pro cameras. For the other products, auto-unlocking is always enabled. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Determines whether auto-unlocking of AE lock is enabled. It is only supported by X4S, X5S and Phantom 4 Pro cameras. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera's white balance. When the white balance is a preset value (values except DJICameraWhiteBalancePresetCustom), the colorTemperature argument does not take effect. When the white balance is DJICameraWhiteBalancePresetCustom, the colorTemperature value is used instead. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
YES if the changeable lens is supported by the camera. Currently a changeable lens is supported only by the X5, X5R and X5S cameras. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets details of the installed lens. Supported only by the X5, X5R, X5S and X7 cameras. This is available only when isInterchangeableLensSupported returns YES. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Check if the current device supports digital zoom scale. It is supported by Osmo with X3 camera, Phantom 4 camera, Z3 camera, Mavic Pro camera and Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Adjusts the digital zoom. It is supported by Osmo with X3 camera, Phantom 4 camera, Z3 camera, Mavic Pro camera and XT 2 camera, DJI Mini 2. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets current digital zoom. It is supported by Osmo with X3 camera, Phantom 4 camera, Z3 camera, Mavic Pro camera and Z30 camera. Note Z30 cannot set the digital zoom scale, but will use digital zoom when using startContinuousOpticalZoomInDirection:withSpeed:withCompletion and the optical zoom has reached its limit. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Check if camera supports optical zoom. It is only supported by X5, X5R and X5S camera with the Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ lens, Z3 camera, Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the specification of the zoom lens. It is only supported by X5, X5R and X5S camera with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera, Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets focal length of the zoom lens. It is only supported by X5, X5R and X5S camera with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, X5S camera with Panasonic Lumix 14-42mm/3.5-5.6 HD or Olympus M.Zuiko 9-18mm/4.0-5.6, Z3 camera, Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets zoom lens focal length in units of 0.1mm. It is only supported by X5, X5R and X5S camera with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera, Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Start changing the focal length of the lens in specified direction with specified speed. Focal length change (zooming) will halt when maximum or minimum focal lengths are reached, or stopContinuousOpticalZoomWithCompletion is called. It is only supported by X5, X5R and X5S camera on Osmo with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera, Z30 camera. For Zenmuse H20 Series, please use class DJILens.
Called to stop focal length changing, when it currently is from calling startContinuousOpticalZoomInDirection:withSpeed:withCompletion. It is only supported by X5, X5R and X5S camera on Osmo with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera, Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Determines whether the current camera supports TapZoom feature. TapZoom is only supported by Z30 camera. @return YES if the camera supports TapZoom. In multiple lenses camera, if one of its lenses supports this feature, the camera and the lens that can supports both return YES. User can only access the parameters through the lens object. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Enable/disable TapZoom. tapZoomAtTarget:withCompletion can only be called when TapZoom is enabled. It is only supported Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Determines whether TapZoom is enabled. It is only supported by Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
TapZoom uses a multiplier to change the zoom scale when called. The final zoom scale for a TapZoom will be: Current Zoom Scale x Multiplier. The multiplier range is [1,5]. A multiplier of 1 will not change the zoom. When the multiplier is 1, the zoom scale will not change during TapZoom. It is only supported by Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
TapZoom at the target. It can be called only when TapZoom is enabled. When a new target is set, the gimbal will rotate and locate the target in the center of the screen. At the same time, the camera will zoom by multiplying the TapZoom multiplier. It is only supported Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Input Parameters:
CGPoint target
The target to zoom. The range for x and y is from 0.0 to 1.0. The point [0.0, 0.0] represents the top-left corner of the screen.
Hybrid zoom is combining optical and digital zoom. Camera will automatically switch over to digital zoom when optical zoom range is exceeded. Check if camera supports hybrid zoom. It is only supported by Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Hybrid zoom is combining optical and digital zoom. Camera will automatically switch over to digital zoom when optical zoom range is exceeded. Gets the specification of the zoom lens. It is only supported by Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Hybrid zoom is combining optical and digital zoom. Camera will automatically switch over to digital zoom when optical zoom range is exceeded. Sets focal length of the zoom lens. It is only supported by Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Hybrid zoom is combining optical and digital zoom. Camera will automatically switch over to digital zoom when optical zoom range is exceeded. Gets zoom lens focal length in units of 0.1mm. It is only supported by Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Determines whether the camera supports an adjustable focal point. Currently, the adjustable focal point is supported by the X5, X5R, Z3, Mavic Pro camera, Z30, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the lens focus mode. See DJICameraFocusMode. It is available only when isAdjustableFocalPointSupported returns YES. Supported by the X5, X5R, Z3 cameras (Z3 camera can only support DJICameraFocusModeAuto), the Mavic Pro camera, Z30, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the lens focus mode. Please check DJICameraFocusMode. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Mavic Pro camera, Z30, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the lens focus target point. When the focus mode is auto, the target point is the focal point. When the focus mode is manual, the target point is the zoom out area if the focus assistant is enabled for the manual mode. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Mavic Pro camera, Phantom 4 Pro camera, Mavic 2 Pro, Mavic 2 Zoom Camera, Mavic 2 Enterprise Camera, X4S and X5S. camera, X4S and X5S. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Input Parameters:
CGPoint focusTarget
The focus target to set. The range for x and y is from 0.0 to 1.0. The point [0.0, 0.0] represents the top-left angle of the screen.
Gets the lens focus target point. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Mavic Pro camera and Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Used to enable/disable the lens focus assistant. When the focus assistant is enabled, the camera live view will digitally zoom into the focus target area so the user can see the quality of focus. Focus assistant can be used for both manual focus (MF) and auto focus (AF). It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3, Phantom 4 Pro camera, X4S and X5S. Because Z3 only supports AF mode, isEnabledMF will be ignored.
Determines whether the lens focus assistant is enabled. When the focus assistant is enabled, the camera live view will digitally zoom into the focus target area so the user can see the quality of focus. Focus assistant can be used for both manual focus (MF) and auto focus (AF). It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Phantom 4 Pro, X4s and X5S. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the lens focusing ring value's max value. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Set the focal distance by simulating the focus ring adjustment. Value can have a range of 0, getFocusRingValueUpperBoundWithCompletion], which represents infinity and the closest possible focal distance. It is available only when isAdjustableFocalPointSupported returns YES. For some lenses, the minimum focus ring value is larger than 0. For example the minimum of DJI MFT 15mm f/1.7 ASPH is 270. To retrieve the minimum value, perform the following steps: - Call setFocusMode:withCompletion with DJICameraFocusModeAuto. - Call setFocusTarget:withCompletion with the furthest target (>30m). - Call getFocusRingValueWithCompletion to get the current focus ring value. This is the minimum value. The maximum value can be retrieved using getFocusRingValueUpperBoundWithCompletion. Supported only by X5, X5R, Z3 cameras, Phantom 4 Pro, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Input Parameters:
NSUInteger value
Value to adjust focus ring to. The minimum value is 0, the maximum value depends on the installed lens. Please use method getFocusRingValueUpperBoundWithCompletion to ensure the input argument is valid.
Gets the lens focus ring value. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Phantom 4 Pro, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera, Mavic 2 Enterprise Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera's photo file format. See DJICameraPhotoFileFormat to view all possible photo formats to which the camera can be set. Also supported by thermal imaging camera. Not supported by Z30 camera and Mavic 2 Enterprise Dual as the photo file format for Z30 is always DJICameraPhotoFileFormatJPEG. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the burst shoot count for the camera when the user wants to use that feature. Check DJICameraPhotoBurstCount to view all possible burst count values to which the camera can be set.
Sets the RAW image burst shoot count for the camera when the user wants to use that feature. See DJICameraPhotoBurstCount to view all possible burst count values to which the camera can be set. It is only supported Inspire 2.
Sets the interval shoot parameters. The camera will capture a photo, wait a specified interval of time, take another photo, and continue in this manner until it has taken the required number of photos. Also supported by thermal imaging camera.
Change the original image configuration when shooting panorama photos. CAUTION: enabling this may consume 500 MB in the SD card or the internal storage for each panorama. It is supported by Spark, Mavic Air, Mavic 2, Mavic 2 Pro, Mavic 2 Zoom, Mavic 2 Eneterprise, Mavic 2 Enterprise Dual. For Mavic Air, format is not used and it will ignore the value.
Gets the configuration, which determines the behavior for the original images when shooting panorama photos. CAUTION: If this is enabled, it may consume 500 MB in the SD card or the internal storage for each panorama. It is supported by Mavic Air and Mavic 2. However, Mavic Air cannot change the format to save the original images. format will be ignored by Mavic Air.
Sets the camera's video resolution and frame rate. @warning The supported resolutions and frame rates for the two different analog television standards PAL and NTSC are below:
Sets the camera's video file format. The default value is DJICameraVideoFileFormatMOV. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera's analog video standard. Setting the video standard to PAL or NTSC will limit the available resolutions and frame rates to those compatible with the chosen video standard.
Enables recording position, time and camera information into a video caption file (.srt) saved on the SD card. The information is updated at 1Hz. Currently the .srt file can only be downloaded directly from the SD card.
Enables/disables the recording of RAW video. It is supported by X5S. User can use the other SSD interfaces only when it is enabled. For X5R, RAW recording is always enabled if there is SSD inserted.
Set Raw Video Resolution and Frame Rate of the SSD. Note, only raw video is saved to the SSD. Compressed video, compressed pictures and raw pictures are all saved to the SD Card. During video capture, Raw video and compressed video are saved simultaneously to the SSD and SD Card respectively. @warning The supported resolutions and frame rates for SSD Raw Videos are shown below:
For X5S, the frame rate of SSD has to be the same as the video to be stored in SD card, so frameRate is ignored. The possible resolutions are determined by SD card video's frame rate and the SSD video license (DJICameraSSDVideoLicense) being used. The supported resolutions in the current configuration can be queried by using SSDVideoResolutionRange in DJICameraCapabilities.
Gets the camera color for video that will store in SSD. This is the legacy version of SSD Color and it is only supported by Inspire 2 with firmware package versions (getFirmwarePackageVersionWithCompletion) lower than 01.0.0240. For newer firmware package versions, use getSSDColorWithCompletion instead.
Gets purchased license key(s). An Inspire 2 License Key activates the usage permission of CinemaDNG or Apple ProRes inside CineCore 2.0. User can purchase a license key on DJI's website. It is supported by Inspire 2. the digital filter for video that will store in SSD. It is only supported Inspire 2.
Sets the watermark configuration. Enables this to add timestamp and location stamp to the newly generated photos or videos. It is only supported by Mavic 2 Enterprise series. For Mavic 2 Enterprise Dual, the watermark is only applied to photos and videos generated by the visual camera.
Gets the watermark settings. If it is enabled, timestamp and location stamp will be added to the newly generated photos or videos. It is only supported by Mavic 2 Enterprise series. For Mavic 2 Enterprise Dual, the watermark is only applied to photos and videos generated by the visual camera.
Custom expand directory name settings. After calling this interface, the newly generated media files (videos or photos) will be stored in the new folder, this new folder's name will be appended by your custom directory name. For example, the default folder name is "DJI_202001012359_01", you could append "Mission1" after it, so the new folder's name will be "DJI_202001012359_01_Mission1". In one flight, you can set multiple expand directory names to create multiple custom folders. Only Supported by Zenmuse P1, Zenmuse L1, Zenmuse H20 Series.
Custom expand file name settings. By calling this interface, the name of next media file (video or photo) which would be stored in camera will be appended by the custom file name you set. For example, the default photo name is "DJI_2020012091415_999_WIDE.JPG", you could append "Waypoint1" after the default photo name, so the new photo's name will be "DJI_2020012091415_999_WIDE_Waypoint1.JPG", This action will only take effect once. If you want to have the same name for all media files in one flight, you need to set this action before taking each photo. Only Supported by Zenmmuse P1, Zenmuse H20 Series.
Determines whether the SSD is supported by the camera. Currently, the SSD is supported only by X5R, X4S and X5S camera. @return YES if SSD is supported, otherwise NO.
Sets the laser enabled. Laser sensor turns on ranging function. Set YES to enable the laser distance sensor with measuring ranges to natural object. The laser sensor must be at least 3m from the target point. It is only supported for Zenmuse H20 series.
Sets the camera's anti-flicker frequency for video recording. Precondition: The exposure mode must be Program. Note: for the Z30 camera, changing anti-flicker will reboot the camera before the setting takes effect. It is not supported by Zenmuse H20 Series.
Enables/disables the IR filter (infared filter). Disabling the IR filter can enhance the image in low light environments. Enabling the IR filter can reduce the color distortion caused by the infared light. It is only supported by Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Determines whether IR filter (infared filter) is enabled. Disabling the IR filter can enhance the image in low light environments. Enabling the IR filter can reduce the color distortion caused by the infared light. It is only supported by Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the camera's color. The default value is DJICameraColorNone. For a list of all possible camera colors, see DJICameraColor. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Enables vision stabilization for Z30 camera on M200 series. The vision system in the M200 series of aircraft can be used to compensate for any drift in the gimbal by analyzing the live view when there is no gimbal movement. Drift in the gimbal will be most noticeable at higher zoom factors. It is only supported Z30 on M200 series.
Custom information can be stored in media file's XMP meta data. The custom information is written to the media file automatically after the media file is created. This method defines the information to write. The same information will be written to all media files until the information is changed again by this method. Custom information written to each file can be retrieved through fetchCustomInformationWithCompletion or from the image itself when processed on a separate system. It is supported by Phantom 4 Pro, Phantom 4 Advanced, Phantom 4 Pro V2.0, Zenmuse P1, Zenmuse L1, Zenmuse X4S, Zenmuse X5S, Zenmuse X7, Mavic 2 Enterprise camera and Mavic 2 Enterprise Dual camera.
Input Parameters:
NSString * information
Custom information to set. Use UTF-8 encoding with a length equal to or less than 31 characters.
Custom information can be stored in media file's XMP meta data. This method retrieves the information that will be written to future media files. The information written to individual files can be retrieved through fetchCustomInformationWithCompletion. It is only supported Phantom 4 Pro, Phantom 4 Advanced, Phantom 4 Pro V2.0, Zenmuse P1, Zenmse L1, Zenmuse X4S, Zenmuse X5S, Zenmuse X7, Mavic 2 Enterprise camera and Mavic 2 Enterprise Dual camera.
Determines whether the EI (exposure index) mode is supported by the camera. In this mode, the camera mimics the way a film camera works to help cinematographers capture as much information as possible while balancing the dynamic range and noise with different log curves. This mode only takes effect when the camera mode is in DJICameraModeRecordVideo. The EI mode is supported by X4S, X5S and X7. In multiple lenses camera, if one of its lenses supports this feature, the camera and the lens that can supports both return YES. User can only access the parameters through the lens object.
Sets the exposure sensitivity mode. It is only supported when isEIModeSupported returns YES. It is supported by X4S, X5S and X7. For other cameras, only ISO mode is supported.
Gets the exposure sensitivity mode. It is only supported when isEIModeSupported returns YES. It is supported by X4S, X5S and X7. For other cameras, only ISO mode is supported.
Gets the EI value recommended by the camera. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Gets the valid range of EI values. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Input Parameters:
NSArray<NSNumber *> *_Nullable range
The valid range of EI values. Each element is an integer.
Sets the camera color for EI mode. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Gets the camera color for EI mode. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Determines whether the mechanical shutter speed is supported by the camera or the lens (for X7). The mechanical shutter is supported by Zenmuse P1, Phantom 4 Pro camera, X4S and X7 with DL lenses. In multiple lenses camera, if one of its lenses supports this feature, the camera and the lens that can supports both return YES. User can only access the parameters through the lens object.
Return:
BOOL
YES if the mechanical shutter is supported, otherwise NO.
Enables the mechanical shutter. It is only valid when isMechanicalShutterSupported returns YES. For Zenmuse L1, this interface can not enabled in video mode.
Determines whether the ND filter mode is supported by the camera and the lens. Only the DL-S 16mm F2.8 ND ASPH lens for X7 has a built-in ND4 filter and supports changing the modes through an application. In multiple lenses camera, if one of its lenses supports this feature, the camera and the lens that can supports both return YES. User can only access the parameters through the lens object.
Return:
BOOL
YES if the ND filter mode is supported, otherwise NO.
Sets the clip name for the video to be stored in SSD. The clip name will be applied to the next video file stored in SSD. After saving a video file, clipID will increase by 1 automatically. It is only supported by Inspire 2.
Determines whether the device supports the quick view. Quick view is the period of time a photo is shown as a preview after it is taken and before the camera returns to the live camera view. In multiple lenses camera, if one of its lenses supports this feature, the camera and the lens that can supports both return YES. User can only access the parameters through the lens object.
Sets the camera's quick view duration. The valid range is [0, 10] seconds. When duration is 0, it means that the quick view is disabled. The default value is 0 second. Call isPhotoQuickViewSupported before using this method.
Enables HD (high-definition) live view. When it is enabled, the live view resolution is 1080p with frame rate 30 fps. The settings will only take effect when the camera is in record-video mode and the video resolution is either 1080p or 2.7k without slow-motion enabled. If recording video in 4k, then the live stream will be limited to 720p. Supported by Mavic Air 2, DJI Air 2S, Mavic Pro, Mavic 2 Pro, Mavic 2 Zoom and Phantom 4 Pro v2.0.
YES if 1080p live view is enabled. This will return the value of the setter, and not necessarily the actual live view resolution. For example, if recording in 4K and HD live view has previously been set, then this will return YES but the actual live view resolution will be 720p. Supported only by , DJI Air 2S, Mavic Pro, Mavic 2 Pro, Mavic 2 Zoom and Phantom 4 Pro V2.0.
Enables the automatic control of the front-arm LEDs. The camera can turn off the front-arm LEDs automatically when it shoots photos or records videos. The LEDs will be turned on after the shooting or recording is finished. Supported only by Mavic Pro, Mavic Air, and Mavic 2 series.
Input Parameters:
BOOL enabled
Enable the automatic control of the front-arm LEDs.
Enables the automatic control of the beacon. The camera can turn off the beacon automatically when it shoots photos or records videos. The LEDs will be turned on after the shooting or recording is finished. Only Supported by Matrice 200 series V2 and Zenmuse H20 Series mounted on Matrice 300 RTK.
Determines if the camera supports the internal storage or not. When it is supported, the camera shoot photos or record videos without SD card. The newly generated photos or videos will be stored in the internal storage.
Sets the storage location for the newly generated photos or videos. It is only supported when isInternalStorageSupported returns YES. Not supported by Mavic Mini, DJI Mini 2, DJI Mini SE.
This method will turn off the camera's cooling fan whenever the camera is cool enough to do so. This allows better audio recording from the internal microphone in the camera.
YES if the current connected device is a thermal imaging camera. @return BOOL YES if current connected device is thermal imaging camera. For Zenmuse H20T and H20N, please use class DJILens.
Sets the Region of Interest (ROI). Used to manage color range distribution across the screen to maximize contrast for regions of highest interest. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Sets the Palette. Each palette is a unique look-up table that maps 8-bit temperature values to different colors. Different palettes can be used to help the user better visualize temperature contrast or specific temperature bands. The valid range can be fetched from DJISupportedCameraThermalPaletteRange. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Sets the scene to instantly enhance your image. In all modes except Manual and User modes, the DDE, ACE, SSO, brightness and contrast are set automatically to obtain the best result. In User modes, the contrast and brightness are set automatically to obtain the best results. Any settings that are made in these modes are retained if the scene is changed. In Manual mode, DDE, contrast and brightness are set manually. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Sets the Digital Data Enhancement index (for DDE dynamic mode). DDE can be used to enhance image details (sharpen, higher index) and/or suppress fixed pattern noise (soften, lower index). It can be set manually only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
NSInteger value
Integer in range [-20, 100]. Values less than 0 soften the image and filter fixed pattern noise. Values greater than 0 sharpen the details in the image. Value of 0 results in no enhancement.
Gets the value of Digital Data Enhancement. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Set the value of Active Contrast Enhancement. Active contrast enhancement allows for a contrast trade-off between hotter and colder scenes when using 8-bit pixel data. It can be set manually only when the Scene mode is User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
NSInteger value
Integer in range [-8, 8]. <br> value > 0: more contrast in hotter scene content and less contrast in colder scene content (sky, ocean etc.). <br> value < 0: more contrast in colder scene content and less contrast in hotter scene content. <br> value = 0: neutral <br> value = 3: recommended for generic use
Gets the value of Active Contrast Enhancement. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Sets the value of Smart Scene Optimization. When using non-linear histogram equalization to map the 14-bit sensor pixel values to 8-bit pixel values, it can become difficult to determine the difference in temperature of two objects from their different shades of gray. SSO allows a percentage of the 14-bit histogram to be mapped linearly to the 8-bit histogram, which will compromise local contrast, but allow for more accurate visual radiometric measurements. This is particularly useful for bi-modal scenes. It can be set manually only when the Scene mode is User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Gets the value of Smart Scene Optimization. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Sets the brightness of the image. It can be set manually only when the Scene mode is Manual. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Gets the value of brightness. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Sets the value of contrast, with larger values having higher contrast. It can be set manually only when the Scene mode is Manual. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Gets contrast value. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Enable or disable Isotherms. Isotherms can be used to highlight specific temperature ranges: When disabled, all 256 values (8-bits) are dedicated to the temperature histogram of the scene. When enabled, only 128 values (0-127) are mapped linearly to temperature. Then three bands 128-175, 176-223 and 224-255 can be mapped to the user defined temperatures to highlight them to the user. Using some of the false color palettes (like RainbowIso) results in a thermal image that is grey scale except for three specific bands highlighted by either reds, blues or greens. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Determines whether Isotherms are enabled. YES if Isotherms are enabled. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Sets the unit of the Isotherm ranges to either Celsius or percent. Different units results in different value ranges for Isotherms. Supported only by thermal imaging cameras except Mavic 2 Enterprise Dual thermal camera. For Mavic 2 Enterprise Dual, the Isotherm unit is always DJICameraThermalIsothermUnitCelsius. For Zenmuse H20T and H20N, please use class DJILens.
Gets the units for Isotherm ranges. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Mavic 2 Enterprise Dual, the Isotherm unit is always DJICameraThermalIsothermUnitCelsius. For Zenmuse H20T and H20N, please use class DJILens.
Sets the upper threshold value for Isotherm. All temperature values above this will use colors 224-255 from the palette. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
NSInteger value
If the unit is percentage, the allowed range is [0,100]. If the unit is Celsius, for Mavic 2 Enterprise Dual thermal camera, the value range is [-10, 400]. For other thermal imaging cameras, the value range is [-40, 500]. The value can only be equal or larger than middle Isotherm threshold.
Sets the middle threshold value for Isotherm. Temperature values between the middle and upper Isotherm threshold will be displayed with colors 176-223 from the palette. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
NSInteger value
If the unit is percentage, the value falls in [0,100]. If the unit is Celsius, the value range is [-40, 550]. The value can only be equal or larger than lower threshold and equal or smaller than upper threshold.
Gets the middle threshold value for Isotherm. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Zenmuse H20T and H20N, please use class DJILens.
Sets the lower threshold value for Isotherm. Temperature values between the lower and middle Isotherm threshold will be displayed with colors 128-175 from the palette. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
NSInteger value
If the unit is percentage, the value falls in [0,100]. If the unit is Celsius, for Mavic 2 Enterprise Dual thermal camera, the value range is [-10, 400], for other thermal imaging cameras, the value range is [-40, 500]. The value can only be equal or smaller than upper threshold.
Sets the gain mode. Low gain mode can be used for scenes with temperatures ranging from -40 to 550 degrees Celsius. For higher contrast, the high gain mode can be used by for temperatures between -25 to 135 degrees Celsius for the 640x512 camera and -25 to 100 degrees Celsius for 324 x 256 camera. Mavic 2 Enterprise Dual has different temperature range from other thermal imaging cameras. Therefore, for Mavic 2 Enterprise Dual, the low gain mode can be used from -10 to 140 degrees Celsius. The high gain mode can be used from -10 to 400 degree Celsius. Supported by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
For resolution 640 x 512, x1,x2,x4,x8 can be set. For resolution 336 x 256, only x1,x2,x4 can be set. Please refer to DJICameraThermalDigitalZoomScale in DJICameraSettingsDef.
Gets the thermal imaging camera profile. The profile includes information about resolution, frame rate and focal length. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Sets the spot metering target point which then changes the camera:didUpdateTemperatureData delegate call to return. This method requires a relative point that is proportional to the dimension of the camera video dimension, the x, and y values must all be between 0 and 1.0. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Gets the spot metering target point if one is set, if not then returns CGPointZero. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Set the metering area for a rectangle inside the thermal image scene, which allows the camera to transmit aggregate temperature computations via the camera:didUpdateAreaTemperatureAggregations delegate method. See DJICameraThermalAreaTemperatureAggregations for the statistical values that are available. This method requires a relative rect that is proportional to the rect of the thermal scene, the x, y, width, and height values must all be between 0 and 1.0. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T, please use class DJILens.
Get a rect representing the currently set metering area for the thermal scene. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Get the currently set flat-field correction (FFC) mode. Supported only by thermal imaging cameras with installed firmware version of 1.15.1.60 or higher. For Mavic 2 Enterprise Dual thermal camera, the DJICamera_DJICameraThermalFFCMode is always DJICamera_DJICameraThermalFFCMode_Auto. For Zenmuse H20T and H20N, please use class DJILens.
Set the custom user profile. This profile represents user-set external scene parameters for the thermal scene. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Get the currently set custom user profile. This profile represents user-set external scene parameters for the thermal scene. Supported only by thermal imaging cameras. For Zenmuse H20T and H20N, please use class DJILens.
Set the temperature of the atmosphere between the scene and the camera. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
float temperature
The assumed temperature of the atmosphere between the camera and the scene, can be between -50 and 327.67 degrees Celsius.
Set the transmission coefficient of the atmosphere between the scene and the camera. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Input Parameters:
float coefficient
The desired atmospheric temperature, can be between 50 and 100.
Set the assumed temperature reflected by the background of the scene, can be between -50 and 327.67 degrees Celsius. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Set the emissivity of the thermal scene, can be between 50 and 100. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Set assumed window reflection coefficient, can be between 0 and X where X is the window transmission coefficient parameter. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Set the temperature reflected in the window, can be between -50 and 327.67 degrees Celsius. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Set the window temperature, can be between -50 and 327.67 degrees Celsius. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Set the window transmission coefficient, can be between 50 and 100-X where X is the window reflection. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20T and H20N, please use class DJILens.
Sets the temperature unit. Only supported by XT2 and Mavic 2 Enterprise Dual. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the display mode to coordinate the video feeds from both the visual camera and the thermal camera. Only supported by XT2 camera and Mavic 2 Enterprise Dual Thermal Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the display mode. The display mode determine the way to coordinate the video feeds from both the visual camera and the thermal camera. Only supported by XT2 camera and Mavic 2 Enterprise Dual Thermal Camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the PIP position which determines the thermal window's position relative to the visual window. The setting is valid when the display mode is DJICameraDisplayModePIP. Refer to setDisplayMode:withCompletion and getDisplayModeWithCompletion. Only supported by XT2 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the level for MSX display mode. The range for level is [0, 100]. When it is 0, the visible spectrum definition is invisible. When it is 100, the visual spectrum definition is the most obvious. Only supported by XT2 camera and Mavic 2 Enterprise Dual. Mavic 2 Enterprise Dual does not support with firmware version lower than 01.01.0520. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Gets the level for MSX display mode. The range for level is [0, 100]. When it is 0, the visible spectrum definition is invisible. When it is 100, the visual spectrum definition is the most obvious. Only supported by XT2 camera and Mavic 2 Enterprise Dual. Mavic 2 Enterprise Dual does not support with firmware version lower than 01.01.0520. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Sets the vertical alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-8, 8]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window up. Use this setting to fine-tune the performance of MSX display mode and the align PIP mode. Only supported by XT2 camera and Mavic 2 Enterprise Dual.
Gets the vertical alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-8, 8]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window up. Only supported by XT2 camera and Mavic 2 Enterprise Dual camera.
Sets the horizontal alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-100, 100]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window to the right. Use this setting to fine-tune the performance of MSX display mode and the align PIP mode. Only supported by XT2 camera and Mavic 2 Enterprise Dual.
Gets the horizontal alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-100, 100]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window to the right. Only supported by XT2 camera and Mavic 2 Enterprise Dual.
Lenses list supported by a multiple lens camera. Lenses cannot execute camera actions such as shoot photo or record video even their class type are also DJICamera. You can only set a lens's particular parameters through one of them. Only supported by Zenmuse H20 Series.
Sets the camera video stream source. For multi-lens cameras, the camera stream has different sources. DJICameraVideoStreamSource is used to represents the camera video stream source. When the source of the camera video stream is set, the current live view stream will also been changed to corresponding source. It is only supported by Zenmuse H20 Series.
Gets the camera video stream source. For multi-lens cameras, the camera stream has different sources. DJICameraVideoStreamSource is used to represents the camera video stream source. When the source of the camera video stream is set, the image transmission will also been changed to corresponding source. It is only supported by Zenmuse H20 series.
By default, all lenses of this camera will take photos. by using this interface, you can select your interested lens to take photos. Before calling this interface, you should set the camera mode to photo mode. Only supported by Zenmuse H20 series.
Sets the camera stream settings for recording video. When recording video, it will been determined whether if current screen is recorded and which camera stream sources are recorded according the camera settings. The class of DJICameraStreamSettings is used to set the camera stream settings. Before calling this interface, you should set the camera mode to video mode. Only supported by Zenmuse H20 series.
Sets the display mode to coordinate the video feeds from both the RGB sensor and single-band sensors. Only supported by multispectral camera of P4 Multispectral.
Gets the display mode. The display mode determines the way to coordinate the video feeds from both the RGB sensor and single-band sensors. Only supported by multispectral camera of P4 Multispectral.
Sets the storage settings for the multispectral camera. The settings control if the photos created by different sensors will be saved or not. Only supported by multispectral camera of P4 Multispectral.
Sets the metering mode for the single-band sensors on the multispectral camera. The same metering mode will be applied to all single-band sensors (sensors except the RGB one). Only DJICameraMeteringModeCenter and DJICameraMeteringModeAverage mode to be set. Only supported by multispectral camera of P4 Multispectral.
Sets the exposure mode for the single-band sensors on the multispectral camera. The same exposure mode will be applied to all single-band sensors (sensors except the RGB one). Exposure mode must be DJICameraExposureModeProgram or DJICameraExposureModeShutterPriority. Only supported by multispectral camera of P4 Multispectral.
Sets the exposure compensation for the single-band sensors on the multispectral camera. The same exposure compensation will be applied to all single-band sensors (sensors except the RGB one). See DJICameraExposureCompensation to view all possible exposure compensations to which the single-band sensors can be set. In order to use this function, set the camera exposure mode to DJICameraExposureModeProgram or DJICameraExposureModeShutterPriority Only supported by multispectral camera of P4 Multispectral.
Sets the shutter speed for the single-band sensors on the multispectral camera. The same shutter speed will be applied to all single-band sensors (sensors except the RGB one). To see all available shutter speed value settings, see DJICameraShutterSpeed. The shutter speed should not be set slower than the video frame rate when the camera's mode is DJICameraModeRecordVideo. For example, if the video frame rate is 30fps, the shutter speed must be <= 1/30. Precondition: The shutter speed can be set only when the camera exposure mode is DJICameraExposureModeShutterPriority mode. Only supported by multispectral camera of P4 Multispectral.
Shutter speed value to be set for the single-band sensors. For all available values shutterSpeed can be set to, please check DJICameraShutterSpeed. <br> The shutter speed should not be set slower than the video frame rate when the camera's mode is DJICameraModeRecordVideo. For example, if the video frame rate = 30fps, then the shutterSpeed must be <= 1/30.
Gets the shutter speed for all single-band sensors (sensors except the RGB one). The shutter speed is only available when the camera exposure mode is DJICameraExposureModeShutterPriority mode.
Locks or unlocks the single-band sensors on the multispectral camera AELock AE (auto exposure). The same lock state will be applied to all single-band sensors (sensors except the RGB one).
Input Parameters:
BOOL isLocked
YES if the the single-band sensors AE is locked, NO if it is unlocked.
If you encounter the following situation, please call this interface for camera calibration. Only supported by Zemmuse P1. 1. Zemmuse P1 supports the replacement of a variety of fixed focus lenses, so when the lens is replaced, it is recommended that you recalibrate. 2. Please listen the camera:didUpdateCalibrationState, if the status is DJICameraCalibrateState_NotCalibrate, please recalibrate. 3. Please listen the hms error code, If you listen to the following error code, please recalibrate. hms_0x1C000D02: The camera calibration file failed to load, please perform infinity calibration. hms_0x1C000D03: Infinity focus calibration data expired. Recalibrate. hms_0x1C000D04: Infinity focus calibration data expired. Recalibrate.
Make sure you have calibrated the lens' infinity focusing with startCalibrationWithCompletion. When in use, the lens uses infinity focus as calibrated. To help ensure focusing accuracy, recalibrate the infinity focus when there is a large temperature difference between the mission environment and the calibration environment (>15 degrees Celsius).
Called when the camera's storage state has been updated. Use DJICameraStorageState's location to determine if the updated state is for SD card or the internal storage.
The camera storage state. If the camera supports internal storage (e.g. Mavic Air), use location to determine whether the state is for SD card or internal storage.
Called when there are new min, max, and average temperature values available for the set spot metering area. Supported by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Called when updated external scene settings are available. Supported only by Zenmuse XT containing Advanced Radiometry capabilities. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Called whenever the camera parameters change. In automatic exposure modes (Program, Shutter Priority and Aperture Priority) the camera may be automatically changing aperture, shutter speed and ISO (depending on the mode and camera) when lighting conditions change. In Manual mode, the exposure compensation is automatically updated to let the user know how much compensation the exposure needs to get to an exposure the camera calculates as correct. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Received temperature in degrees Celsius of image. The thermal imaging camera will only update the temperature if the temperature data is enabled. For the XT Standard version, the temperature measurement data is the average of the center four pixels of the image. For the XT Advanced Radiometry version, the temperature measurement point can be set using setThermalSpotMeteringTargetPoint:withCompletion. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Called when the camera's zoom state is updated. It is only supported by Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please use class DJILens.
Flat camera mode can be used to set the mode to camera directly. The benefit is no need to set the camera mode to shoot photo mode or the Record video first. Please use setFlatMode:withCompletion to set the flat mode. This is available only when isFlatCameraModeSupported returns YES.
Enum Members:
DJIFlatCameraModeVideoNormal
Sets the camera to record normal videos.
DJIFlatCameraModePhotoTimeLapse
Sets the camera to take a picture (or multiple pictures) continuously at a set time interval. The camera will merge the photo sequence and the output is a video. The minimum interval for Video only format is 1 s. The minimum interval for Video+Photo format is 2 s.
DJIFlatCameraModePhotoAEB
Automatic Exposure Bracketing (AEB) capture. In this mode you can quickly take multiple shots (the default is 3) at different exposures without having to manually change any settings between frames.
DJIFlatCameraModePhotoSingle
Sets the camera to take a single photo.
DJIFlatCameraModePhotoBurst
Set the camera to take multiple photos at once.
DJIFlatCameraModePhotoHDR
Sets the camera to take photos in HDR mode.
DJIFlatCameraModeVideoHDR
Sets the camera to HDR video recording mode. Only supported by Mavic Air 2.
DJIFlatCameraModePhotoInterval
Sets the camera to take a picture (or multiple pictures) continuously at a set time interval. The minimum interval for JPEG format of any quality is 2s.
DJIFlatCameraModePhotoHyperLight
Sets the camera to take photos in HyperLight mode. It is a setting for low-light environment to enhance the photo quality while reducing noise significantly.
DJIFlatCameraModePhotoPanorama
Sets the camera to take photos in panorama mode. the aircraft takes a series of photos with different gimbal and aircraft heading positions. The photos can be stitched with a third-party library.
DJIFlatCameraModePhotoEHDR
Sets the camera to take an enhanced-HDR photo. It blends a sequence of photos for ghost-free high dynamic range photos.
DJIFlatCameraModePhotoHighResolution
Sets the camera to the high resolution mode. In this mode, the camera will take photos with a resolution of 48MP. Only supported by Mavic Air 2.
DJIFlatCameraModePhotoSmart
Sets the camera to the smart mode. In this mode, when shooting photo, the camera can automatically recognize the scene, and use the built-in algorithm to optimize the scene. Only supported by Mavic Air 2, DJI Air 2S.
DJIFlatCameraModeInternalAISpotChecking
Internal work mode during smart inspection and it cannot be set manually. This mode might last for less than 10 seconds, during when the user cannot take photo, record a video, enter media playback mode, set spot metering target of DJILensTypeZoom lens type, and set zoom focus length with any lens type. Only DJICameraFocusModeAuto can be set with DJILensTypeZoom lens type. In this mode, remote controller also cannot be used to take photo, record video and adjust focus. It's only supported by Matrice 300 RTK.
Capture mode. In this mode, the user can capture pictures.
DJICameraModeRecordVideo
Record mode. In this mode, the user can record videos.
DJICameraModePlayback
Playback mode. In this mode, the user can preview photos and videos, and can delete files. It is supported by Phantom 3 Professional camera, X3, X5 and X5R cameras on aircraft and Phantom 4 camera. Playback mode is not supported by Z30, X5S, X4S, Phantom 4 Pro, Mavic Pro, Phantom 3 Standard, Phantom 3 Advanced, Phantom 3 4K and Osmo series.
DJICameraModeMediaDownload
In this mode, the user can download media to the Mobile Device. Not supported by X5 camera nor X5R camera while mounted on aircraft.
DJICameraModeBroadcast
In this mode, live stream resolution and frame rate will be 1080i50 (PAL) or 720p60 (NTSC). In this mode videos can be recorded. Still photos can also be taken only when video is recording. The only way to exit broadcast mode is to change modes to DJICameraModeRecordVideo. Only supported by Inspire 2.
Sets the camera to take an HDR photo. X5 camera, X5R camera, XT camera, Z30 camera, Phantom 4 Pro camera, X4S camera and X5S camera do not support HDR mode.
DJICameraShootPhotoModeBurst
Set the camera to take multiple photos at once. XT camera does not support Burst mode.
DJICameraShootPhotoModeAEB
Automatic Exposure Bracketing (AEB) capture. In this mode you can quickly take multiple shots (the default is 3) at different exposures without having to manually change any settings between frames. XT camera and Z30 camera does not support AEB mode.
DJICameraShootPhotoModeInterval
Sets the camera to take a picture (or multiple pictures) continuously at a set time interval. The minimum interval for JPEG format of any quality is 2s. For all cameras except X4S, X5S and Phantom 4 Pro camera: The minimum interval for RAW or RAW+JPEG format is 10s. For the X4S, X5S and Phantom 4 Pro cameras the minimum interval for RAW or RAW+JPEG dformat is 5s.
DJICameraShootPhotoModeTimeLapse
Sets the camera to take a picture (or multiple pictures) continuously at a set time interval. The camera will merge the photo sequence and the output is a video. The minimum interval for Video only format is 1 s. The minimum interval for Video+Photo format is 2 s. For the new Osmo firmware version, no video feed will be received if the camera is shooting photos with Time-lapse mode. Instead, user can receive a sequence of preview images using the delegate method camera:didGenerateTimeLapsePreview. Supported only by Osmo camera (Z3 and X3).
DJICameraShootPhotoModePanorama
In panorama mode, the aircraft takes a series of photos with different gimbal and aircraft heading positions. The photos can be stitched with a third-party library. It is supported by Spark, Mavic Air, Mavic 2, Mavic 2 Pro, Mavic 2 Zoom, Mavic 2 Eneterprise, Mavic 2 Enterprise Dual.
DJICameraShootPhotoModeEHDR
Sets the camera to take an enhanced-HDR photo. It blends a sequence of photos for ghost-free high dynamic range photos. It is supported by Mavic 2 Zoom and Mavic 2 Pro.
DJICameraShootPhotoModeHyperLight
Sets the camera to take photos in HyperLight mode. It is a setting for low-light environment to enhance the photo quality while reducing noise significantly. It is supported by Mavic 2 Zoom and Mavic 2 Pro.
DJICameraShootPhotoModeHighResolution
Indicates that the photo was taken in high resolution mode(48 MP 8000×6000 pixel). Supported by Mavic Air 2.
DJICameraShootPhotoModeCameraPanorama
In Camera Panorama mode, which is miss in Previous Version since Mavic 2 Zoom and Mavic 2 Pro.
DJICameraShootPhotoModeRAWBurst
Sets the camera to take a burst of RAW photos. Use rawPhotoBurstCount to check how many photos have been shot. Only supported by X5S.
DJICameraShootPhotoModeShallowFocus
Sets the camera to take a series of photos while the aircraft moves up and down automatically. The image's depth of field can be computed with a third-party library to produce a photo with the bokeh effect. Note: 1. It is only suitable for shooting still scenes. 2. The aircraft will ascend about 20cm before shooting. Ensure that there is no obstacle about the aircraft. 3. The suitable range of shooting is within 30m. It is only supported by Spark.
Camera exposure modes. The default value is DJICameraExposureModeProgram. The different exposure modes define whether Aperture, Shutter Speed, ISO can be set automatically or manually. Exposure compensation can be changed in all modes except Manual mode where it is not settable. X5, X5R, Phantom 4 Pro camera, X4S and X5S: Program Mode: Shutter: Auto Aperture: Auto ISO: Manual or Auto Shutter Priority: Shutter: Manual Aperture: Auto ISO: Manual or Auto Aperture Priority: Shutter: Auto Aperture: Manual ISO: Manual or Auto Manual Mode: Shutter: Manual Aperture: Manual ISO: Manual
All other cameras: Program Mode: Shutter: Auto Aperture: Fixed ISO: Auto Shutter Priority: Shutter: Manual Aperture: Fixed ISO: Auto Aperture Priority: NA Manual Mode: Shutter: Manual Aperture: Manual ISO: Manual
The ISO value is automatically set. This cannot be used for all cameras when in Manual mode.
DJICameraISO50
The ISO value is set to 50.
DJICameraISO100
The ISO value is set to 100.
DJICameraISO200
The ISO value is set to 200.
DJICameraISO400
The ISO value is set to 400.
DJICameraISO800
The ISO value is set to 800.
DJICameraISO1600
The ISO value is set to 1600.
DJICameraISO3200
The ISO value is set to 3200.
DJICameraISO6400
The ISO value is set to 6400.
DJICameraISO12800
The ISO value is set to 12800.
DJICameraISO25600
The ISO value is set to 25600.
DJICameraISO51200
The ISO value is set to 51200.
DJICameraISO102400
The ISO value is set to 102400.
DJICameraISOFixed
ISO value is fixed by the camera firmware. When the camera color is set to DJICameraColorDLog, camera will fix the ISO to a specific value in order to optimize the performance. The value set by camera can be accessed from ISO.
Camera white balance. The default value is DJICameraWhiteBalanceAuto.
Enum Members:
DJICameraWhiteBalancePresetAuto
The camera's white balance is automatically set.
DJICameraWhiteBalancePresetSunny
The camera's white balance is set to sunny.
DJICameraWhiteBalancePresetCloudy
The camera's white balance is set to cloudy.
DJICameraWhiteBalancePresetWaterSurface
The camera's white balance is set to water surface.
DJICameraWhiteBalancePresetIndoorIncandescent
The camera's white balance is set to indoors and incandescent light.
DJICameraWhiteBalancePresetIndoorFluorescent
The camera's white balance is set to indoors and fluorescent light.
DJICameraWhiteBalancePresetCustom
The camera's white balance is set to custom color temperature. By using this white balance value, user can set a specific value for the color temperature.
DJICameraWhiteBalancePresetUnknown
The camera's white balance is unknown.
DJICameraWhiteBalancePresetNeutral
The camera's white balance is set to neutral. It is only supported by the X7.
This class contains current values for some camera parameters related to exposure, which determines how sensitive the picture is to light and depends on the balance of the ISO value, the shutter speed, and the aperture value. When the camera is in different exposure modes, different parameters are automatically changed by the camera to either get the correct exposure (in Program, Shutter Priority and Aperture Priority modes), or report back the current exposure (in Manual mode). The current values of these parameters used by the camera are contained in this class.
The current aperture value being used by the camera. A larger aperture results in a higher exposure and shallower depth of field. For cameras that do not support adjustable aperture (e.g. Zenmuse X3), the real aperture value is fixed.
The current shutter speed being used by the camera. A slower shutter speed results in a higher exposure, but more blurring in areas of the scene that are moving.
NSUInteger ISO
The current ISO value being used by the camera. DJICameraISO defines the number of the ISO values separated by one exposure stop. However, when the ISO is in automatic mode, the camera can select ISO values less than one stop apart, and therefore this property is the actual ISO value being used by the camera. A higher ISO results in a higher exposure, and more noise in the resulting image.
Returns the camera's current exposure compensation. In Program, Aperture Priority and Shutter Priority modes, the exposure compensation value changes the exposure target the camera is using to calculate correct exposure and is set by the user. For example, Aperture Priority mode indicates that the priority is to maintain the aperture setting and adjusting the exposure by varying the ISO and shutter speed. In Manual mode, this value is reported from the camera and reports how much the exposure needs to be compensated for to get to what the camera thinks is the correct exposure. In Manual mode, the range of exposure compensation reported by the camera is -2.0 EV to 2.0 EV. In Program, Aperture Priority and Shutter Priority modes, the range of exposure compensation is -3.0 EV to + 3.0 EV. For the Z30 camera in manual mode, exposureCompensation is not used and the value is always 'DJICameraExposureCompensationN00'.
NSUInteger EI
The current EI (exposure index) value being used by the camera. The value is only valid when the exposure sensitivity mode is DJICameraExposureSensitivityModeEI.
Display modes to coordinate the video feeds from both the visual camera and the thermal camera. Only supported by XT2 camera and and Mavic 2 Enterprise Dual Camera.
Enum Members:
DJICameraDisplayModeVisualOnly
Displays only the video feed from the visual camera.
DJICameraDisplayModeThermalOnly
Displays only the video feed from the thermal camera.
DJICameraDisplayModePIP
Displays the video feed from the visual camera as the main subject, and the video from the thermal camera in a window not bigger than the main subject. The position of the thermal camera window can be adjusted with DJICameraPIPPosition. Not supported by Mavic 2 Enterprise Dual.
DJICameraDisplayModeMSX
Multi-Spectral Dynamic Imaging. Fuse the video feeds from both the visual camera and the thermal camera as one. Adds visible spectrum definition to IR images by detecting the edges of objects and including that detail in the thermal image.
Possible positions to place the window of the thermal camera video feed when the display mode is DJICameraDisplayModePIP. Only supported by XT2 camera and Mavic 2 Enterprise Dual Light Camera.
Enum Members:
DJICameraPIPPositionCenter
Position the window to the vertical center and the horizontal center.
DJICameraPIPPositionBottomRight
Position the window to be bottom right.
DJICameraPIPPositionCenterRight
Position the window to be centered on the right.
DJICameraPIPPositionTopRight
Position the window to be top right.
DJICameraPIPPositionBottomCenter
Position the window to be centered at bottom.
DJICameraPIPPositionTopCenter
Position the window to be centered at top.
DJICameraPIPPositionBottomLeft
Position the window to be bottom left.
DJICameraPIPPositionCenterLeft
Position the window to be centered on the left.
DJICameraPIPPositionTopLeft
Position the window to be top left.
DJICameraPIPPositionSideBySide
Position the thermal window on the right side of the main window (the visual camera video feed). Scale both windows with the same height.
Hybrid zoom lens profile. Includes focal length range and maximum optical focal length and minimum focal length step. Supported by Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera.
Struct Members:
NSUInteger maxHybridFocalLength
The maximum hybrid zoom focal length of the lens in units of 0.1mm.
NSUInteger minHybridFocalLength
The minimum hybrid zoom focal length of the lens in units of 0.1mm.
NSUInteger maxOpticalFocalLength
The maximum optical zoom focal length of the lens in units of 0.1mm.
NSUInteger focalLengthStep
The minimum interval of focal length change in units of 0.1mm.
The state of the tap zoom action. Only supported by Z30 camera. For Zenmuse H20 Series and Mavic 2 Enterprise Advanced, please access the value through class DJILens.
Enum Members:
DJICameraTapZoomStateIdle
The tap zoom is not triggered yet. It will always push DJICameraTapZoomStateIdle if camera is not zooming.
DJICameraTapZoomStateZoomIn
The camera is zooming in. The focal length increases, field of view becomes narrower and magnification is higher.
DJICameraTapZoomStateZoomOut
The camera is zooming in the focal length decreases, field of view becomes wider and magnification is lower.
DJICameraTapZoomStateZoomLimited
It means the camera has reached its maximum focus length. It will always push DJICameraTapZoomStateZoomLimited if the camera reaches its maximum focus length.
Camera focus mode. It is settable only when isAdjustableFocalPointSupported returns YES and the physical AF switch on the camera is set to auto.
Enum Members:
DJICameraFocusModeManual
The camera's focus mode is set to manual. In this mode, user sets the focus ring value to adjust the focal distance.
DJICameraFocusModeAuto
The camera's focus mode is set to auto. For the Z30 camera, the focus is calculated completely automatically. For all other cameras, a focus target can be set by the user, which is used to calculate focus automatically.
DJICameraFocusModeAFC
The camera's focus mode is set to Continuous AF. It is only supported by Mavic Pro with firmware version V01.03.0000 or above, X4S camera, Mavic 2 Zoom camera and Mavic 2 Pro camera, DJI Air 2S.
The lens failed to focus on the target. This happens when the target is too close, or the camera cannot distinguish the object to focus (e.g. a white wall).
The sensor cleaning is finished and the camera is waiting for the lens to be remounted. When the lens is mounted, the state will change to DJICameraSensorCleaningStateIdle.
The camera stores both the RAW and JPEG formats of the photo.
DJICameraPhotoFileFormatTIFF14Bit
The camera's photo storage format is TIFF (14bit).
DJICameraPhotoFileFormatRadiometricJPEG
The camera's photo storage format is Radiometric JPEG (a special JPEG format with temperature information). A radiometric JPEG has the .jpg suffix and can be viewed as a normal JPEG file would. At the same time, the temperature data is also stored in the file as meta data. PC software is required to analyze the file and it is accessible at FLIR's website http://www.flir.com/instruments/display/?id=54865. Only supported by XT camera with firmware version 1.16.1.70 or above.
The camera's photo storage format is TIFF Linear Low. In this mode each pixel is 14 bits and linearly proportional with temperature, covering a high dynamic range of temperature which results in a lower temperature resolution. Supported only by Zenmuse XT containing Advanced Radiometry capabilities with firmware version 1.17.1.80 or lower. For newer firmwares, the temperature resolution preference is coupled with the thermal gain mode.
The camera's photo storage format is TIFF Linear High. In this mode each pixel is 14 bits and linearly proportional with temperature, covering a low dynamic range of temperature which results in a higher temperature resolution. Supported only by Zenmuse XT containing Advanced Radiometry capabilities with firmware version 1.17.1.80 or lower. For newer firmwares, the temperature resolution preference is coupled with the thermal gain mode.
The number of photos taken in one burst shot (shooting photo in burst mode).
Enum Members:
DJICameraPhotoBurstCount2
The camera burst shoot count is set to capture 2 pictures at once when the camera shoots a photo.
DJICameraPhotoBurstCount3
The camera burst shoot count is set to capture 3 pictures at once when the camera shoots a photo.
DJICameraPhotoBurstCount5
The camera burst shoot count is set to capture 5 pictures at once when the camera takes a photo.
DJICameraPhotoBurstCount7
The camera burst shoot count is set to capture 7 pictures at once when the camera takes a photo. It is not supported by Z30 camera.
DJICameraPhotoBurstCount10
The camera burst shoot count is set to capture 10 pictures at once when the camera takes a photo. Only supported by X4S camera, X5S camera and Phantom 4 Pro camera.
DJICameraPhotoBurstCount14
The camera burst shoot count is set to capture 14 pictures at once when the camera takes a photo. Only supported by X4S camera, X5S camera and Phantom 4 Pro camera.
DJICameraPhotoBurstCountContinuous
The camera burst shoot count is set to capture RAW pictures continuously until stopShootPhotoWithCompletion command is sent. It is only supported by Inspire 2 when the photo shoot mode is RAW burst.
File format for camera when it is in time-lapse mode. The default file format is video. If video+JPEG is selected the minimum interval will be 2 seconds.
Enum Members:
DJICameraPhotoTimeLapseFileFormatVideo
The camera in time-lapse mode will generate video.
DJICameraPhotoTimeLapseFileFormatJPEGAndVideo
The camera in time-lapse mode will generate video and JPEG.
Sets the number of pictures, and sets the time interval between pictures for the Interval shoot photo mode.
Struct Members:
uint8_t captureCount
The number of photos to capture. The value range is [2, 255]. If 255 is selected, then the camera will continue to take pictures until stopShootPhotoWithCompletion is called. For thermal imaging camera and Z30 camera, it can only be set to 255.
uint16_t timeIntervalInSeconds
The time interval between when two photos are taken. The range for this parameter depends the photo file format(DJICameraPhotoFileFormat). For XT camera, the range is [1, 60] seconds. For all other products, when the file format is JPEG, the range is [2, 2^16 - 1] seconds; when the file format is RAW or RAW+JPEG, the range is [10, 2^16 - 1] seconds.
Camera will shoot 3 rows of 3 photos. Each photo in a row will be taken with a different aircraft heading. Each row of photos is taken with a different gimbal pitch.
DJICameraPhotoPanoramaMode3x1
Camera will shoot 3 photos with the same aircraft heading and different gimbal pitch.
DJICameraPhotoPanoramaModeSphere
Camera will shoot 8 rows of 3 photos and 1 extra photo (facing downward). Each photo in a row will be taken with a different aircraft heading. Each row of photos is taken with a different gimbal pitch.
DJICameraPhotoPanoramaMode180
Camera will shoot 3 photos with the same gimbal pitch (facing forward) and different aircraft headings.
DJICameraPhotoPanoramaModeSuperResolution
The camera will capture and patch nine photos resulting in a 48-megapixel super resolution photo. It is supported by Spark, Mavic Air, Mavic 2, Mavic 2 Pro, Mavic 2 Zoom, Mavic 2 Eneterprise, Mavic 2 Enterprise Dual.
The camera's video resolution is 640x360. Supported by Mavic 2 Enterprise Dual thermal camera.
DJICameraVideoResolution640x480
The camera's video resolution is 640x480.
DJICameraVideoResolution640x512
The camera's video resolution is 640x512.
DJICameraVideoResolution1280x720
The camera's video resolution is 1280x720.
DJICameraVideoResolution1920x1080
The camera's video resolution is 1920x1080.
DJICameraVideoResolution2704x1520
The camera's video resolution is 2704x1520.
DJICameraVideoResolution2720x1530
The camera's video resolution is 2720x1530.
DJICameraVideoResolution3712x2088
The camera's video resolution is 3712x2088. It's only used by X7 camera.
DJICameraVideoResolution3840x1572
The camera's video resolution is 3840x1572.
DJICameraVideoResolution3840x2160
The camera's video resolution is 3840x2160.
DJICameraVideoResolution3944x2088
The camera's video resolution is 3944x2088. It's only used by X7 camera.
DJICameraVideoResolution4096x2160
The camera's video resolution is 4096x2160.
DJICameraVideoResolution4608x2160
The camera's video resolution is 4608x2160.
DJICameraVideoResolution4608x2592
The camera's video resolution is 4608x2592.
DJICameraVideoResolution5280x2160
The camera's video resolution is 5280x2160.
DJICameraVideoResolution5472x3078
The camera's video resolution is 5472x3078.
DJICameraVideoResolution5760x3240
The camera's video resolution is 5760x3240.
DJICameraVideoResolution6016x3200
The camera's video resolution is 6016x3200.
DJICameraVideoResolutionMax
The camera's video resolution will be maximum resolution supported by the camera sensor. For X5S and X4S, the maximum resolution is 5280x2972.
DJICameraVideoResolutionNoSSDVideo
The camera's SSD video resolution is unset. When the SSD resolution is unset, camera will not store video to SSD. SSD's resolution is determined by both license key and SD card's video frame rate. If there is no supported resolution with the current configuration, DJICameraVideoResolutionUnset will be selected and user should adjust either the license or the frame rate.
DJI camera's license keys. An Inspire 2 License Key activates the usage permission of CinemaDNG or Apple ProRes inside CineCore 2.0. License keys are obtained by by purchase from the DJI store website using the Inspire 2 serial number. The Inspire 2 is then connected to DJI Assistant 2, and the license keys downloaded to it. It is only supported X5S and X7 cameras.
The legacy camera color for videos that will be stored in SSD. The default value is DJICameraSSDLegacyColorNone. It is only supported Inspire 2 with firmware package versions lower than 01.0.0240.
Enum Members:
DJICameraSSDLegacyColorNone
The camera color is set to none. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDCinelike
The camera color is set to DCinelike. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDLog
The camera color is set to DLog. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDColor1
The camera color is set to DColor1. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDColor2
The camera color is set to DColor2. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDColor3
The camera color is set to DColor3. It is only supported by X5S on Inspire 2.
EI (exposure index) mode. In this mode, the camera mimics the way a film camera works to help cinematographers capture as much information as possible while balancing the dynamic range and noise with different log curves. This mode only takes effect when the camera mode is in DJICameraModeRecordVideo.
Communication to SSD is not stable. User can re-plugin SSD. It is supported by X5S.
DJICameraSSDOperationStateSwitchingLicense
SSD is switching the license key. It is supported by X5S.
DJICameraSSDOperationStateFormattingRequired
Formatting is required. It is supported by X5S.
DJICameraSSDOperationStateNotInitialized
Not initialized yet. It is supported by X7.
DJICameraSSDOperationStateInvalidFileSystem
The file system is not supported. It is supported by X7.
DJICameraSSDOperationStateUnknown
SSD state is unknown. This happens in the first 2 seconds after turning the camera power on as during this time the camera cannot check the state of the SSD.
Display modes to coordinate the video feeds from both the RGB sensor and single-band sensors. Only supported by multispectral camera of P4 Multispectral.
Enum Members:
DJICameraMultispectralDisplayModeRGB
Displays only the video feed from the RGB sensor.
DJICameraMultispectralDisplayModeNDVI
Displays the NVDI (normalized difference vegetation index) frames as video feed produced by the multispectral camera.
DJICameraMultispectralDisplayModeUnknown
The multispectral camera video feed display mode is unknown.
Enums represent the spectrum bands of a multispectral camera. For P4 Multispectral, the camera supports 5 bands. Only supported by multispectral camera of P4 Multispectral.
Different storage locations supported by the camera.
Enum Members:
DJICameraStorageLocationSDCard
SD card.
DJICameraStorageLocationInternalStorage
The internal storage embedded in the aircraft. When it is available, the camera can shoot photos or record videos without SD card. It is only supported by Mavic Air.
The enumeration represents which lens the camera stream comes from. The camera video stream will been used to transfer to image transmission to display and determine which lens were taken photo or recording. It is only supported by Zenmuse H20 Series Camera.
Enum Members:
DJICameraVideoStreamSourceDefault
The default video stream channel.
DJICameraVideoStreamSourceWide
Wide stream. Only supported by Zenmuse H20 Series and Mavic 2 Enterprise Advanced.
DJICameraVideoStreamSourceZoom
Zoom stream. Only supported by Zenmuse H20 Series and Mavic 2 Enterprise Advanced.
DJICameraVideoStreamSourceInfraredThermal
Infrared thermal stream. Only supported by Zenmuse H20T and H20N.and Mavic 2 Enterprise Advanced.
The different colors are used to show various temperatures in the thermal imagery image. The colors are not actually related to wavelengths of light, but rather the grayscale intensity.
Enum Members:
DJICameraThermalPaletteWhiteHot
Without Isotherm enabled, the Palette type is WhiteHot. With Isotherm enabled, the Palette type is WhiteHotIso.
DJICameraThermalPaletteBlackHot
Without Isotherm enabled, the Palette type is BlackHot. With Isotherm enabled, the Palette type is BlackHotIso.
DJICameraThermalPaletteRedHot
Without Isotherm enabled, the Palette type is RedHot. With Isotherm enabled, the Palette type is RedHotIso. Shown as Tint in DJI Pilot.
DJICameraThermalPaletteGreenHot
Without Isotherm enabled, the Palette type is GreenHot. With Isotherm enabled, the Palette type is GreenHotIso. Shown as Medical in DJI Pilot.
DJICameraThermalPaletteFusion
Without Isotherm enabled, the Palette type is Fusion. With Isotherm enabled, the Palette type is FusionIso.
DJICameraThermalPaletteRainbow
Without Isotherm enabled, the Palette type is Rainbow. With Isotherm enabled, the Palette type is RainbowIso. Shown as Rainbow1 in DJI Pilot.
DJICameraThermalPaletteIronbow1
Without Isotherm enabled, the Palette type is Ironbow1. With Isotherm enabled, the Palette type is IronbowWHIso. Shown as IronRed in DJI Pilot.
DJICameraThermalPaletteIronbow2
Without Isotherm enabled, the Palette type is Ironbow2. With Isotherm enabled, the Palette type is IronbowBHIso.
DJICameraThermalPaletteIceFire
Without Isotherm enabled, the Palette type is IceFire. With Isotherm enabled, the Palette type is IceFireIso. Shown as Arctic in DJI Pilot.
DJICameraThermalPaletteSepia
Without Isotherm enabled, the Palette type is Sepia. With Isotherm enabled, the Palette type is SepiaIso.
DJICameraThermalPaletteGlowbow
Without Isotherm enabled, the Palette type is Glowbow. With Isotherm enabled, the Palette type is GlowbowIso.
DJICameraThermalPaletteColor1
Without Isotherm enabled, the Palette type is Color1. With Isotherm enabled, the Palette type is MidRangeWHIso. Shown as Fulgurite in DJI Pilot.
DJICameraThermalPaletteColor2
Without Isotherm enabled, the Palette type is Color2. With Isotherm enabled, the Palette type is MidRangeBHIso. Shown as HotIron in DJI Pilot.
DJICameraThermalPaletteRain
Without Isotherm enabled, the Palette type is Rain. With Isotherm enabled, the Palette type is RainbowHCIso. Shown as Rainbow2 in DJI Pilot.
DJICameraThermalPaletteHotSpot
Without Isotherm enabled, the Palette type is HotSpot. With Isotherm enabled, the Palette type is HotSpotIso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteRainbow2
Without Isotherm enabled, the Palette type is Rainbow2. With Isotherm enabled, the Palette type is Rainbow2Iso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteGray
Without Isotherm enabled, the Palette type is Gray. With Isotherm enabled, the Palette type is GrayIso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteHotMetal
Without Isotherm enabled, the Palette type is HotMetal. With Isotherm enabled, the Palette type is HotMetalIso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteColdSpot
Without Isotherm enabled, the Palette type is ColdSpot. With Isotherm enabled, the Palette type is ColdSpotIso. Only supported by Mavic 2 Enterprise Dual.
Enable temperature measurement and set mode to area metering. Use camera:didUpdateAreaTemperatureAggregations to receive the updated temperature data. Only supported by the advanced radiometry version XT camera.
DJICameraThermalMeasurementModeUnknown
Thermal camera's temperature measurement mode is unknown.
Thermal cameras measure the apparent surface temperature of a given object. This is done by taking the amount of infrared radiation an object emits and calculating the surface temperature by applying a formula that adjusts for external factors. This struct includes all of the external scene parameters that the thermal camera firmware allows to be customized. There are two types of parameters, optical parameters which specify how much infrared radiation is transmitted from the surface to the thermal sensor, as well as parameters that specify sources of thermal radiance other than the object. For a more in-depth overview of the physics behind thermal imaging, see https://en.wikipedia.org/wiki/Thermography.
Struct Members:
float atmosphericTemperature
Atmospheric temperature, can be between -50 and 327.67 degrees Celsius.
float atmosphericTransmissionCoefficient
Transmission coefficient of the atmosphere between the scene and the camera, can be between 50 and 100.
float backgroundTemperature
Background temperature (reflected by the scene), can be between -50 and 327.67 degrees Celsius.
float sceneEmissivity
Emissivity of the scene, can be between 50 and 100.
float windowReflection
Window reflection, can be between 50 and 100-X where X is the window transmission coefficient parameter.
float windowReflectedTemperature
Temperature reflected in the window, can be between -50 and 327.67 degrees Celsius.
float windowTemperature
Window temperature, can be between -50 and 327.67 degrees Celsius.
float windowTransmissionCoefficient
Transmission coefficient of the window, can be between 50 and 100-X where X is the window reflection.