認識 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 檔案，或用 CapDrive 開啟。匯入會安裝本機副本，之後仍需另行加入儀表板。 使用車輛參數的作品還需要接入自己的 OBD 資料。在儀表設定中選擇相應參數，並按作品使用的資料更新腳本引用。具體讀取方式見“儀表資料”。

自定義儀表文檔提供完整速度示例、資料接口、佈局動畫、資源與分享說明。API 參考按用途列出繪製組件，並說明屬性、類型、預設規則和可組合的示例。