LIGHTOUCH Resolve Telemetry Overlay

USER GUIDE · macOS + Windows x64

Resolve Telemetry Overlay 使用指南

依照實際工作順序整理的 macOS 與 Windows x64 完整說明。外掛介面目前為英文，以下使用「英文參數名 + 中文說明」對照。

01系統需求與安裝

需要 DaVinci Resolve 18.6.6 或更新版本（Free 與 Studio 皆可）、macOS 12 或更新版本的 Apple Silicon Mac，或 Windows x64。

macOS 正式版：DMG + Activator

  1. 在下載頁取得 DMG 並開啟。
  2. 完全結束 DaVinci Resolve。
  3. 把「Resolve Telemetry Overlay Activator」拖進「應用程式（Applications）」。
  4. 開啟 Activator，點擊「安裝外掛」，輸入這台 Mac 的管理員密碼。
  5. 在同一視窗貼上購買郵件中的授權金鑰，點擊「啟用目前的 Mac」。
  6. 重新啟動 Resolve。可在 Preferences > Video Plugins 確認外掛已載入。

Windows x64 正式版（本地自簽名）：手動 MSI

從Windows 下載頁取得 MSI 並手動安裝。Windows x64 正式版（本地自簽名）使用本地自簽名憑證，不受 Windows 公開信任鏈信任，可能出現 SmartScreen / Unknown Publisher。下載前請先確認來自官網並核對下載頁或 manifest 提供的 SHA-256；如果系統提供 More info → Run anyway，請自行決定並承擔風險。Windows 使用 windows-machine-v1；Windows x64 透過手動 MSI 安裝，ARM64 暫不支援。

02啟用與授權管理

Activator 同時是外掛與授權管理器，提供「啟用目前的 Mac」「檢查狀態」「解除啟用目前的 Mac」「重設授權」。在時間軸選取任一遙測產生器後，Inspector 中的「Open License Manager…」按鈕也能直接開啟它。

  • 一份授權支援 macOS 與 Windows x64，最多同時啟用兩台電腦（總數）。Windows 使用 windows-machine-v1，試用按裝置個別計時。
  • 一次成功連線更新提供 5 日租約加 5 日寬限，最長可連續離線使用 10 天。
  • 安裝、移除、啟用或解除啟用之後，都需要重新啟動 Resolve 才會生效。
  • 換電腦或跨平台切換：先在舊裝置解除啟用，再到新裝置啟用。舊裝置無法使用時，前往授權重設頁面以購買信箱驗證解除綁定。
  • 未啟用或授權失效時，產生器畫面會顯示啟用提示而不渲染資料。

03第一次使用：把儀表放上時間軸

  1. 在 Edit 頁把運動影片放在 V1，新增 V2 軌道。
  2. 開啟 Effects Library > OpenFX > Generators：Telemetry 群組是綜合 Resolve Telemetry Overlay，Telemetry > Gauges 裡是十一個獨立儀表。把需要的拖到 V2（或更高軌道）。
  3. 選取產生器片段，在 Inspector 點擊「Choose FIT File…」，選擇本機 .fit 檔案。Status 顯示 Ready: 1234.5 s（辨識出的運動總時長）即成功。
  4. 播放時間軸，數據即隨 FIT 變化。多個儀表可指向同一個 FIT 檔案，外掛只解析一次。

無需設定影格率：渲染時自動跟隨目前時間軸的影格率，之後變更時間軸 FPS 也不用重新設定。

04時間對齊：Activity Clip Start

「Activity Clip Start」的 Hours / Minutes / Seconds / Milliseconds 定義片段首格對應運動中的哪個時刻。例如設為 00:01:02.500，片段第一格就顯示運動第 62.5 秒的數據。

  • 剪輯語義與一般素材一致：整體移動片段不改變對應；把左側入點向右修剪，首格對應的運動時刻相應前進；右側出點只決定圖層何時結束。
  • 對齊技巧：在影片中找一個可辨認的瞬間（如出發、過橋），確認它在運動資料中的時刻並填入即可。
  • 播放頭超出運動資料時長範圍時，儀表輸出全透明。

05十一個獨立儀表

Pace 配速、Speed 時速、Cadence 踏頻、Power 功率、Calories 卡路里、Activity Time 運動時間、Clock Time 現實時鐘、Distance 距離、Distance Progress 距離進度、Route GPS 軌跡、Weather 天氣。每個都是獨立的透明產生器，只放你需要的。

  • 位置、縮放、旋轉與關鍵影格一律使用 Resolve 原生 Transform（Inspector > Video > Transform）控制，外掛內不重複提供。
  • FIT 中沒有對應欄位時（例如沒裝功率計時的 Power），該儀表輸出全透明，不會報錯。
  • Clock Time 專屬「Clock Format」（24 小時 / 12 小時制），依這台 Mac 的系統時區顯示。
  • Distance Progress 專屬 Length / Track Color / Line Width / Knob Size，顯示目前距離相對活動總距離的進度。
  • Route 專屬 Completed Color / Remaining Color / Line Width / Marker Size；軌跡等比繪製，已完成部分高亮，進度點隨播放頭移動。Route 沒有文字類參數。

06樣式參數：Content / Typography / Appearance

