Common Element Information
Information Description
- The field descriptions for the WPML flight path file are as follows:
- Fields used only in the
template.kmlfile can be found in template.kml Description - Fields used only in the
waylines.wpmlfile can be found in waylines.wpml Description - Fields shared between
template.kmlandwaylines.wpmlcan be found in Common Element Information
- Fields used only in the
Shared Elements
<wpml:droneInfo>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:droneEnumValue | Drone Main Model | Integer | - | 11000 (Models: M4T/M4N) | Required element | M4T/M4N |
| wpml:droneSubEnumValue | Drone Sub Model | Integer | - | When the "Drone Main Model" is "11000 (Models: M4T/M4N)": 0 (Model: M4T Dual Light), 1 (Model: M4N Triple Light) | Required element * Note: This element is required only when the "Drone Main Model" has a valid value. | M4T/M4N |
<wpml:payloadInfo>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadEnumValue | Payload Main Model | Integer | - | 705 (XL705 Gimbal), 715 (XL715 Gimbal), 720 (XL720 Gimbal), 801 (XL801 Gimbal), 802 (XL802 Gimbal), 805 (XL805 Gimbal), 806 (XL806 Gimbal) | Required element | M4T/M4N |
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone Position 1. Corresponds to the main gimbal. 1: Drone Position 2. 2: Drone Position 3. | Required element | M4T/M4N |
<wpml:payloadParam>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone position 1. Corresponds to the main gimbal. 1: Drone position 2. 2: Drone position 3. | Required element | M4T/M4N |
| wpml:focusMode | Focus Mode | Enum-string | - | firstPoint: Auto-focus on the first waypoint custom: Calibrated focus value | - | - |
| wpml:meteringMode | Metering Mode | Enum-string | - | average: Global metering spot: Spot metering | - | - |
| wpml:dewarpingEnable | Enable Distortion Correction | Boolean | - | 0: Disabled 1: Enabled | - | - |
| wpml:returnMode | Lidar Return Mode | Enum-string | - | singleReturnStrongest: Single return dualReturn: Dual return tripleReturn: Triple return | - | - |
| wpml:samplingRate | Sampling Rate | Integer | Hz | 60000, 80000, 120000, 160000, 180000, 240000 | - | - |
| wpml:scanningMode | Scanning Mode | Enum-string | - | repetitive: Repetitive scanning nonRepetitive: Non-repetitive scanning | - | - |
| wpml:modelColoringEnable | True-Color Coloring | Boolean | 0: Not colored 1: True-color coloring | - | - | |
| wpml:imageFormat | Image Format List | Enum-string (List) | wide: Save wide-angle lens photos zoom: Save zoom lens photos ir: Save infrared lens photos narrow_band: Save narrow-band lens photos visible: Visible light photos * Note: To save multiple lens photos, format as " <wpml:imageFormat>wide,ir</wpml:imageFormat>" | Required element | M4T/M4N |
<wpml:waypointHeadingParam> & <wpml:globalWaypointHeadingParam>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:waypointHeadingMode | Drone Yaw Mode | Enum-string | - | followWayline: The drone's nose follows the flight path direction. manually: Manual control. The user can manually adjust the drone's nose direction while moving to the next waypoint. fixed: Locks the current yaw angle. The drone's nose remains fixed after completing the waypoint action while moving to the next waypoint. smoothTransition: Custom yaw mode. The yaw angle is given by "wpml" and smoothly transitions during the segment flight to the next waypoint. towardPOI: Points toward a point of interest (POI) | Required element | M4T/M4N |
| wpml:waypointHeadingAngle | Drone Yaw Angle | Integer | - | Specifies the target yaw angle at a given waypoint and smoothly transitions during the flight segment to the next waypoint. | Required element * Note: Only required when "wpml" is set to "smoothTransition". | M4T/M4N |
| wpml:waypointPoiPoint | Point of Interest (POI) | - | - | Data format: Latitude, Longitude, Altitude Note: This field is valid only when "wpml" is set to "towardPOI". Z-axis (altitude) targeting is not supported; height can be set to 0. After setting a waypoint's "wpml | Required only when "wpml" is set to "towardPOI". | M4T/M4N |
| wpml:waypointHeadingPathMode | Drone Yaw Rotation Mode | Enum-string | - | clockwise: Rotate the drone's yaw angle clockwise. counterClockwise: Rotate the drone's yaw angle counterclockwise. followBadArc: Rotate the drone's yaw along the shortest path. | Required element | M4T/M4N |
<wpml:waypointTurnParam>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:waypointTurnMode | Waypoint Type (Turn Mode) | Enum - string | - | coordinateTurn: Coordinated turn, bypassing the point and turning in advance.toPointAndStopWithDiscontinuityCurvature: Linear flight, drone stops at the point.toPointAndStopWithContinuityCurvature: Curved flight, drone stops at the point.toPointAndPassWithContinuityCurvature: Curved flight, drone passes the point without stopping. | Required element | M4T/M4N |
| wpml:waypointTurnDampingDist | Waypoint Turn Damping Distance | Float | m | (0, Segment maximum length] * Note: The length of the segment between two waypoints must be greater than the sum of the turn damping distances of both waypoints. This element defines how many meters before the waypoint the drone will start turning. | Required element * Note: This element is required only when “wpml” is set to “1”. | M4T/M4N |
<wpml:autoRerouteInfo>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:missionAutoRerouteMode | Mission Route Reroute Mode | Boolean | - | 0: Disabled, 1: Enabled | Required element | - |
| wpml:transitionalAutoRerouteMode | Transition Route Reroute Mode | Boolean | - | 0: Disabled, 1: Enabled | Required element | - |
<wpml:actionGroup>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:actionGroupId | Action Group ID * Note: Unique within a kmz file. Suggested to start from 0 and increment sequentially. | Integer | - | [0, 65535] | Required element | M4T/M4N |
| wpml:actionGroupStartIndex | Waypoint at which the action group becomes active | Integer | - | [0, 65535] | Required element | M4T/M4N |
| wpml:actionGroupEndIndex | Waypoint at which the action group stops being active * Note: If "actionGroupEndIndex" equals "actionGroupStartIndex," the action group only applies to that waypoint. | Integer | - | [0, 65535] * Note: This element must be greater than or equal to "actionGroupStartIndex."。 | Required element | M4T/M4N |
| wpml:actionGroupMode | Action Execution Mode | Enum - string | - | sequence: Actions are executed sequentially, in the order they appear in the action group. | Required element | M4T/M4N |
| wpml:actionTrigger | Action Group Trigger | - | - | - | - | M4T/M4N |
| wpml:action | Action List | - | - | - | - | M4T/M4N |
<wpml:actionTrigger>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:actionTriggerType | Action Trigger Type | Enum-string | - | reachPoint: Triggered upon reaching a waypoint. betweenAdjacentPoints: Triggered during the flight segment between two waypoints, evenly rotating the gimbal. multipleTiming: Triggered at equal time intervals. multipleDistance: Triggered at equal distance intervals. * Note: "betweenAdjacentPoints" must be used with the action "gimbalEvenlyRotate". | Required element | M4T/M4N |
| wpml:actionTriggerParam | Action Trigger Parameter | Float | s or m | > 0 * Note: When "actionTriggerType" is "multipleTiming," this element represents the time interval in seconds. When "actionTriggerType" is "multipleDistance," this element represents the distance interval in meters. | - | M4T/M4N |
<wpml:action>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:actionId | Action ID * Note: Unique within an action group. Suggested to start from 0 and increment sequentially. | Integer | - | [0, 65535] | Required element | M4T/M4N |
| wpml:actionActuatorFunc | Action Type | Enum-string | - | takePhoto: Take a single photo startRecord: Start video recording stopRecord: Stop video recording focus: Focus zoom: Zoom customDirName: Create a new folder gimbalRotate: Rotate the gimbal rotateYaw: Rotate the drone's yaw hover: Hover gimbalEvenlyRotate: Evenly rotate the gimbal pitch between waypoints accurateShoot: Precision reshoot action (no longer supported, recommended to use "orientedShoot") orientedShoot: Precision reshoot action | Required element | M4T/M4N |
| wpml:actionActuatorFuncParam | Action Parameters | - | - | - | - | M4T/M4N |
<wpml:actionActuatorFuncParam>
takePhoto
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone mounting position 1. Corresponds to the main gimbal. 1: Drone mounting position 2. 2: Drone mounting position 3. | Required element | M4T/M4N |
| wpml:fileSuffix | Photo File Suffix | String | - | A suffix added to the media file name during generation. | Required element | M4T/M4N |
| wpml:payloadLensIndex | Photo Storage Type | Image format list | Enum-string (list) | zoom: Store zoom lens photos wide: Store wide-angle lens photos ir: Store infrared lens photos narrow_band: Store narrow-band lens photos visable: Visible-light photos night: Night vision photos * Note: To store multiple lens photos, the format is like " <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>", indicating the storage of wide, infrared, and narrow-band lens photos | Required element | M4T/M4N |
| wpml:useGlobalPayloadLensIndex | Use Global Storage Type | Boolean | - | 0: Do not use global settings 1: Use global settings | Required element | M4T/M4N |
startRecord
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone mounting position 1. Corresponds to the main gimbal. 1: Drone mounting position 2. 2: Drone mounting position 3. | Required element | M4T/M4N |
| wpml:fileSuffix | Photo File Suffix | String | - | A suffix added to the media file name during generation. | Required element | M4T/M4N |
| wpml:payloadLensIndex | Video Storage Type | Video format list | Enum-string (list) | zoom: Store zoom lens video wide: Store wide-angle lens video ir: Store infrared lens video narrow_band: Store narrow-band lens video visable: Visible-light video night: Night vision video * Note: To store multiple lens videos, the format is like “ <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>”, indicating the storage of wide, infrared, and narrow-band lens videos | Required element | M4T/M4N |
| wpml:useGlobalPayloadLensIndex | Use Global Storage Type | Boolean | - | 0: Do not use global settings 1: Use global settings | Required element | M4T/M4N |
stopRecord
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Intege | - | 0: Drone mounting position 1. Corresponds to the main gimbal. 1: Drone mounting position 2. 2: Drone mounting position 3. | Required element | M4T/M4N |
| wpml:payloadLensIndex | Video Storage Type | Video format list | Enum-string (list) | zoom: Store zoom lens video wide: Store wide-angle lens video ir: Store infrared lens video narrow_band: Store narrow-band lens video * Note: To store multiple lens videos, the format is like “ <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex>”, indicating the storage of wide, infrared, and narrow-band lens videos | - | M4T/M4N |
focus
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone mounting position 1. Corresponds to the main gimbal. 1: Drone mounting position 2. 2: Drone mounting position 3. | Required element | M4T/M4N |
| wpml:isPointFocus | Is Point Focus | Boolean | - | 0: Area Focus 1: Point Focus | Required element | M4T/M4N |
| wpml:focusX | Focus X Position | Float | - | [0, 1] * Note: X-axis coordinate (width) of the focus point or focus area's top-left corner. 0 is the far-left, 1 is the far-right. | Required element | M4T/M4N |
| wpml:focusY | Focus Y Position | Float | - | [0, 1] * Note: Y-axis coordinate (height) of the focus point or focus area's top-left corner. 0 is the top, 1 is the bottom. | Required element | M4T/M4N |
| wpml:focusRegionWidth | Focus Region Width | Float | - | [0, 1] * Note: Proportion of the width occupied by the focus region relative to the whole image. | Required element (if "isPointFocus" is "0", i.e., Area Focus) | M4T/M4N |
| wpml:focusRegionHeight | Focus Region Height | Float | - | [0, 1] * Note: Proportion of the height occupied by the focus region relative to the whole image. | Required element (if "isPointFocus" is "0", i.e., Area Focus) | M4T/M4N |
| wpml:isInfiniteFocus | Is Infinite Focus | Boolean | - | 0: Not infinite focus 1: Infinite focus | Required element | M4T/M4N |
zoom
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone mounting position 1. Corresponds to the main gimbal. 1: Drone mounting position 2. 2: Drone mounting position 3. | Required element | M4T/M4N |
| wpml:focalLength | Zoom Focal Length | Float | mm | Greater than 0 | Required element | M4T/M4N |
customDirName
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone mounting position 1. Corresponds to the main gimbal. 1: Drone mounting position 2. 2: Drone mounting position 3. | Required element | M4T/M4N |
| wpml:directoryName | New Folder Name | String | - | - | Required element | M4T/M4N |
gimbalRotate
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Mounting position 1 on the drone, corresponding to the main gimbal. 1: Mounting position 2. 2: Mounting position 3. | Required element | M4T/M4N |
| wpml:gimbalHeadingYawBase | Gimbal Yaw Base Coordinate System | Enum-string | - | north: Relative to true north | Required element | M4T/M4N |
| wpml:gimbalRotateMode | Gimbal Rotation Mode | Enum-string | - | relativeAngle: Relative to the drone's heading absoluteAngle: Absolute angle relative to true north | Required element | M4T/M4N |
| wpml:gimbalPitchRotateEnable | Enable Gimbal Pitch Rotation | Boolean | - | 0: Disabled 1: Enabled | Required element | M4T/M4N |
| wpml:gimbalPitchRotateAngle | Gimbal Pitch Rotation Angle | Float | - | * Note: The range of motion depends on the specific gimbal | Required element | M4T/M4N |
| wpml:gimbalRollRotateEnable | Enable Gimbal Roll Rotation | Boolean | - | 0: Disabled 1: Enabled | Required element | M4T/M4N |
| wpml:gimbalRollRotateAngle | Gimbal Roll Rotation Angle | Float | - | * Note: The range of motion depends on the specific gimbal | Required element | M4T/M4N |
| wpml:gimbalYawRotateEnable | Enable Gimbal Yaw Rotation | Boolean | - | 0: Disabled 1: Enabled | Required element | M4T/M4N |
| wpml:gimbalYawRotateAngle | Gimbal Yaw Rotation Angle | Float | - | * Note: The range of motion depends on the specific gimbal | Required element | M4T/M4N |
| wpml:gimbalRotateTimeEnable | Enable Gimbal Rotation Timing | Boolean | - | 0: Disabled 1: Enabled | Required element | M4T/M4N |
| wpml:gimbalRotateTime | Gimbal Rotation Time | Float | s | - | Required element | M4T/M4N |
gimbalEvenlyRotate
Note: The action “gimbalEvenlyRotate” performs a uniform rotation of the gimbal pitch angle between flight segments, and its trigger type must be set to “betweenAdjacentPoints.”
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:gimbalPitchRotateAngle | Gimbal Pitch Rotation Angle | Float | - | * Note: Different gimbals have different rotation ranges. | Required | M4T/M4N |
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Mount position 1 on the drone (Main Gimbal). 1: Mount position 2 on the drone. 2: Mount position 3 on the drone. | Required | M4T/M4N |
rotateYaw
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:aircraftHeading | Drone Target Yaw Angle (Relative to Geographic North) | Float | ° | [-180, 180] * Note: The drone will rotate to this target yaw angle. 0° is North, 90° is East, -90° is West, and -180°/180° is South. | Required | M4T/M4N |
| wpml:aircraftPathMode | Drone Yaw Angle Rotation Mode | Enum-string | - | clockwise: Rotate clockwise counterClockwise: Rotate counterclockwise | Required | M4T/M4N |
hover
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:hoverTime | Drone Hover Waiting Time | Float | s | > 0 | Required | M4T/M4N |
accurateShoot
| Element | Name | type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:gimbalPitchRotateAngle | Gimbal Pitch Rotate Angle | Float | ° | [-120, 45] | Required | M4T/M4N |
| wpml:gimbalYawRotateAngle | Gimbal Yaw Rotate Angle | Float | ° | [-180, 180] | Required | M4T/M4N |
| wpml:focusX | Focus Frame Center X Coordinate | Integer | px | (0, 960) *Note: Top-left corner of the image is the origin (0,0) | Required | M4T/M4N |
| wpml:focusY | Focus Frame Center Y Coordinate | Integer | px | (0, 720) *Note: Top-left corner of the image is the origin (0,0) | Required | M4T/M4N |
| wpml:focusRegionWidth | Focus Frame Width | Integer | px | (0, 960) | Required | M4T/M4N |
| wpml:focusRegionHeight | Focus Frame Height | Integer | px | (0, 720) | Required | M4T/M4N |
| wpml:focalLength | Focal Length | Float | mm | > 0 | Required | M4T/M4N |
| wpml:aircraftHeading | Drone Heading (Relative to True North) | Float | ° | [-180, 180] *Note: 0° is North, 90° is East, -90° is West, -180°/180° is South | Required | M4T/M4N |
| wpml:accurateFrameValid | Precise Re-shoot Frame Valid | Boolean | - | 1: Target object selected 0: Target not selected. *Note: When set to 1, the drone will autonomously search for the target to shoot again. When set to 0, the drone will only replicate the position without target search. | Required | M4T/M4N |
| wpml:payloadPositionIndex | Payload Position | Integer | - | 0: Drone Position 1 (Main Gimbal) 1: Drone Position 2 2: Drone Position 3 | Required | M4T/M4N |
| wpml:payloadLensIndex | Photo Storage Type | - | List | zoom: Store zoom lens photos wide: Store wide-angle lens photos ir: Store infrared lens photos night: Night vision photos *Note: To store multiple lens photos, use a format like <wpml:payloadLensIndex>wide,ir</wpml:payloadLensIndex> | Required | M4T/M4N |
| wpml:useGlobalPayloadLensIndex | Use Global Storage Type | Boolean | - | 0: Do not use global settings 1: Use global settings | Required | M4T/M4N |
| wpml:targetAngle | Focus Frame Angle | Float | ° | [0, 360] *Note: Rotation angle of the focus frame (clockwise from Y-axis) | Required | M4T/M4N |
| wpml:imageWidth | Photo Width | Integer | px | 960 | Required | M4T/M4N |
| wpml:imageHeight | Photo Height | Integer | px | 720 | Required | M4T/M4N |
| wpml:AFPos | AF Motor Position | Integer | - | - | Required | M4T/M4N |
| wpml:gimbalPort | Gimbal Port Number | Integer | - | Camera installation position *Note: Fixed to 0 for M4T/M4N models | Required | M4T/M4N |
| wpml:accurateCameraType | Camera Type | Integer | - | 52 (Model: M4T Dual-camera) 53 (Model: M4N Triple-camera) | Required | M4T/M4N |
| wpml:accurateFilePath | Photo File Path | String | - | Photo file name | Required | M4T/M4N |
| wpml:accurateFileMD5 | Photo File MD5 | String | - | MD5 value of the photo file | Required | M4T/M4N |
| wpml:accurateFileSize | Photo File Size | Integer | Byte | Actual file size of the photo | Required | M4T/M4N |
| wpml:accurateFileSuffix | Photo File Suffix | String | - | Additional suffix for naming media files | Required | M4T/M4N |
| wpml:accurateCameraApertue | Camera Aperture | Integer | - | *Note: Actual aperture value x100 | Required | M4T/M4N |
| wpml:accurateCameraLuminance | Ambient Luminance | Integer | - | - | Required | M4T/M4N |
| wpml:accurateCameraShutterTime | Shutter Time | Float | Seconds | - | Required | M4T/M4N |
| wpml:accurateCameraISO | ISO | Integer | - | - | Required | M4T/M4N |
orientedShoot
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:gimbalPitchRotateAngle | Gimbal Pitch Rotate Angle | Float | ° | M4T/M4N：[-90, 30] | Required | M4T/M4N |
| wpml:gimbalYawRotateAngle | Gimbal Yaw Rotate Angle | Float | ° | [-180, 180] | Required | M4T/M4N |
| wpml:focusX | Focus Frame Center X Coordinate | Integer | px | (0, 960) *Note: Top-left corner of the image is the origin (0,0) | Required | M4T/M4N |
| wpml:focusY | Focus Frame Center Y Coordinate | Integer | px | (0, 720) *Note: Top-left corner of the image is the origin (0,0) | Required | M4T/M4N |
| wpml:focusRegionWidth | Focus Frame Width | Integer | px | (0, 960) | Required | M4T/M4N |
| wpml:focusRegionHeight | Focus Frame Height | Integer | px | (0, 720) | Required | M4T/M4N |
| wpml:focalLength | Focal Length | Float | mm | > 0 | Required | M4T/M4N |
| wpml:aircraftHeading | Drone Heading (Relative to True North) | Float | ° | [-180, 180] *Note: 0° is North, 90° is East, -90° is West, -180°/180° is South | Required | M4T/M4N |
| wpml:accurateFrameValid | Precise Re-shoot Frame Valid | Boolean | - | 1: Target selected 0: Target not selected. *Note: When set to 1, the drone will autonomously search for the target to shoot again. When set to 0, the drone will only replicate the position without target search. | Required | M4T/M4N |
| wpml:payloadPositionIndex | Payload Mount Position | Integer | - | 0: Drone Position 1 (Main Gimbal) 1: Drone Position 2 2: Drone Position 3 | Required | M4T/M4N |
| wpml:payloadLensIndex | Photo Storage Type | - | List | zoom: Store zoom lens photos wide: Store wide-angle lens photos ir: Store infrared lens photos visible: Visible light photos night: Night vision photos *Note: To store multiple lens photos, use a format like <wpml:payloadLensIndex>wide,ir</wpml:payloadLensIndex> | Required | M4T/M4N |
| wpml:useGlobalPayloadLensIndex | Use Global Storage Type | Boolean | - | 0: Do not use global settings 1: Use global settings | Required | M4T/M4N |
| wpml:targetAngle | Focus Frame Angle | Float | ° | [0, 360] *Note: Rotation angle of the focus frame (clockwise from Y-axis) | Required | M4T/M4N |
| wpml:actionUUID | Action Unique Identifier | - | - | *Note: The value will be embedded into the photo file to link actions and the photo | Required | M4T/M4N |
| wpml:imageWidth | Photo Width | Integer | px | 960 | Required | M4T/M4N |
| wpml:imageHeight | Photo Height | Integer | px | 720 | Required | M4T/M4N |
| wpml:AFPos | AF Motor Position | Integer | - | - | Required | M4T/M4N |
| wpml:gimbalPort | Gimbal Port Number | Integer | - | Camera installation position *Note: Fixed to 0 for M4T/M4N models | Required | M4T/M4N |
| wpml:orientedCameraType | Camera Type | Integer | - | 52 (M4T Dual-camera) 53 (M4N Triple-camera) | Required | M4T/M4N |
| wpml:orientedFilePath | Photo File Path | String | - | Photo file name | Required | M4T/M4N |
| wpml:orientedFileMD5 | Photo File MD5 | String | - | MD5 hash value of the photo file | Required | M4T/M4N |
| wpml:orientedFileSize | Photo File Size | Integer | Byte | Actual file size of the photo | Required | M4T/M4N |
| wpml:orientedFileSuffix | Photo File Suffix | String | - | Additional suffix when naming media files | Required | M4T/M4N |
| wpml:orientedCameraApertue | Camera Aperture | Integer | - | *Note: Actual aperture value x100 | Required | M4T/M4N |
| wpml:orientedCameraLuminance | Ambient Luminance | Integer | - | - | Required | M4T/M4N |
| wpml:orientedCameraShutterTime | Shutter Time | Float | Seconds | - | Required | M4T/M4N |
| wpml:orientedCameraISO | ISO | Integer | - | - | Required | M4T/M4N |
| wpml:orientedPhotoMode | Photo Mode | Enum-string | - | normalPhoto: Standard photo lowLightSmartShooting: Low-light smart shooting |
<wpml:formationInfo>
| Element | Name | Type | Unit | Values and Interpretation | Required (Default Value) | Supported Models |
|---|---|---|---|---|---|---|
| wpml:formationType | Flight Formation Type | Enum - string | - | C: C formation horizontalOne: Horizontal Line formation verticalOne: Vertical Line formation U: U formation | Required | M4T/M4N |
| formationRadius | Formation Radius | Float | m | Formation radius (10~100 m) | Effective only in C formation | M4T/M4N |
| formationStartAngle | Tail Opening Start Angle | Float | ° | Starting angle (-180° ~ 180°) | Effective only in C formation | M4T/M4N |
| formationStopAngle | Tail Opening Stop Angle | Float | ° | Ending angle (-180° ~ 180°) | Effective only in C formation | M4T/M4N |
| formationDistanceBetweenAircraft | Distance Between Aircraft | Float | m | Distance between aircraft (3~100 m) | Effective only in Horizontal or Vertical Line formation | M4T/M4N |
| formationWidth | Formation Width | Float | m | Formation width (10~100 m) | Effective only in U formation | M4T/M4N |
| formationLength | Formation Length | Float | m | Formation length (20~100 m) | Effective only in U formation | M4T/M4N |