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）進行測試
- 培訓操作員正確使用觸發器以捕獲後設資料
- 為動態資料設定全域性變數管理
- 為不同的產品線建立後設資料模板
- 使用後設資料分析實施生產監控