匯入與分享

使用 .instrument 檔案儲存和分享儀表。檔案包含顯示程式碼、儀表配置和圖片資源,導入後可在自己的儀錶盤使用。

儀表檔案包含什麼

.instrument 是 ZIP 包,包含 manifest.json、main.jsx 和 assets/。配置記錄名稱、App 版本、HUD 支持及 parameters 輸入定義,包括預設值、範圍和選項;腳本與資源定義外觀。

本機填寫的輸入值和 OBD 設備綁定單獨儲存在 App 資料中,不隨儀表包導出;輸入定義中的預設文字仍會導出,分享前應檢查。臨時運行狀態和 $sessionStorage 也不會導出。

匯出與匯入

儲存後從儀表菜單導出,通過系統分享面板發送或存入“檔案”。接收者用 CapDrive 打開檔案,或從自定義儀表菜單導入,再通過 編輯儀表板 → + 添加到頁面。

接收者從定義的預設值開始,可在 輸入綁定 中填寫自己的值。對於 OBD 輸入,接收者需要選擇自己設備的相應車輛參數。保持輸入標識符不變即可沿用程式碼。儀表包不包含車輛藍牙連線,也不會替接收者完成參數配置。

範例:儀表設定

下方的 parameters 定義基礎速度、OBD 冷卻液溫度和一個數值上限輸入。

欄位 含義
identifier 輸入標識符,決定腳本欄位名。
kind 輸入類型。
basicData 基礎資料來源。
valueType OBD 輸入的預期值類型。
defaultValue 可分享的預設值。
supportsHUD 是否支持 HUD。
appVersion 所需 App 版本,用於兼容性檢查。

清單不包含 OBD 設備綁定或本機修改的輸入值。完整儀表包還需要腳本與資源。

{
  "formatVersion": 1,
  "title": "My instrument",
  "appVersion": "1.3.1",
  "parameters": [
    {
      "name": "Speed",
      "identifier": "speed",
      "kind": "basic",
      "basicData": "speed"
    },
    {
      "name": "Coolant",
      "identifier": "coolant",
      "kind": "obd",
      "valueType": "number"
    },
    {
      "name": "Limit",
      "identifier": "limit",
      "kind": "number",
      "defaultValue": 120,
      "minimum": 0,
      "maximum": 300
    }
  ],
  "supportsHUD": true
}