认识 CapDrive

CapDrive 在驾驶过程中持续取得可用的速度、位置和运动数据，显示为数字、指针、曲线或地图。车辆转弯时，横向 G 值反映侧向运动；正常加速、制动时，纵向 G 值帮助观察前后方向的运动变化。

这些数据同时用于行程记录。到达后，可以打开当天的行程，在地图和时间线上选择时刻，查看当时的速度、运动读数和驾驶事件。

第一次使用只需 iPhone 和稳固的支架。基础仪表与自动记录无需连接 OBD；需要转速、水温等车辆读数时，可再接入适配器。希望改变仪表外观或组合内容时，可以导入或制作自定义仪表。

手机数据和车辆数据是两类来源。 不连接任何车辆设备，CapDrive 也能依靠 iPhone 的定位和运动传感器提供基础功能。

为什么已经有速度，G 值却还在等待

速度可以在定位有效时显示；但要把手机测得的运动区分成“车辆向前加速”和“车辆侧向转弯”，App 还需要确定手机与车辆的相对方向。因此，不同读数可能在不同时刻变得可用。

停车时的“等待行驶，请放稳设备”，意味着还缺少方向识别所需的运动信息。正常驾驶中的加速、减速和转弯可以提供这些信息，不需要专门做激烈动作。中途移动手机后，部分运动读数可能重新进入等待状态。

零值和缺测不是一回事

速度为 0 是一个有效读数；显示 — 或等待状态，则表示当前没有可用数据，或仪表正在等待所需条件。比如定位丢失时，不能把没有速度数据理解为车辆已经停止。换一种仪表样式也不会补回缺失的数据。

为什么手机需要固定

CapDrive 测量的是手机的运动，再从中判断车辆的运动。如果手机在支架里晃动、被拿在手中转动，传感器记录到的也包含这些动作，App 就不能把它们都当成车辆运动。

手机横放、竖放都可以，关键是它与车辆保持稳定的相对位置。改变安装角度后，车辆方向需要重新识别。这是测量成立的前提，不是仪表的外观设置。首次使用所需的位置权限及异常处理可展开下方说明查看。

权限

如果缺少某项权限，仪表区会显示 实时数据受限 并列出问题。能通过设置解决时，轻点 打开设置 即可前往“设置”App 中的 CapDrive 页面（也可以打开 设置 › App › CapDrive）：

• 定位已关闭：在 位置 中选择 使用App期间。如果整台 iPhone 的定位服务都已关闭，请在 设置 › 隐私与安全性 › 定位服务 中打开。
• 精确位置已关闭：在 位置 中打开 精确位置。
• 此设备限制了定位：定位受到屏幕使用时间或设备管理描述文件的限制。请检查 设置 › 屏幕使用时间，或联系设备的管理者。
• 运动数据不可用：请重启 CapDrive；若仍无数据，重启 iPhone 并联系支持。当前版本直接读取设备运动，不单独请求“运动与健身”权限，该设置页可能没有 CapDrive 开关。

实时仪表把当前读数绘制成适合快速查看的画面。数字仪表显示准确数值，指针和圆弧表现当前量程位置，曲线显示最近一段时间的变化，地图显示位置与路线。

内置仪表涵盖速度、G 值、车头朝向、定位、时间线、本次行程、车辆姿态和海拔等内容。各项读数在满足自身测量条件后显示：定位有效时可以取得速度；方向识别完成后可提供相应的车辆运动数据。

自定义仪表允许把所需读数组合成自己的画面，例如同时显示转速、水温和一段曲线。代码可以控制字号、颜色、布局、图形与动画。读数不可用时，仪表显示等待状态、横线或作品定义的空状态。

仪表盘按页面组织实时仪表，每页最多三个。可以选择日常关注的读数、调整卡片大小和顺序，并分成多页查看。编辑页面的具体操作见下方仪表盘说明。

仪表库保存已安装和制作的仪表。导入或保存自定义仪表后，通过编辑仪表盘将其添加到页面；从页面移除卡片时，库中仍可保留该作品，方便以后再次添加。

HUD 提供适合挡风玻璃反射观看的显示方式，效果受玻璃与光线影响。显示尺寸和模式变化时，仪表需要适应相应空间；车辆读数仍由已经连接和配置的数据源提供。

行程记录保存一次驾驶中的可用数据。完成首次设置后，CapDrive 会自动记录和识别行驶，不需要每次按一个开始按钮。记录正在进行，也不代表每一项读数都已经满足可用条件。

一段行程包含这次记录期间的行驶与停车。 等红灯或临时停车不会自动结束它。定位短暂丢失或部分读数不可用，也不应简单理解为开始了另一段行程。回顾时会保留实际的数据缺失情况。

记录状态与控制：

历史记录用路线、时间线和所选时刻的读数帮助你回看驾驶。有效的零速度与缺测区间仍然不同。行程需要包含已保存的有效测量数据才会保留；只是打开 App 等待一会儿，不一定会产生可回顾的记录。

实时显示、保存原始数据和回顾时的处理也不是完全相同的过程。回顾可能过滤有充分证据判定为异常的运动读数，因此个别显示结果不一定与当时仪表逐项一致。具体回放方式和统计口径见下方说明。

已结束的行程可以通过 更多选项 → 导出行程 输出 KML、GeoJSON 或 GPX 路线，也可以通过 分享行程 生成图片。它们不包含恢复完整行程所需的全部数据。

OBD 通过兼容适配器读取车辆控制器提供的参数，例如转速、水温、油温和燃油信息。每项参数保存读取请求、公式和单位，可使用匹配的预设导入，也可以编辑具体配置。

连接设备并取得有效参数后，可以在自定义仪表中选用它们。部分合适的数字参数还可以设置为速度、G 值或姿态等行程数据的来源，供内置仪表和记录使用。

车辆 OBD 连接需要 Plus 和支持 ELM327 指令的 BLE 适配器。可读取的项目随车型、年款、动力版本和车辆状态变化。OBD 文档说明连接、参数字段、数据有效性和接入规则。

自定义仪表使用 JavaScript 和 JSX 描述画面。CapDrive 调用脚本的 main() 读取本次输入，得到文字、图形、曲线等 View，再完成布局和绘制。数据或显示环境变化时，画面可以随之更新。

可以导入现成仪表文件，也可以在编辑器新建仪表、配置需要的数据和资源，编写并预览自己的内容。作品通过 .instrument 文件导入和分享；使用 OBD 的作品需要接入本机设备的相应参数。

自定义仪表文档提供完整速度示例、数据接口、布局动画、资源与分享说明。API 参考按用途列出绘制组件，并说明属性、类型、默认规则和可组合的示例。