导入与分享
使用 .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
}