Common Elements

2025-03-11
No Rating

Information Introduction

The fields of DJI WPML are introduced as follows:

Common Element

<wpml:droneInfo>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:droneEnumValuedrone typeint-For the drone type enumeration value, please refer to the type in the Enumeration Values of Aircraft, RC and Dock in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:droneSubEnumValuedrone sub typeint-For the drone sub type enumeration value, please refer to the sub_type in the Enumeration Values of Aircraft, RC and Dock in the Product Supportopen in new window page.Note: This element is required when droneEnumValue is 67(M30/M30T).M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:payloadInfo>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadEnumValuepayload typeint-For the payload type enumeration value, please refer to the type field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window pageYesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:payloadParam>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexpayload position indexint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:focusModepayload focus modeenum_string-firstPoint: Auto-focus on the first waypoint
custom: Focus using calibrated focus value
-M300 RTK, M350 RTK
wpml:meteringModepayload metering modeenum_string-average: Global metering
spot: Spot metering
-M300 RTK, M350 RTK
wpml:dewarpingEnabledewarping enablebool-0: Disabled
1: Enabled
-M300 RTK, M350 RTK
wpml:returnModeLiDAR return modeenum_string-singleReturnStrongest: Single return
dualReturn: Dual return
tripleReturn: Triple return
-M300 RTK, M350 RTK
wpml:samplingRatesampling rateintHz60000,
80000,
120000,
160000,
180000,
240000
-M300 RTK, M350 RTK
wpml:scanningModescanning modeenum_string-repetitive: Repetitive scanning
nonRepetitive: Non-repetitive scanning
-M300 RTK, M350 RTK
wpml:modelColoringEnablemodel coloring enablebool0: No coloring
1: True color coloring
-M300 RTK, M350 RTK
wpml:imageFormatimage format listenum_stringwide: Stores wide-angle lens photos
zoom: Stores zoom lens photos
ir: Stores infrared lens photos
narrow_band: Stores narrow-band lens photos
visible: Visible light photos
* Note: To store photos from multiple lenses, format as "<wpml:imageFormat>wide,ir</wpml:imageFormat>"
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:waypointHeadingParam> & <wpml:globalWaypointHeadingParam>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:waypointHeadingModeHeading modeenum-followWayline:Along course direction. The nose of the aircraft follows the course direction to the next waypoint.
manually: The user can manually control the nose orientation of the aircraft during the flight to the next waypoint.
fixed: The nose of the aircraft maintains the yaw angle of the aircraft to the next waypoint after the waypoint action has been performed.
smoothTransition: Customized. The target yaw angle for a waypoint is given by "wpml:waypointHeadingAngle" and transitions evenly to the target yaw angle of the next waypoint during the flight segment.
towardPOI: The aircraft heading faces the point of interest.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:waypointHeadingAngleYaw Angle of aircraftfloat°[-180, 180]
The target yaw angle for a given waypoint and a uniform transition to the target yaw angle for the next waypoint over the course of the flight segment.
Yes
Note: Required if "wpml:waypointHeadingMode" is "smoothTransition".
M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:waypointPoiPointPoint of interest--Data format: Latitude, Longitude, Altitude
Note: This field is only effective when wpml:waypointHeadingMode is set to towardPOI. Currently, the Z-direction orientation towards the point of interest is not supported, so the altitude can be set to 0.
When the wpml:waypointHeadingMode for a specific waypoint is set to towardPOI, the aircraft's heading will face the point of interest while flying from that waypoint to the next waypoint.
Yes
Note: Required if "wpml:waypointHeadingMode" is "towardPOI".
M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:waypointHeadingPathModeDirection of rotation of the aircraft yaw angleenum-clockwise
counterClockwise
followBadArc: Rotation of the aircraft yaw angle along the shortest path.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:waypointTurnParam>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:waypointTurnModewaypoint turn modeenum-coordinateTurn: Coordinated turns, no dips, early turns.
toPointAndStopWithDiscontinuityCurvature: Fly in a straight line and the aircraft stops at the point.
toPointAndStopWithContinuityCurvature: Fly in a curve and the aircraft stops at the point.
toPointAndPassWithContinuityCurvature: Fly in a curve and the aircraft will not stop at the point.
Note: The setting method of "Turns before waypoint. Flies through." mode in DJI Pilot2/FlightHub 2 is
1) Set the "wpml:waypointTurnMode" to "toPointAndPassWithContinuityCurvature".
2) Set the "wpml:useStraightLine" to 1.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:waypointTurnDampingDistwaypoint turn damping distancefloatm(0, the maximum length of wayline segment]
* Note: The wayline segment between two waypoints should be greater than the sum of the turn intercepts of two waypoints. This element defines how far to the waypoint that the aircraft should turn.
Yes
Required if "wpml:waypointTurnMode" is "coordinateTurn", "wpml:waypointTurnMode" is "toPointAndPassWithContinuityCurvature" and "wpml:useStraightLine" is 1
M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:autoRerouteInfo>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:missionAutoRerouteModemission auto reroute modebool-0: Disable 1: EnableYesM3D/M3TD, M4E/M4T
wpml:transitionalAutoRerouteModetransitional auto reroute modebool-0: Disable 1: EnableYesM3D/M3TD, M4E/M4T

