Resolve Telemetry Overlay ユーザーガイド

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…」ボタンから直接開くこともできます。

• 1 つのライセンスで macOS と Windows x64 をサポートし、同時に有効化できるのは合計 2 台までです。Windows は windows-machine-v1 を使用し、トライアルはデバイスごとに独立します。
• オンライン更新が 1 回成功するごとに 5 日間のリースと 5 日間の猶予が付与され、最長 10 日間連続でオフライン利用できます。
• インストール、アンインストール、有効化、解除の後は Resolve の再起動が必要です。
• コンピューターまたはプラットフォームの変更：旧デバイスで有効化を解除してから新デバイスで有効化します。旧デバイスが使えない場合はライセンスリセットページで購入時のメールアドレスを確認してください。
• 未有効化またはライセンス失効中は、ジェネレーターはデータの代わりに有効化を促す表示を描画します。

03はじめて使う：ゲージをタイムラインへ

1. Edit ページで映像を V1 に置き、V2 トラックを追加します。
2. Effects Library > OpenFX > Generators を開きます。Telemetry グループが統合版 Resolve Telemetry Overlay、Telemetry > Gauges が 11 種の単体ゲージです。必要なものを V2（またはそれより上のトラック）へドラッグします。
3. ジェネレータークリップを選択し、Inspector の「Choose FIT File…」からローカルの .fit ファイルを選びます。Status に Ready: 1234.5 s（検出されたアクティビティの長さ）と表示されれば成功です。
4. タイムラインを再生すると FIT データに合わせて値が変化します。複数のゲージが同じ FIT を参照でき、解析は 1 回だけ行われます。

フレームレートの設定は不要です。レンダリング時に現在のタイムラインのフレームレートへ自動追従し、後から FPS を変えても再設定は要りません。

04時間合わせ：Activity Clip Start

「Activity Clip Start」の Hours / Minutes / Seconds / Milliseconds で、クリップの先頭フレームがアクティビティのどの瞬間に当たるかを指定します。00:01:02.500 に設定すると、先頭フレームはアクティビティ開始から 62.5 秒時点のデータを表示します。

• 編集の挙動は通常素材と同じです。クリップ全体の移動では対応関係は変わらず、左のイン点をトリムすると先頭フレームの時刻が進み、右のアウト点はレイヤーの終わりだけを決めます。
• 合わせ方のコツ：映像内の分かりやすい瞬間（スタート、橋の通過など）を見つけ、アクティビティ内での時刻を割り出して入力します。
• 再生ヘッドがアクティビティの長さの範囲外にあるとき、ゲージは完全に透明になります。

0511 種の単体ゲージ

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 の 3 つのテキストごとに 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統合オーバーレイ：1 つのジェネレーターでダッシュボード一式

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。
• 心拍は現在、統合オーバーレイ内のみで提供します。単体の Power、Distance、Activity Time、Clock Time は統合版には含まれません。両者は自由に重ねられます。

08レイアウトプリセット（.rtolayout）

• 「Save Layout…」で全コンポーネントの配置とスタイルを .rtolayout ファイルに保存し、「Load Layout…」で復元します。
• 「Set Current as Default」は現在のレイアウトをこの Mac の既定に設定します。Resolve 再起動後、新規追加した統合オーバーレイに適用され、既存インスタンスは変わりません。
• FIT ファイルのパスと OpenWeather API キーはレイアウトファイルに書き込まれないため、安心して共有できます。
• レイアウトファイルはプラグインのパラメータバージョンに紐づき、不一致の場合は読み込み時に明確なエラーを表示します。

09天気オーバーレイ（OpenWeather）

1. One Call（One Call by Call）にアクセスできる OpenWeather API キーを各自で用意します。アカウント・利用量・発生しうる費用は本製品には含まれません。
2. Weather ゲージまたは統合オーバーレイの Weather グループにキーを入力します。キーはこの Mac の現在のユーザーに保存され、すべての Weather インスタンスで共有・自動入力されます。
3. GPS とタイムスタンプを含む FIT を選ぶと、アクティビティ期間の過去の天気を自動取得します。「Refresh Weather」で強制更新できます。
4. 気温と湿度は再生ヘッドに対応するアクティビティ時刻に追従します。Temperature / Detail の上書き欄で表示文言を手動指定することもできます。

プライバシー：天気を有効にすると、FIT から抽出した緯度経度・アクティビティ時刻・API キーが OpenWeather に送信されます。それ以外の機能はすべてローカルで完結します。

10書き出し

• 映像に重ねてそのまま書き出す場合：Deliver ページで通常どおり書き出すだけです。特別な設定は不要です。
• 透明なテレメトリーレイヤーのみ書き出す場合（他ソフトで合成する用途）：映像トラックを無効化し、Format は QuickTime、Codec は Apple ProRes 4444、Export Alpha を有効、アルファは Premultiplied を選択します。

11ステータス表示とトラブルシューティング

12アンインストール

macOS

Activator を開き、「プラグインをアンインストール」をクリックします。Activator 本体は再インストールや有効化解除のために残ります。この Mac で使わなくなる場合は、先に有効化を解除して共有スロットを空けてください。

Windows x64

Windows のアプリ設定または MSI のアンインストール項目から削除します。このコンピューターを使わなくなる場合は、先に有効化を解除して共有スロットを空けてください。