Resolve Telemetry Overlay 用户指南

01系统要求与安装

需要 DaVinci Resolve 18.6.6 或更高版本（Free 与 Studio 均可）、macOS 12 或更高版本、Apple Silicon Mac。

1. 在下载页获取 DMG 并打开。
2. 完全退出 DaVinci Resolve。
3. 把「Resolve Telemetry Overlay Activator」拖入「应用程序（Applications）」。
4. 打开 Activator，点击「安装插件」，输入这台 Mac 的管理员密码。
5. 在同一窗口粘贴购买邮件中的许可证密钥，点击「激活当前 Mac」。
6. 重新启动 Resolve。可在 Preferences > Video Plugins 中确认插件已加载。

02激活与许可证管理

Activator 同时是插件与许可证管理器，提供「激活当前 Mac」「检查状态」「反激活当前 Mac」「重置许可证」。在时间线中选中任一遥测生成器，Inspector 里的「Open License Manager…」按钮也能直接打开它。

• 一个许可证最多同时激活 2 台属于你的 Mac。
• 一次成功联网刷新提供 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状态信息与故障排查

12卸载

打开 Activator，点击「卸载插件」。Activator 本身会保留，便于日后重装或反激活；如果不再在这台 Mac 上使用，记得先反激活以释放设备名额。