AI 驅動文件

您想了解什麼？

相機指令碼

相機指令碼是整個相機使用的一個指令碼。它對每次完成的檢測和傳入的訊息做出響應，可以：

釋出到任何 MQTT 主題，使用您自己的格式
設定變數，供程式指令碼讀取
觸發告警，顯示在診斷日誌中
執行定時器和保持狀態，例如計數器和最後看到的值

它絕不會更改判定：決定通過或失敗是程式指令碼的職責。它在程式切換期間持續執行。

開啟 Integration > Camera Script。在您開啟指令碼之前不會執行任何內容，因此您可以先編寫和測試它。

相機指令碼頁面：從模板、空白指令碼或檔案開始，右側有參考面板

執行方式

指令碼匯出多個鉤子。每個鉤子都是可選的：一個指令碼可以只匯出 onResult，或只匯出 subscriptions 和 onMessage。

鉤子	執行時機
`onStart()`	指令碼載入時：儲存後、開啟時以及相機啟動時。在此啟動定時器並初始化狀態
`onResult(result)`	每次生產檢測之後。匯出 `options = { setup_results: true }` 也可以獲取設定模式的結果
`onMessage(msg)`	當 `subscriptions` 中的主題收到訊息，或 PLC 的使用者資料發生變化時
`onTimer(name)`	當定時器觸發時
`onStop()`	新版本接管之前、關閉指令碼時以及關機時（斷電時不會觸發）

export const subscriptions = ["plant/line3/cmd"]; // MQTT topics this script listens on

export function onStart() {

  state.results = 0;
  timers.set("heartbeat", 30 * 1000, { repeat: true });
}

export function onResult(result) {

  state.results = Number(state.results ?? 0) + 1;
}

export async function onTimer(name) {

  if (name !== "heartbeat" || mqtt.status() !== "connected") return;
  await mqtt.publish("plant/line3/alive", { alive: true, results: state.results }, { qos: 0 });
}

**一次一個。**鉤子一次執行一個，因此狀態不會在鉤子執行期間改變。新事件在佇列中等待，最多可容納 64 個結果和 256 條訊息；當佇列已滿時，最舊的事件會被丟棄並計數。

**等待。**當某個鉤子在 await mqtt.publish 或 vars.set 時，下一個事件的鉤子可以執行。請在 await 之後再次讀取 state，而不是在它之前讀取。

**時間。**鉤子在第一次 await 之前有 1 秒時間，之後每段有 50 毫秒。執行超時的鉤子會被停止。

失敗。當鉤子丟擲異常或被停止時，錯誤會出現在指令碼的日誌中並作為告警出現，它啟動的呼叫會被取消，下一個事件照常執行。

可用內容

全域性物件	作用
`mqtt.publish(topic, payload, opts?)`	釋出文字、位元組或物件（以 JSON 傳送）。選項：`qos`（0、1 或 2）、`retain`，以及 MQTT v5 屬性 `content_type`、`response_topic`、`correlation_data`、`user_properties`、`message_expiry_s`
`mqtt.status()`	`"disabled"`、`"connecting"`、`"connected"` 或 `"disconnected"`
`subscriptions`	要監聽的主題列表，使用字串字面量。允許使用 `+` 和 `#` 萬用字元
`vars.get(name)` / `vars.set(name, value)`	讀取任何變數；設定來源為相機指令碼的變數
`timers.set(name, ms, { repeat })` / `timers.clear(name)`	命名定時器，至少 100 毫秒
`alert.raise(title, detail?)`	觸發告警。相同標題每分鐘最多觸發一次
`state`	在事件之間保留的臨時記憶體，直到指令碼重新載入
`csv(rows)`、`xml.build()`、`xml.parse()`	構建 CSV 文字，構建或解析 XML
`pack`、`unpack`、`crc`、`log`	與程式指令碼相同的輔助函式

onResult 中的 result 與結果訊息的結構相同：包括程式、觸發、最終 judgment 和 reason、每個工具的結果、vars、metadata、tags、image.url 等。詳見 MQTT。