<wpml:actionGroup>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:actionGroupIdaction group Id
Note: The ID is unique within a kmz file. It is recommended that it be monotonically and continuously incremented from 0.
int-[0, 65535]YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionGroupStartIndexWaypoints where the action group starts to take effect.int-[0, 65535]YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionGroupEndIndexWaypoints where the action group stops to take effect.
* Note: When the actionGroupStartIndex is the same as the actionGroupEndIndex, it means that the action group is only valid at that waypoint.
int-[0, 65535]
Note: This element must be larger than or equal to "actionGroupStartIndex".
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionGroupModeaction group modeenum-sequence: This means that the actions within the action group are executed sequentially.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionTriggeraction trigger----M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionaction list----M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:actionTrigger>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:actionTriggerTypetrigger typeenum-reachPoint: Executed on arrival at the waypoint.
betweenAdjacentPoints: Flight routine segment trigger. Rotate the gimbal evenly.
multipleTiming: Same time trigger.
multipleDistance: Same distance trigger.
* Note: “betweenAdjacentPoints” should be used with "gimbalEvenlyRotate". "multipleTiming" combining with "takePhoto" can achieve equal-time interval capture. "multipleDistance" combining with "takePhoto" can achieve equal-distance interval capture.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionTriggerParamtrigger paramfloats or m> 0
Note:When "actionTriggerType" is "multipleTiming", this element indicates the interval time in s. When "actionTriggerType" is "multipleDistance", this element indicates the interval distance in m.
-M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:action>

ElementNameTypeunitValueIs it required (default)Product Support
wpml:actionIdaction id
Note:The ID is unique within an action group. It is recommended that it be monotonically and continuously incremented from 0.
int-[0, 65535]YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionActuatorFuncaction typeenum-takePhoto
startRecord
stopRecord
focus
zoom
customDirName: Create new folder.
gimbalRotate: Gimbal rotation.
rotateYaw: Drone rotates around the yaw axis.
hover: Hover and wait.
gimbalEvenlyRotate: Rotate the gimbal pitch angle evenly during the wayline segment.
accurateShoot: AI Spot-Check action.(Maintenance stop. orientedShoot is recommended.)
orientedShoot: Take Photo (Fixed Angle) action.
panoShot: Panorama action (Supported by M30/30T, M3D/M3TD, M4E/M4T)
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:actionActuatorFuncParamaction param----M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

<wpml:actionActuatorFuncParam>

takePhoto

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:fileSuffixThe file suffixstring-This suffix is appended to the name of the generated media file.YesM300 RTK and M350 RTK(H20/H20T/H20N/H30/H30T), M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:payloadLensIndexStorage type of photoList of photo formatenum-string (list)zoom: Storing the photo taken with zoom lens
wide: Storing the photo taken with wide lens
ir: Storing the photo taken with infrared lens
narrow_band: Storing the photo taken with narrow-band lens
visable: Visible Photos
* Note: Storing photos taken by multi-lens, the format is like,"<wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>". It means wide lens, infrared lens, and wide-band lens are used.*
YesM30/M30T, M3D/M3TD, M4E/M4T
wpml:useGlobalPayloadLensIndexWhether use the global storage typebool-0: not use the global set
1: use the global set
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

