Discussion brief · VPP current state → IVSD clarification

VPP Camera FOV 現況與 IVSD 對接討論

這份文件先向 IVSD 團隊說明 VPP 現在使用哪些輸入、公式與特殊路徑，再請 IVSD 對照說明其正式計算方式、介面與支援範圍。此階段的目的不是預先決定整合實作。

這次要做到建立共同語言，確認相同 camera、zoom、height、tilt、yaw 在兩套系統中的定義與輸出。

這次不先決定不要求 IVSD 重畫 VPP 2D spec，也不假設 VPP 必須自行重做 IVSD distortion 或偵測演算法。

VPP 會先介紹什麼

產品規格：H/V FOV、resolution、sensor、focal range、camera type。
一般透視相機：由 height、tilt、H/V FOV 算近邊、遠邊與左右寬度。
沒有 H/V FOV 時的 sensor＋focal 推算，以及 varifocal 端點修正。
resolution 透過 PPM 產生 Identify／Recognize／Observe／Detect 色帶。
fisheye、panoramic、multi-channel、thermal 等不走同一條一般梯形路徑。

公式、參數來源與特殊分支以 VPP 詳解為現況依據；本頁只保留討論所需摘要。

第一個必問：正式計算放哪裡？

會議紀錄的方向是「呼叫 IVSD API 取得辨識範圍」；目前取得的工具則顯示 REST 主要下載 model／intrinsics，真正的 polygon 由瀏覽器 WASM 計算。

請 IVSD 確認正式且會被維護的整合方式：後端直接回傳 polygon，還是由 VPP 下載校正資料並執行指定版本 WASM？兩者的版本更新、錯誤處理與責任完全不同。

用 IB9387 當共同案例，不先判斷誰對誰錯

目的只是給 IVSD 一組可重現的 VPP 輸入與輸出，請他們用相同條件說明 IVSD 的對應參數、計算步驟與結果語意。

IB9387-EHTV-V3 · MID CHECKPOINT

focal 6.00 mmheight 3 mtilt 45°yaw 0°resolution 2560×1920

VPP CURRENT OUTPUTFOV 56.56° × 38.81°地面近邊 1.44 m、遠邊 6.26 m，再依 PPM 畫 DORI。

ASK IVSD TO EXPLAIN6.00 mm 對應哪個 ZoomVal？回傳哪些 polygon、單位與座標？Human／Vehicle 邊界代表什麼保證條件？

對接時逐項請 IVSD 說明

主題	VPP 會提供的現況	請 IVSD 回答
正式架構	VPP 需要穩定取得辨識範圍，不希望自行猜 distortion。	正式產品介面是 polygon API，還是 REST＋WASM SDK？版本如何管理？
Model mapping	VPP 使用 product catalog model／SKU，包含版本與焦段後綴。	IVSD 的 canonical model ID、alias、支援清單與更新機制是什麼？
輸入與單位	model、height、tilt、yaw、focal、channel、mount mode。	角度零點與正方向、cm/m、camera-local/world 座標如何定義？yaw 在哪一層套用？
Zoom	VPP UI 使用連續焦距 mm；變焦可在 min/max 間調整。	`focal mm ↔ ZoomVal` 是否由 IVSD 提供正式映射與內插規則？超出校正範圍怎麼辦？
輸出	VPP 既有圖層需要地面 geometry；2D 與 3D 都要使用。	回傳 polygon 頂點還是 bitmap？單位、winding、非凸、多環與空結果如何表示？
Detection	VPP product `vca` 旗標代表產品宣稱支援。	Human／Vehicle／Face／LPR／PPE／Fall 的可用性與 polygon 非空條件從哪裡查？
無資料	VPP 會顯示「暫無模擬資料」，不拿其他 model 或 Image FOV 代替。	IVSD 如何區分 unsupported、no calibration、planned、calculation failed？
特殊模式	VPP 有 ceiling/wall mount、LDC、corridor、multi-channel 等狀態。	哪些狀態會改變校正或 polygon？哪些必須成為正式輸入？
環境與維運	VPP 需要可測試、可監控、可升版的相依來源。	dev/stage/prod、SLA、cache、rate limit、版本相容與新機種上架流程為何？

魚眼與特殊機種：不能只用一般梯形驗證

以下不是現在要替 IVSD 決定的規則，而是會議中必須逐項確認的模型族群。每一類至少要有一台 golden model。

魚眼 Fisheye FE SERIES

VPP 現況：H/V 都是 180° 時，ceiling mount 畫 360° circle；wall mount 畫 180° wedge，不進一般梯形。

要問：IVSD 如何表示 mount、環形／多環 polygon、中心盲區與 distortion？

超廣角 Panoramic CC SERIES

VPP 現況：fovH ≥ 180°、fovV < 180° 走 wedge，DORI 外緣受地面遠邊限制。

要問：IVSD 的超廣角幾何是否也可能非凸？如何區分 fisheye 與 panoramic？

多鏡頭 Multi-sensor MA SERIES

VPP 現況：每個 channel 各有 tilt、yaw、focal；modelType=panoramic 不代表單鏡頭魚眼。

要問：IVSD 是每 channel 呼叫一次嗎？model ID、channel ID 與校正檔如何對應？

PTZ／大倍率變焦 SD SERIES

VPP 現況：依目前設定的 rotation、tilt 與 focal length，重新計算並顯示一個設計階段的靜態 FOV 預覽；不模擬 PTZ 巡航、Preset 或即時設備移動。

要問：IVSD 是只支援單一姿態的靜態計算，還是能描述完整的 pan／tilt／zoom 可動範圍？連續 zoom 與離散校正點如何對應？

Thermal TB / TT SERIES

VPP 現況：使用不同 sensor，且固定焦段仍保留 30 PPM Detect 外緣，不套一般 fixed 80 PPM 截斷。

要問：IVSD 是否有獨立 thermal 模型、目標類型與距離標準？若沒有，MVP 是否排除？

可換鏡頭 Box Camera IP SERIES

VPP 現況：機身不綁唯一鏡頭；只用 model 無法決定 sensor＋lens 的完整內參。

要問：是否必須傳 lens ID？沒有鏡頭組合校正時，是 unsupported 還是允許使用通用模型？

立體／特殊分析機 SC9133

目前觀察：SC9133 只回 Human，其餘 detection polygon 可能為空；不可被當作其他型號 fallback。

要問：空 polygon 是能力限制、解析度 gate，還是計算錯誤？如何由介面區分？

LPR 專用機 IB / IP LPR

目前觀察：大量 LPR 專用 SKU 沒有一般 IVSD calibration，但產品語意上最需要 LPR range。

要問：LPR 是否走另一套校正／工具？專用機與一般 AdvAI LPR 是否共用 polygon 定義？

建議第一輪 Golden Models

一般定焦：確認 H/V FOV、height、tilt 與座標。
IB9387-EHTV-V3：確認 varifocal 與 ZoomVal。
FE9391-EHV-V2：確認魚眼 ceiling／wall。
MA9311 或 MA9322：確認 multi-channel。
SD9384-EHL：確認 PTZ／大倍率 zoom。
再各選 thermal、box camera、SC9133、LPR 專用機驗證是否納入。

會議結束應拿到的答案

正式執行方式API 或 WASM SDK，以及版本責任。

Interface contract輸入、輸出、單位、座標與錯誤。

Support matrixmodel × channel × detection type。

特殊機種範圍MVP 支援、排除與後續 owner。

Calibration lifecycle新機種、變焦點與資料更新方式。

可驗證案例雙方可重跑的 golden inputs／outputs。