选择需要的数据
新建的自定义仪表默认不读取任何驾驶数据。写出 $data.current.speed 不会自动启用速度采集；你还需要在仪表设置中声明使用它。
在哪里选择
- 打开仪表编辑器，点击顶部标题。
- 在“需要使用的数据”右侧打开编辑入口。
- 选择代码需要的基础数据或 OBD 参数，确认选择。
- 返回编辑器检查预览，最后保存仪表。
下载本站的示例 ZIP 时，数据选择已经包含在清单中；只复制 JSX 代码时，需要手动勾选对应数据。每个示例页都列出了所需字段。
基础驾驶数据
基础数据用于速度、运动状态、位置和行程统计。以下几组每组只需要选择一次：
| 选择项 | 可以读取的内容 |
|---|---|
G 值 gForce |
longitudinal、lateral、combined |
方位 heading |
direction、accuracy |
位置 location |
latitude、longitude |
车辆姿态 vehicleAttitude |
roll、pitch |
位置精度 locationAccuracy 和海拔 altitude 是独立选择项。需要绘制时间曲线时，还应选择 timestamp 或 elapsed；两者都是带 .value 的读数对象。
例如，数字速度卡片只需要 speed；最近 30 秒的速度曲线还需要时间字段。读取路径和单位见驾驶数据参考。
OBD 设备与参数
数据列表按记住的设备分组，分组标题使用设备名，每组列出该设备的参数。标准 OBDII 模板生成的参数也属于对应设备，读取方式与其他参数相同。
选择后，使用该行显示的脚本路径，例如 $data.current.obd['a1b2c3d4']。参数 ID 与名称由设备配置决定，不能把示例 ID 当成所有车辆通用的标识。绑定、有效期与缺测行为见 OBD 参考。
如果列表显示“无法找到对应数据”，说明原来选择的设备或参数当前无法解析。这个选择仍然保留，恢复对应配置后可以重新解析；只有主动取消选择才会移除它。
选择与可用是两回事
| 情况 | 脚本看到的内容 |
|---|---|
| 未选择任何数据 | current 是 {}，history 是 [] |
| 未选择某个基础字段 | 对象中没有这个字段 |
| 已选择，但当前缺测或过期 | 对应读数为 null |
| 已选择，并取得有效的零值 | 保留 0，不会变成缺测 |
| 只选择 OBD 参数 | 当前值位于 current.obd，历史仍为空 |
基础数据历史只包含声明的字段，OBD 参数不会进入历史。预览也只提供已经声明的数据，OBD 的预览值来自参数配置，可能是文本映射、范围样本或 null。
什么时候读取
可见的实时仪表会为声明的数据登记需求；缩略图、离屏页面和被其他页面覆盖的仪表盘不会因为这张卡片继续请求读数。App 自身需要的数据采集仍由 App 管理。
实时 OBD 读数不要求先开始一次行程；需要的设备应已连接且参数能够成功读取。最近 30 秒历史和单次行程存储则有各自的记录生命周期，不应拿来判断 OBD 是否连接。