匯入與分享
使用 .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
}