startRecord

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:fileSuffixThe file suffixstring-This suffix is appended to the name of the generated media file.YesM300 RTK and M350 RTK (H20/H20T/H20N/H30/H30T), M30/M30T, M3E/M3T/M3M
wpml:payloadLensIndexStorage type of videoList of video formatenum-string(list)zoom: Storing the video taken with zoom lens
wide: Storing the video taken with wide lens
ir: Storing the video taken with infrared lens
narrow_band: Storing the video taken with narrow-band lens
* Note: Storing videos taken by multi-lens, the format is like "<wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>". It means wide lens, infrared lens, and wide-band lens are used.*
YesM30/M30T, M3D/M3TD, M4E/M4T
wpml:useGlobalPayloadLensIndexWhether use the global storage typebool-0: not use the global set
1: use the global set
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

stopRecord

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:payloadLensIndexStorage type of videoList of video formatenum-string(list)zoom: Storing the video taken with zoom lens
wide: Storing the video taken with wide lens
ir: Storing the video taken with infrared lens
narrow_band: Storing the video taken with narrow-band lens
* Note: Storing videos taken by multi-lens, the format is like "<wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>". It means wide lens, infrared lens, and wide-band lens are used.*
YesM30/M30T

focus

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:isPointFocusWhether to focusbool-0: Area Focusing. 1: Point FocusingYesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:focusXFocal positionfloat-[0, 1]
Note: The upper left corner of the focus point or focus area is at the X-axis (width) coordinates of the screen. 0 is the leftmost and 1 is the rightmost.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:focusYFocal positionfloat-[0, 1]
Note: The upper left corner of the focus point or focus area is at the X-axis (width) coordinates of the screen. 0 is the leftmost and 1 is the rightmost.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:focusRegionWidthFocusing region width ratiofloat-[0, 1]
Note: The size of the focus area as a proportion of the overall picture, this is the width ratio.
Yes
Note: Required if "isPointFocus" is "0" (area focus).
M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:focusRegionHeightFocusing region height ratiofloat-[0, 1]
Note: The size of the focus area as a proportion of the overall picture, this is the height ratio.
Yes
Note: Required if "isPointFocus" is "0" (area focus).
M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:isInfiniteFocusWhether infinite focusbool-0: Not infinite focus 1: infinite focusYesM3E/M3T/M3M, M3D/M3TD, M4E/M4T

zoom

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:focalLengthfocal lengthfloatmm> 0YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

customDirName

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:directoryNameThe name of the new folderstring--YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

gimbalRotate

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalHeadingYawBasegimbal yaw angle rotation coordinate systemenum-north: Relative geographic north.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalRotateModegimbal rotation modeenum-absoluteAngle:The angle relative to the North.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalPitchRotateEnableWhether to enable pitch rotation of the gimbal.bool-0: disable
1: enable
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalPitchRotateAnglePitch rotation anglefloat-Note: Different gimbals can be turned in different ranges.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalRollRotateEnableWhether to enable roll rotation of the gimbal.bool-0: disable
1: enable
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalRollRotateAngleroll rotation anglefloat-Note: Different gimbals can be turned in different ranges.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalYawRotateEnableWhether to enable yaw rotation of the gimbal.bool-0: disable
1: enable
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalYawRotateAngleyaw rotation anglefloat-Note: Different gimbals can be turned in different ranges.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalRotateTimeEnableWhether to turn on the gimbal rotation timebool-0: disable
1: enable
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:gimbalRotateTimeTime to complete rotation of the gimbal.floats-YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

gimbalEvenlyRotate

ElementNameTypeunitValueIs it required (default)Product Support
wpml:gimbalPitchRotateAnglePitch rotation anglefloat-Note: Different gimbals can be turned in different ranges.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

Note: "gimbalEvenlyRotate" rotates the pitch angle of gimbal evenly during the segments of the flight route. The trigger must be "betweenAdjacentPoints".

rotateYaw

