本页目录
一、 什么是组件动作
组件动作是航点动作类型中的一类，侧重于对无人机及其挂载设备进行精细化控制。与姿态与飞行动作不同，组件动作主要用于下发设备控制命令、调整相机参数、控制变焦倍率，以及对飞行状态进行精细干预。
当前支持的组件动作枚举（7 种）：命令组件、等待组件、悬停组件、变焦组件、航向组件、旋转组件、列表组件。
提示
⚠️ 人工接管组件暂不支持：动作类型下拉列表中可能出现"人工接管"选项，但该组件当前暂不支持、不可用。请勿依赖其进行配置。
按照控制对象与用途，可分为三大类：
- 设备控制类：对相机、云台、无人机、遥控器等设备的参数进行设置或下发控制命令，包括命令组件和变焦组件。
- 飞行状态类：对无人机自身的飞行行为进行精细调整，包括悬停组件、等待组件、航向组件、旋转组件。
- 编排类：对多条子指令/子动作进行组织与嵌套编排，即列表组件。
二、 打开组件动作配置
进入目标航点，或进入某个 路径动作 项后，打开动作编辑区域，并新增一个动作项。在动作类型下拉中选择对应的组件动作（如命令组件、变焦组件、悬停组件等）即可开始配置。
三、 设备控制类组件
1. 命令组件
命令组件用于对相机、云台、无人机、遥控器等设备下发控制命令或进行参数设置，是组件动作中功能最丰富的一类，也可触发拍照、录像等采集指令。
配置交互：
| 配置环节 | 说明 |
|---|---|
| 设备分类 | 通过 相机 / 云台 / 无人机 / 遥控器 四类标签筛选命令范围。 |
| 命令选择 | 支持搜索命令类型或关键字，从列表中勾选具体命令（如"开始拍摄""自动曝光锁定"）。 |
| 参数值 | 对需要参数的命令设置具体值或目标状态（如 AEB 张数、光圈值）。 |
| 已选命令 | 顶部显示"当前已选命令"及其设备标签（如"开始拍摄 [相机]"）。 |
相机类命令示例：开始拍摄、AEB 包围曝光张数、光圈值、自动曝光锁定、拍照时自动锁定云台、色彩模式等。
典型使用场景：
- 在特定航点触发拍照或录像（开始拍摄等命令）
- 切换相机拍摄模式或调整曝光参数（ISO/快门/光圈/AEB）
- 调整云台工作模式或锁定策略
- 设置无人机或遥控器相关参数
2. 变焦组件
变焦组件用于将相机调整至指定变焦倍率，实现画面放大或缩小。常用于巡检、单点检查等任务中，在抵达目标附近后拉近镜头以确认局部细节。
| 字段 | 说明 |
|---|---|
| 变焦倍率 | 设置目标变焦倍数，如 1x、2x、5x 等。 |
典型使用场景：
- 巡检任务中拉近镜头查看设备细节
- 单点检查中放大目标区域进行核查
- 配合拍照动作，在特定倍率下采集高分辨率影像
提示
⚠️ 注意：变焦组件执行后，相机倍率会保留至后续航点（不自动恢复）。如果后续航点需要恢复广角视角，需再次配置变焦组件将倍率重置。
四、 飞行状态类组件
1. 悬停组件与等待组件
悬停组件和等待组件均使无人机在航点暂停指定时长，时间到达后继续执行后续动作。两者功能高度相似，均用于在特定节点暂停飞行，具体语义差异以产品实际定义为准。
| 字段 | 说明 |
|---|---|
| 悬停时长 (s) | 悬停组件：设置无人机悬停的时间，单位秒。 |
| 等待时长 (s) | 等待组件：设置无人机等待的时间，单位秒。 |
典型使用场景：
- 等待云台稳定后再触发拍照
- 在目标点停留以获取更清晰的影像
- 为后端 AI 识别或人工核查预留时间
提示
💡 提示：悬停与等待组件适合在需要稳定观察或拍摄的节点使用，但不宜过度堆叠以免显著增加飞行时长。二者时长结束即自然结束，不涉及状态恢复。
2. 航向组件
航向组件控制无人机机头按照指定方向偏转指定角度，用于在航点临时调整机头朝向，以对准特定目标或配合相机拍摄。
| 字段 | 说明 |
|---|---|
| 偏转方向 | 设置机头偏转方向，向左或向右。 |
| 偏转角度 (°) | 设置机头偏转的角度值。 |
提示
⚠️ 注意：航向组件执行后，机头保留新朝向，不自动恢复。如需回正，需主动配置复位动作。
3. 旋转组件
旋转组件控制无人机按顺时针或逆时针方向旋转指定时长或角度，用于在目标点进行旋转观察或调整朝向。
| 字段 | 说明 |
|---|---|
| 旋转方向 | 设置旋转方向，顺时针或逆时针。 |
| 旋转方式 | 选择按旋转时长或按旋转角度控制。 |
| 旋转时长 (s) / 旋转角度 (°) | 按时间或按角度控制时，设置对应值。 |
典型使用场景：
- 在目标点进行 360° 全景观察
- 配合相机动作进行多角度拍摄
提示
💡 注意：旋转组件执行完毕后自动恢复至初始状态，无需手动复位。
五、 编排类组件
列表组件
列表组件作为编排容器，用于容纳和组织多条子指令/子动作，实现分组与嵌套编排。当某个节点的检查逻辑较复杂时，使用列表组件可使动作层级更清晰、执行顺序更严谨。
提示
💡 状态保留：列表组件本身不改变设备状态，其内部各组件遵循各自的保留规则（如内部变焦组件保留倍率、内部旋转组件自动恢复）。
六、 执行规则与状态保留（⚠️ 核心避坑）
组件动作按照配置顺序依次执行。执行后的状态行为分为三类：
| 状态行为 | 适用组件 | 业务含义 |
|---|---|---|
| 自动恢复初始状态 | 旋转组件 | 执行完毕后自动恢复至初始状态，无需手动复位。 |
| 保留最新结果（不自动恢复） | 航向组件（机头朝向）、云台设置、相机设置（命令组件/变焦组件）、遥控器设置 | 执行后保留最新结果，跨节点持续生效。如不主动复位，后续航点将一直沿用该状态。 |
| 自然结束（不涉及恢复） | 悬停组件、等待组件 | 时长结束即自然结束，继续执行下一动作，不涉及状态恢复。 |
提示
💡 状态管理原则："谁改变、谁负责复位"。对于不自动恢复的航向、云台、相机、遥控器设置，若不希望影响后续航段，必须在合适节点主动配置复位动作（如变焦重置 1x、航向回正）。
七、 使用建议
- 命令组件先确认现状：命令组件涉及设备参数修改，配置前建议确认目标设备的当前状态，避免参数冲突；善用设备分类标签与搜索快速定位命令。
- 变焦需主动重置：变焦组件执行后相机倍率会保留，后续航点如需恢复广角视角，需再次配置变焦组件重置。
- 航向需主动回正：航向组件执行后保留新朝向（不自动恢复），如需回正需主动配置复位；而旋转组件自动恢复，无需复位。
- 悬停/等待不宜堆叠：适合在需要稳定观察或拍摄的节点使用，但过度堆叠会显著增加飞行时长。
- 复杂逻辑用列表组件：节点内多条指令应使用列表组件分组嵌套，保持层级清晰、顺序严谨。
- 注重执行顺序：多个组件动作同时使用时，应注意执行顺序，确保设备参数调整与飞行动作协调一致（如先悬停稳定、再变焦/调云台、最后命令组件拍照）。