自訂儀表

每塊自定義儀表都有一個腳本。腳本中的 main() 是繪製入口，回傳由內置 View 組成的畫面：Text 顯示文字，Circle 繪製圓形，LineChart 顯示曲線，佈局容器負責排列這些內容。

腳本可以在 main() 中取得當前速度、轉速等讀數，計算需要顯示的數字、顏色或角度，再把結果作為 View 的內容和屬性回傳。例如，讀取速度後，既可以把數值寫入 Text，也可以換算成 Circle 的圓弧角度。

CapDrive 會在需要更新畫面時再次呼叫 main()，並把回傳結果繪製出來。儀表程式碼只需根據本次輸入描述畫面，屬性動畫也由繪製端執行。圖片資源可以隨儀表儲存，在程式碼中按資源名稱使用。

儀表通過 .instrument 檔案導入和分享。可以從自定義儀表菜單中的 匯入儀表 打開已有檔案，也可以用 CapDrive 打開檔案。導入後的作品還需單獨添加到儀錶盤。

導入後的儀表儲存在 更多（…）→ 自訂儀表 中。通過 更多（…）→ 編輯儀表板 → + 選擇它，再點 完成，即可在儀錶盤查看。

使用車輛參數的作品還需在 儀表設定 → 輸入綁定 中，為已有 OBD 輸入選擇自己的車輛參數。保持輸入標識符不變即可沿用作品程式碼，無需把設備標識符寫進腳本。

在 更多（…）→ 自訂儀表 中選擇 新增儀表，進入編輯器。編輯區用於編寫 main() 與 View；點擊頂部名稱可設定儀表名稱、輸入綁定和其他選項。齒輪打開 參數設定，可管理數值、文本、開關、選擇項、基礎資料和 OBD 資料六類輸入。新儀表已帶有標識符為 speed 的基礎速度輸入。

編輯時可以隨時預覽文字、排布、圖形和動畫。預覽提供模擬輸入，便於在停車狀態下檢查儀表。出現程式碼錯誤時，可從日誌中的行號定位。儲存後把儀表添加到儀錶盤，即可使用實際讀數。

“第一個速度儀表”提供完整程式碼及說明；API 參考列出了可用的 View、屬性、類型和運行接口。

$data 向腳本提供當前讀數和近期採樣。速度、距離等基礎欄位可以直接用於數值顯示；車輛轉速、水溫等參數通過已配置的 OBD 設備提供。腳本還可以使用歷史採樣生成曲線。

每次執行 main() 時，讀取所需欄位、處理數值並生成 View。讀數可能暫時不可用，因此顯示程式碼應為缺測提供合適的內容。儀表資料文檔集中說明欄位結構、OBD 引用、歷史採樣與空值處理。