ElementNameTypeunitValueIs it required (default)Product Support
wpml:aircraftHeadingDrone target yaw angle (relative to geographic north)float°[-180, 180]
0° is due north. 90° is due east. -90° is due west. -180°/180° is due south.
YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T
wpml:aircraftPathModeYaw rotation mode of droneenum-clockwise
counterClockwise
YesM300 RTK, M350 RTK

hover

ElementNameTypeunitValueIs it required (default)Product Support
wpml:hoverTimehover timefloats> 0YesM300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T

accurateShoot

Note: For M30/M30T models, the drone firmware version after V06.01.10.02 is no longer maintained and upgrades the accurateShoot. orientedShoot is recommended.

ElementNameTypeunitValueIs it required (default)Product Support
wpml:gimbalPitchRotateAnglePitch rotation anglefloat°[-120, 45]YesM300 RTK, M350 RTK, M30/M30T
wpml:gimbalYawRotateAngleyaw rotation anglefloat°[-180, 180]YesM300 RTK, M350 RTK, M30/M30T
wpml:focusXHorizontal coordinate of the target region centerintpx(0, 960)
Note: The upper left corner of the picture is the coordinate origin. Horizontal direction is the x-axis. Vertical direction is the y-axis.
YesM300 RTK, M350 RTK, M30/M30T
wpml:focusYVertical coordinate of the target region centerintpx(0, 720)
Note: The upper left corner of the picture is the coordinate origin. Horizontal direction is the x-axis. Vertical direction is the y-axis.
YesM300 RTK, M350 RTK, M30/M30T
wpml:focusRegionWidthFocusing region width ratiointpx(0, 960)YesM300 RTK, M350 RTK, M30/M30T
wpml:focusRegionHeightFocusing region height ratiointpx(0, 720)YesM300 RTK, M350 RTK, M30/M30T
wpml:focalLengthFocal lengthfloatmm> 0YesM300 RTK, M350 RTK, M30/M30T
wpml:aircraftHeadingYaw angle of drone target (relative to the true north)float°[-180, 180]
Note: Drone will rotate to this target yaw angle. 0° is true north. 90° is true east. -90° is true west. -180°/180° is true south.
YesM300 RTK, M350 RTK, M30/M30T
wpml:accurateFrameValidWhether select the target of AI Spot-Checkbool-1: Selected
0: Not selected
Note: This value sets to 1. Then the drone will automatically find the target and capture photos. This value sets to 0. Then the drone will repeat action according to the drone attitude and payload attitude. It will not automatically find the target.
YesM300 RTK, M350 RTK, M30/M30T
wpml:payloadPositionIndexPayload mounting locationint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK, M30/M30T
wpml:payloadLensIndexImage capturing storage type-enum-stringzoom: Store the image shot by the zoom camera
wide: Store the image shot by the wide camera
ir: Store the image shot by the infrared camera
*Note: Storing the image from more than one camera needs to use the format like “<wpml:payloadLensIndex>wide,ir</wpml:payloadLensIndex>”. It means storing images of wide and infrared cameras.
YesM300 RTK, M350 RTK, M30/M30T
wpml:useGlobalPayloadLensIndexWhether use the global storage typebool-0: Not used
1: Used
YesM300 RTK, M350 RTK, M30/M30T
wpml:targetAngleAngle of target boxfloat°[0, 360]
Note: The rotation angle. (Based on the y-axis and rotate clockwise.)
YesM300 RTK, M350 RTK, M30/M30T
wpml:imageWidthWidth of pictureintpx960YesM300 RTK, M350 RTK, M30/M30T
wpml:imageHeightHeight of pictureintpx720YesM300 RTK, M350 RTK, M30/M30T
wpml:AFPosAF motor locationint--YesM300 RTK, M350 RTK, M30/M30T
wpml:gimbalPortGimbal port numberint-Capturing camera installation position
Note: This value of M30/M30T models are 0.
YesM300 RTK, M350 RTK, M30/M30T
wpml:accurateCameraTypeCamera typeint-52 (Model: M30 dual light camera),
53 (Model: M30T tripple light camera),
42 (Model: H20),
43 (Model: H20T),
82 (Model: H30),
83 (Model: H30T)
YesM300 RTK, M350 RTK, M30/M30T
wpml:accurateFilePathFile path of picturestring--YesM300 RTK, M350 RTK, M30/M30T
wpml:accurateFileMD5File MD5 of picturestring--YesM300 RTK, M350 RTK, M30/M30T
wpml:accurateFileSizeFile size of pictureintByteReal image file sizeYesM300 RTK, M350 RTK, M30/M30T
wpml:accurateFileSuffixFile suffix of picturestring-File suffix is added when the generated media files are named.YesM300 RTK, M350 RTK, M30/M30T
wpml:accurateCameraApertueAperture sizeint-Note: This value is the real aperture x 100YesM30/M30T
wpml:accurateCameraLuminanceEnvironment luminanceint--YesM30/M30T
wpml:accurateCameraShutterTimeShutter timefloatsecond-YesM30/M30T
wpml:accurateCameraISOISOint--YesM30/M30T

