場景配置
場景是分析任務的配置單位，定義 ROI 與 queue_analysis 參數。
場景概念
每個場景包含以下要素：
- 設備: 場景所屬的視頻設備
- ROI 區域: 分析的區域範圍
- 檢測類型: 要執行的 AI 分析類型
- 告警規則: 觸發告警的條件
建立場景
步驟 1：選擇設備
首先進入要建立場景的設備詳情頁，然後點擊「場景」分頁。
步驟 2：繪製 ROI
ROI (Region of Interest) 定義了 AI 分析的區域範圍：
- 在預覽畫面上點擊添加頂點
- 繪製封閉多邊形區域
- 可以拖曳頂點調整區域
提示: ROI 區域越精確，分析效果越好。避免包含無關背景。
步驟 3：分析類型
目前僅支援 queue_analysis。
步驟 4：配置參數
根據檢測類型，您可能需要配置額外參數：
| 參數 | 範圍 | 預設 | 說明 |
|---|---|---|---|
confidenceThreshold | 0.0-1.0 | 0.6 | 偵測信心度 |
entryThresholdSeconds | 1-60 | 3 | 進入判定秒數 |
exitThresholdSeconds | 1-60 | 1 | 離開判定秒數 |
trackingMaxAgeSeconds | 1-60 | 5 | 追蹤存活秒數 |
建立與刪除限制
- 建立後不可修改
deviceId與analysisType。 - 若分析狀態為 RUNNING / STARTING / STOPPING，無法更新或刪除場景。
- 刪除場景會級聯刪除其告警規則。
場景狀態
場景有以下狀態：
| 狀態 | 說明 |
|---|---|
| 草稿 | 尚未啟動分析 |
| 運行中 | 正在執行 AI 分析 |
| 暫停 | 暫時停止分析 |
| 錯誤 | 分析過程中發生錯誤 |
最佳實踐
ROI 設計建議
- 避免過大區域: 大區域會增加計算負擔且降低精確度
- 避開動態背景: 如樹葉搖動、水面波動等
- 考慮攝影機角度: 俯視角度通常效果最佳
靈敏度調整
- 誤報太多: 降低靈敏度或縮小 ROI
- 漏報太多: 提高靈敏度或調整 ROI
效能優化
- 限制同時運行的場景數量
- 避免重疊的 ROI 區域
- 使用適當的視頻解析度