自定义仪表

每块自定义仪表都有一个脚本。脚本中的 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 引用、历史采样与空值处理。