Content

  • Units：公制 / 英制切換，僅 Pace、Speed、Distance、Distance Progress、Cadence、Power、Calories 提供。
  • Label Text / Unit Text：覆寫預設標籤與單位文案；Show Label / Show Unit 控制顯示與否。

Typography

  • Label、Value、Unit 三段文字各自獨立設定 Size（0.5–4 倍）、Font（Helvetica Neue、Avenir Next、Menlo、Arial）與 Weight（Regular / Medium / Bold）。

Appearance

  • Text Alignment（左 / 中 / 右）；Value / Label / Unit Color 分別調色。
  • 面板：Show Panel、Panel Color、Panel Opacity、Corner Radius、Padding。
  • 邊框與強調線：Show Border、Border Color、Border Width、Show Accent Line、Accent Line Width。
  • Opacity：該儀表整體不透明度。顏色與數值參數均支援 Resolve 關鍵影格。

07綜合 Overlay：一個產生器放下整套儀表板

Resolve Telemetry Overlay 內含 8 個元件：Top Progress 頂部距離進度條、Route 軌跡、Pace、Heart Rate 心率、Cadence、Calories、Weather、Time & Date 時間日期。預設版面：頂部進度、左上軌跡、左下 PACE / HR / CAD / CAL 四個資料塊、右下天氣與時間日期。

  • 每個元件一個摺疊參數組：Enabled 顯示與否、Position（0–1 畫面相對座標）、Scale、Opacity，以及與獨立儀表相同的文字、字體、顏色、面板參數。
  • 全域參數：Global Opacity 與 Units 作用於全部元件。
  • Top Progress 專屬：Length 長度、Track Color 底軌顏色、Line Width 線寬、Knob Size 滑塊大小。
  • 心率元件目前只在綜合 Overlay 中提供；獨立的 Power、Distance、Activity Time、Clock Time 則不在綜合 Overlay 內——兩者可以疊加使用。

08版面預設（.rtolayout）

  • 「Save Layout…」把目前全部元件的版面與樣式存為 .rtolayout 檔案；「Load Layout…」載入還原。
  • 「Set Current as Default」把目前版面設為本機預設：重新啟動 Resolve 後，新增的綜合 Overlay 直接套用；既有實例不受影響。
  • FIT 檔案路徑與 OpenWeather API Key 永遠不會寫入版面檔案，可放心分享。
  • 版面檔案與外掛參數版本綁定，版本不符時載入會明確提示。

09天氣疊加（OpenWeather）

  1. 自備一組可存取 One Call（One Call by Call）的 OpenWeather API Key；帳號、用量與可能的費用不包含在本產品內。
  2. 在 Weather 儀表或綜合 Overlay 的 Weather 組填入 Key。Key 儲存在本機目前使用者下，所有 Weather 實例共用，新實例自動帶出。
  3. 選擇含 GPS 與時間戳的 FIT 後自動查詢該活動時段的歷史天氣；「Refresh Weather」可強制更新。
  4. 溫度與濕度隨播放頭對應的運動時刻變化；Temperature / Detail 覆寫欄位可手動指定顯示文案。

隱私提示：啟用天氣時，外掛會把從 FIT 擷取的經緯度、活動時間與該 API Key 傳送給 OpenWeather；除此之外全部功能均在本機完成。

10輸出

  • 疊加在影片上直接出片：在 Deliver 頁照常輸出即可，無需特別設定。
  • 單獨輸出透明遙測圖層（供其他軟體合成）：停用影片軌，Format 選 QuickTime、Codec 選 Apple ProRes 4444、開啟 Export Alpha、Alpha 模式選 Premultiplied。

11狀態資訊與疑難排解

現象 / Status含義與處理
Select a FIT file.還沒有選擇 FIT 檔案。
Ready: 1234.5 s正常。數字是辨識出的運動總時長（秒）。
Error: …FIT 無法解析。確認檔案是裝置匯出的完整 .fit，用「Choose FIT File…」重新選擇。
Activation required…授權未啟用或已失效。開啟 License Manager 啟用或連線更新，然後重新啟動 Resolve。
某個儀表完全透明該 FIT 缺少對應欄位（如無功率計），或播放頭超出運動資料時長範圍。
更換了 FIT 檔案內容但畫面沒變外掛會快取解析結果。用「Choose FIT File…」重新選擇一次該檔案即可強制重載。
Enter an OpenWeather API key.天氣功能需要先填入 API Key。
Select a FIT file with GPS and timestamps.目前 FIT 缺少 GPS 或時間戳，無法查詢天氣。
Updating weather… / Updated: 21°C, 63%.天氣更新中 / 已更新（Loaded 表示命中本機快取）。

12移除

macOS

開啟 Activator，點擊「移除外掛」。Activator 本身會保留，方便日後重新安裝或解除啟用；若不再於這台 Mac 使用，記得先解除啟用以釋放裝置名額。

Windows x64

透過 Windows 系統的應用程式設定或 MSI 解除安裝入口移除安裝。若不再使用這台電腦，記得先解除啟用以釋放跨平台共用的裝置名額。

仍需要協助？

如果本指南沒有解決問題，請透過 LIGHTOUCH 聯絡頁面與我們聯絡。

聯絡我們