orientedShoot

ElementNameTypeunitValueIs it required (default)Product Support
wpml:gimbalPitchRotateAnglePitch rotation anglefloat°M30/M30T: [-120, 45]
M3E/M3T: [-90, 35]
M3D/M3TD, M4E/M4T: [-90, 30]
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:gimbalYawRotateAngleyaw rotation anglefloat°[-180, 180]
*Note: For M3E/M3T and M3D/M3TD, M4E/M4T, wpml:gimbalYawRotateAngle should align with wpml:aircraftHeading
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:focusXHorizontal coordinate of the target region centerintpx(0, 960)
*Note: The upper left corner of the image is the coordinate origin. The horizontal direction is the x-axis. The vertical direction is the y-axis.
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:focusYVertical coordinate of the target region centerintpx(0, 720)
Note: The upper left corner of the image is the coordinate origin. The horizontal direction is the x-axis. The vertical direction is the y-axis.
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:focusRegionWidthWidth of the target widthintpx(0, 960)YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:focusRegionHeightHeight of the target regionintpx(0, 720)YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:focalLengthZoom focal lengthfloatmm> 0YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:aircraftHeadingYaw angle of drone target (relative to the true north)float°[-180, 180]
Note: Drone will rotate to this target yaw angle. 0° is true north. 90° is true east. -90° is true west. -180°/180° is true south.
Note: For M3E/M3T and M3D/M3TD, M4E/M4T, wpml:gimbalYawRotateAngle should align with wpml:aircraftHeading
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:accurateFrameValidWhether select the target of AI Spot-Checkbool-1: Selected
0: Not selected
*Note: This value sets to 1. Then the drone will automatically find the target and capture photos. This value sets to 0. Then the drone will repeat action according to the drone attitude and payload attitude. It will not automatically find the target.
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:payloadPositionIndexThe position where the payload is mountedint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:payloadLensIndexImage capturing storage type-enum-stringzoom: Store the image shot by the zoom camera
wide: Store the image shot by the wide camera
ir: Store the image shot by the infrared camera
*Note: Storing the image from more than one camera needs to use the format like “<wpml:payloadLensIndex>wide,ir</wpml:payloadLensIndex>”. It means storing images of wide and infrared cameras.
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:useGlobalPayloadLensIndexWhether use the global storage typebool-0: not ues
1: use
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:targetAngleAngle of target boxfloat°[0, 360]
Note: The rotation angle. (Based on the y-axis and rotate clockwise.)
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:actionUUIDAction UUID--Note: This value will be written to the image file during the capturing to associate the action and image file.YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:imageWidthImage widthintpx960YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:imageHeightImage heightintpx720YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:AFPosAF motor locationint--YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:gimbalPortGimbal port numberint-Capturing camera installation position
Note: This value of M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T models are 0.
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedCameraTypeCamera typeint-52 (Model: M30 dual light camera),
53 (Model: M30T tripple light camera)
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedFilePathImage file pathstring--YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedFileMD5Image file MD5string--YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedFileSizeImage file sizeintByteReal image file sizeYesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedFileSuffixImage file suffixstring-File suffix is added when the generated media files are named.YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedCameraApertueAperture sizeint-Note: This value is the real aperture x 100YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedCameraLuminanceEnvironment luminanceint--YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedCameraShutterTimeShutter timefloatsecond-YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedCameraISOISOint--YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T
wpml:orientedPhotoModeCapturing modeenum-string-normalPhoto: normal capturing
lowLightSmartShooting: Smart Low-Light
YesM30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T

