AI 驱动文档
您想了解什么？
元数据设置
本指南向您展示如何为 OV10i 摄像头图像配置元数据。元数据是与每张捕获图像一同存储的自定义信息，可帮助您追踪重要细节，如零件编号、序列号或生产数据。
何时使用元数据： 生产追踪、零件标识、质量控制记录、批次信息、操作员标识，或任何您需要与检查图像关联的自定义数据。
先决条件
- OV10i 摄像头系统已设置并连接
- 活动程序已配置好图像设置和检查设置
- 至少配置一个 AI模块（分类或分割）
- 了解您希望从检查结果中追踪的数据
什么是元数据？
元数据是附加到每张捕获图像上的附加信息。该信息：
- 与图像一起存储在摄像头的库中
- 显示在 HMI 中供操作员查看
- 帮助识别和追踪特定零件或生产批次
- 可在库中进行搜索以供分析
有用的元数据示例：
- 零件编号（例如，"P12345"）
- 序列号（例如，"SN987654"）
- 操作员姓名（例如，"John_Smith"）
- 班次信息（例如，"A_Shift"）
- 批次号（例如，"Batch_2025_001"）
备注
元数据只能在检查完成时才能保存。元数据必须是从摄像头捕获并处理图像后从"All Block Outputs"开始的流程的一部分。
第一步：访问 Node-RED 编辑器
1.1 导航至 IO 模块
- 在程序编辑器中打开您的活动程序
- 点击 Configure IO 或在面包屑菜单中选择 IO Block" 进入 Node-RED 编辑器
1.2 验证 Node-RED 界面
检查点： 您应看到 Node-RED 流程编辑器，其中包含现有的 IO模块流程，左侧有节点面板。
第二步：定位"All Block Outputs"节点
2.1 查找起点
在您的 Node-RED 流程中，查找 "All Block Outputs" 节点。这是检查被触发并处理后从摄像头接收数据的起点。
"All Block Outputs"节点：
- 包含来自所有 AI模块的检查结果
- 包括图像捕获信息
- 提供创建元数据所需的数据
- 是同时为元数据和通过/失败判定提供数据的来源
2.2 理解流程结构
您的流程应遵循此模式：
Camera Trigger → AI Processing → All Block Outputs → [Your Custom Logic]
从"All Block Outputs"开始，您需要 两条独立的路径：
- 元数据路径：All Block Outputs → Function（创建元数据）→ Capture Metadata
- 决策路径：All Block Outputs → Function（逻辑）→ 最终通过/失败
备注
元数据和通过/失败决策必须都从"All Block Outputs"节点分支出来。
第三步：添加 Capture Metadata 节点
3.1 定位元数据节点
- 在左侧面板（Overview 部分）找到"Capture Metadata"节点
- 将"Capture Metadata"节点拖放到流程画布上
- 将其放置在流程中触发器之后但图像捕获之前
3.2 流程中的节点位置
正确的流程结构：
All Block Outputs → Function (Create Metadata) → Capture Metadata
↓
Function (Pass/Fail Logic) → Final Pass/Fail
注意
"Final Pass/Fail" 节点是流程正常运行所必需的。每个流程必须以此节点结束。
第四步：配置元数据字段
4.1 设置基本元数据
- 双击 Capture Metadata 节点
- 配置您要跟踪的元数据字段
- 为每个字段设置数据源
4.2 元数据格式要求
重要
元数据必须格式化为具有以下内容的对象：
- 字符串键 - 字段名称必须为文本
- 字符串或数字值 - 数据可以是文本或数字
正确格式示例：
{
"part_number": "P12345",
"serial_number": "SN987654",
"operator": "John_Smith",
"shift": "A",
"quantity": 100,
"temperature": 23.5
}
第五步：创建元数据函数节点
5.1 添加用于创建元数据的函数节点
- 在 "All Block Outputs" 和 "Capture Metadata" 节点之间添加一个 "function" 节点
- 双击该 function 节点进行配置
- 此函数将从检查结果中提取数据并创建元数据
5.2 从 All Block Outputs 中提取数据
"All Block Outputs" 节点提供丰富的检查数据。以下是提取方法：
// Extract data from inspection results
const captureId = msg.payload.capture_id;
const serialNumber = msg.payload.serial_number || "No_Serial";
const inspectionTime = msg.payload.inspection_time || new Date().toISOString();
// Create metadata from inspection data
msg.payload = {
"capture_id": captureId,
"serial_number": serialNumber,
"inspection_time": inspectionTime,
"operator": global.get("current_operator") || "Unknown"
};
return msg;
5.3 静态元数据（固定值）
对于在生产过程中不会改变的信息：
// Set static metadata values
msg.payload = {
"recipe_name": "Bolt_Inspection_v2",
"line_number": "Line_3",
"shift": "A_Shift",
"station": "QC_Station_1"
};
return msg;
5.4 动态元数据（使用检查数据）
对于来自检查结果的信息：
// Extract inspection data
const captureId = msg.payload.capture_id;
const imageUrl = msg.payload.image_url;
const predictions = msg.payload.classification?.predictions || [];
// Create dynamic metadata
msg.payload = {
"capture_id": captureId,
"part_number": "P" + Date.now(),
"total_rois": predictions.length,
"timestamp": new Date().toISOString(),
"batch": global.get("current_batch") || "Default_Batch"
};
return msg;
第六步：连接元数据和通过/失败流程
6.1 所需的流程结构
每个流程必须从 "All Block Outputs" 出发包含两条路径：
All Block Outputs → Function (Create Metadata) → Capture Metadata
↓
Function (Pass/Fail Logic) → Final Pass/Fail
6.2 连接元数据路径
- 将 "All Block Outputs" 的输出连接到元数据函数的输入
- 将元数据函数的输出连接到 "Capture Metadata" 的输入
- Capture Metadata 节点可以作为终端节点（无需输出连接）
6.3 连接通过/失败路径
- 将"All Block Outputs"输出连接到通过/失败逻辑函数
- 将逻辑函数输出连接到"Final Pass/Fail"输入
- "Final Pass/Fail"节点是必需的 - 每个流程必须以此结尾
6.4 通过/失败逻辑函数示例
// Extract inspection result for pass/fail decision
const predictions = msg.payload.classification?.predictions || [];
// Determine if inspection passed (all ROIs passed)
let passed = true;
for (let prediction of predictions) {
if (!prediction.predicted_class.includes("pass")) {
passed = false;
break;
}
}
// Set the pass/fail result
msg.payload = passed;
return msg;
第 7 步：测试元数据配置
7.1 部署与测试
- 点击"Deploy"按钮（右上角）
- 使用您配置的触发方式（手动、数字输入或 PLC）触发一次检查
- 验证以下内容：
- 图像已被捕获
- 元数据随图像一同出现
- 已做出通过/失败判定
- 流程成功完成
7.2 验证完整流程
检查两条路径是否均正常工作：
元数据路径：
- 在主界面中导航至库
- 找到您的测试图像
- 验证元数据是否出现在图像详细信息中
通过/失败路径：
- 检查检查结果是否显示通过/失败状态
- 验证"Final Pass/Fail"节点是否正确处理
- 确认任何连接的输出（PLC、指示器）是否做出适当响应
7.3 测试不同的触发源
验证元数据与您特定的触发器配合工作：
对于手动触发：
- 使用软件触发按钮
- 验证每次手动捕获时元数据都会出现
对于数字输入触发：
- 激活外部传感器/开关
- 确认元数据随触发图像一同被捕获
对于 PLC 触发：
- 从 PLC 发送触发信号
- 验证元数据包含 PLC 数据（如适用）
第 8 步：高级元数据配置
8.1 来自多个全局变量的元数据
组合存储在全局范围中的不同来源的数据：
// Combine data from various global storage
const operatorData = global.get("operator_info") || {};
const productData = global.get("product_info") || {};
const shiftData = global.get("shift_info") || {};
msg.payload = {
"operator": operatorData.name || "Unknown",
"operator_id": operatorData.id || "000",
"product_code": productData.code || "Default",
"product_version": productData.version || "1.0",
"shift": shiftData.current || "Day",
"line_status": "Running",
"timestamp": new Date().toISOString()
};
return msg;
第 9 步：元数据问题故障排除
9.1 常见问题
| 问题 | 症状 | 解决方案 |
|---|---|---|
| 元数据未出现 | 库中无数据 | 验证元数据节点是否位于主 IO模块 流程中 |
| 元数据与错误的图像关联 | 数据与不正确的捕获一起出现 | 检查时序 - 元数据必须在图像捕获之前 |
| 触发不工作 | 未捕获图像 | 验证 IO模块 触发配置 |
| 缺少元数据字段 | 部分数据缺失 | 检查函数节点 payload 格式 |
| 数据类型错误 | 节点显示错误状态 | 确保值仅为字符串或数字 |
9.2 调试元数据流
添加调试节点以进行故障排除：
- 在触发器之后添加调试节点以验证触发器是否正常工作
- 在元数据函数之后添加调试节点以检查 payload
- 在 Capture Metadata 之后添加调试节点以确认处理
- 检查调试面板中的错误消息
第 10 步：最佳实践
10.1 流程设计
设计高效的元数据流：
- 将元数据保持在流程的早期阶段 - 在触发器之后立即设置元数据
- 使用单个元数据节点 - 不要重复使用 Capture Metadata 节点
- 保持流程连续性 - 元数据必须是主检查流程的一部分
- 处理缺失数据 - 始终提供默认值
10.2 元数据字段命名
使用一致、清晰的字段名称：
- 使用下划线代替空格（"part_number" 而不是 "part number"）
- 描述性但简洁（"operator" 而不是 "op"）
- 使用小写字母以保持一致性
- 避免可能引起问题的特殊字符
10.3 性能考虑
对于大批量生产：
- 最小化元数据大小 - 仅包含必要信息
- 使用高效数据类型 - 尽可能使用数字、短字符串
- 避免复杂处理 - 保持元数据创建简单快速
- 缓存全局数据 - 将常用数据存储在全局变量中
成功！您的元数据系统已就绪
您的元数据配置现在可以：
✅ 将自定义信息附加到每个触发的图像捕获
✅ 跟踪与检查流程同步的生产数据
✅ 在相机库中存储可搜索的信息
✅ 在 HMI 中显示相关数据供操作员查看
✅ 支持制造要求的可追溯性
持续维护
定期系统检查
- 验证元数据是否随触发的捕获一起出现
- 检查生产运行中是否存在缺失数据
- 监控高触发率下的流程性能
- 根据需求变化更新元数据字段
流程管理
- 审查生产中的元数据时序
- 优化函数节点性能
- 更新全局变量管理
- 培训操作员进行基于触发器的操作
后续步骤
设置基于触发器的元数据后：
- 使用所有已配置的触发器类型（手动、数字、PLC）进行测试
- 培训操作员正确使用触发器以捕获元数据
- 为动态数据设置全局变量管理
- 为不同的产品线创建元数据模板
- 使用元数据分析实施生产监控