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 天气。每个都是独立的透明 Generator，只放你需要的。

  • 位置、缩放、旋转和关键帧一律使用 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 联系页面与我们联系。

联系我们