导入与分享

使用 .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
}