panoShot

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexPayload mounting locationint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM30/M30T
wpml:payloadLensIndexStorage type of photoList of photo formatenum-string (list)zoom: Storing the photo taken with zoom lens
wide: Storing the photo taken with wide lens
ir: Storing the photo taken with infrared lens
narrow_band: Storing the photo taken with narrow-band lens
visable: Visible Photos
* Note: Storing photos taken by multi-lens, the format is like,"<wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>". It means wide lens, infrared lens, and wide-band lens are used.*
YesM30/M30T
wpml:useGlobalPayloadLensIndexWhether use the global storage typebool-0: not ues
1: use
YesM30/M30T, M3E/M3T
wpml:panoShotSubModePanorama photo modestring-panoShot_360: Panorama modeYesM30/M30T, M3D/M3TD, M4E/M4T

recordPointCloud

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexPayload mounting locationint-For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Supportopen in new window page.YesM300 RTK, M350 RTK
wpml:recordPointCloudOperatePoint Cloud Operationstring-startRecord: Start the point cloud recording.
pauseRecord: Pause the point cloud recording.
resumeRecord: Continue the point cloud recording.
stopRecord: Stop the point cloud recording.
YesM300 RTK, M350 RTK

megaphone

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexPayload mounting locationint-0: Mount position of 1. The M300 RTK and M350 RTK models correspond to the front left of the drone. Other models correspond to the main gimbal.
1: Mount position of 2. The M300 RTK and M350 RTK models correspond to the front right of the drone.
2: Mount position of 3. The M300 RTK and M350 RTK models correspond to the top of the drone.
YesM4D/M4TD
wpml:actionUUIDAction UUIDstring--YesM4D/M4TD
wpml:megaphoneOperateTypeMegaphone Operation Switchint-0: Start speaking
1: Stop speaking

YesM4D/M4TD
wpml:megaphoneOperateVolumeMegaphone Operation Volumeint-Volume level, range: 0-100YesM4D/M4TD
wpml:megaphoneOperateLoop是Single Track Loop Playbackbool-0: Off
1: On
YesM4D/M4TD
wpml:megaphoneOperateFilePathPath of the Megaphone Audio File in KMZstring-Path of the audio file in KMZ, e.g., /wpmz/res/audio/71b4cf0504a7b899.opusYesM4D/M4TD
wpml:megaphoneFileNameName of the Megaphone Audio Filestring-Name of the audio file in KMZ, e.g., 71b4cf0504a7b899.opusYesM4D/M4TD
wpml:megaphoneFileOriginalNameDisplay Name of the Megaphone Audio File During Playbackstring-Name returned by the megaphone during playback, e.g., Megaphone Audio.mp3YesM4D/M4TD
wpml:megaphoneFileMd5MD5 Value of the Megaphone Audio Filestring-MD5 value of the megaphone audio fileYesM4D/M4TD
wpml:megaphoneFileBitrateCompression Bitrate of the Megaphone Audio Fileint-1: Bitrate 8000
2: Bitrate 16000
3: Bitrate 24000
4: Bitrate 32000
5: Bitrate 48000
6: Bitrate 64000

Note: Currently only supports 4, bitrate 32000
YesM4D/M4TD

searchlight

ElementNameTypeunitValueIs it required (default)Product Support
wpml:payloadPositionIndexPayload mounting locationint-0: Mount position of 1. The M300 RTK and M350 RTK models correspond to the front left of the drone. Other models correspond to the main gimbal.
1: Mount position of 2. The M300 RTK and M350 RTK models correspond to the front right of the drone.
2: Mount position of 3. The M300 RTK and M350 RTK models correspond to the top of the drone.
YesM4D/M4TD
wpml:actionUUIDAction UUIDstring--NoM4D/M4TD
wpml:searchlightOperateTypeSearchlight Operation Typeint-0: Illumination
1: Flash
2: Turn off
YesM4D/M4TD
wpml:searchlightBrightnessBrightnessint-Brightness level, range 0-100YesM4D/M4TD
If you have any comments or confusion about our documentation, you can click here to give feedback and we will get back to you as soon as possible.