DataLayer Studio 機能説明・ユーザーガイド

最終更新：2026-07-16

対象バージョン：macOS 0.3.3

DataLayer Studio は、ランニング・サイクリング・アウトドアスポーツ動画のためのデータオーバーレイ制作ツールです。動画素材と .fit / .gpx アクティビティ記録をひとつのマルチトラックタイムラインに載せ、リアルタイムプレビューで速度・ペース・心拍・ルート・距離・天気などのコンポーネントを配置し、透明オーバーレイまたは合成済みの完成動画を書き出します。

このガイドは三部構成です：

機能説明：できること・できないことを先に把握する。
ユーザーマニュアル：新規プロジェクトから書き出しまでの完全な手順。
ケーススタディ：よくある撮影シナリオでの複雑なタイムラインの組み方と同期方法。

1. このアプリの用途

代表的な使い方：

レース回顧動画にルート・距離・ペース・心拍を重ねる。
トレーニング復習動画にケイデンス・パワー・ランニングダイナミクス・標高を表示する。
一回のアクティビティ中に散発的に撮影した複数クリップを、正しいアクティビティ時刻に戻して配置する。
透明 Alpha オーバーレイを書き出し、DaVinci Resolve・Final Cut Pro・Premiere で編集を続ける。
元動画・元音声・データオーバーレイを合成した完成動画を直接書き出す。
プロジェクト・レイアウトテンプレート・書き出しプリセットを保存し、次の動画で再利用する。

DataLayer Studio は「編集ロジックは標準、操作は軽量」という原則に従います。タイムラインは複数のビデオトラックとアクティビティトラック、クリップの移動・トリム・分割・コピー＆ペースト・複数選択・スナップ・トラックロック・取り消しに対応しますが、完全な NLE ではありません：

トランジション、速度変更、ピクチャインピクチャ、キーフレーム、マルチカムには未対応。
ビデオトラックが重なる場合、上のトラックの映像が全画面で下を覆います。
アクティビティトラックはデータオーバーレイ用で、二つの映像の合成には使いません。

2. 機能一覧

2.1 素材とプロジェクト

動画ファイルと .fit / .gpx アクティビティファイルをそれぞれ複数読み込み可能。
Finder で複数選択して読み込むと、選択順にタイムラインへ追加。タイムラインに内容がある場合はプロジェクト末尾に追加されます。
ファイルは Finder からメディアライブラリまたはタイムライントラックへ直接ドラッグできます。ライブラリへのドロップは登録のみ、タイムラインへのドロップは登録と同時にドロップ位置へ配置します。
動画とアクティビティファイルの両方に信頼できる記録時刻があれば、絶対時刻で自動的に整列します。読み込み順は結果に影響しません。
メディアライブラリは「使用中」の素材をマークし、オフライン素材は再リンクできます。
プロジェクトは専用の .dlsproj 形式で、素材参照・トラック・クリップ・レイアウト・書き出し設定・再生ヘッド位置・取得済みの天気データを保存します。旧版 .json プロジェクトも開けます。

2.2 標準的なマルチトラックタイムライン

ビデオトラックもアクティビティトラックも複数持てます。クリップは自由に移動でき、タイムラインの先頭・クリップ間・末尾に空白を置けます。
クリップは両端でトリムでき、トリムはソースのイン点・アウト点を変更します。
クリップはコピー・カット・ペースト・挿入ペーストに対応。空白部分の右クリックペーストもできます。
クリップの端はタイムライン先頭・赤い再生ヘッド・他クリップの端にスナップします。スナップはタイムラインツールバーでワンクリック切替。
Command 複数選択、再生ヘッド位置での分割、通常削除、リップル削除、取り消し/やり直しに対応。
, / . で選択クリップを 1 フレームずつ左右に微移動。Shift ドラッグでトラック移動時に水平位置を固定。
クリップは削除せず一時的に無効化できます。無効クリップはプレビュー・書き出し・編集点ジャンプの対象外です。
ビデオクリップは音声波形を表示し、動画のない区間は合成出力で無音になります。
FIT の一時停止はアクティビティ時間軸に保持され、停止中は直前の値を維持します。

2.3 データオーバーレイ

利用できるコンポーネント：

基本：速度、ペース、心拍、ケイデンス、カロリー、累積上昇、ストライド、パワー。
ランニングダイナミクス：上下動、接地時間、接地時間比、接地バランス、上下動比、呼吸数。
拡張指標：ペースロス、フォームパワー、エアパワー、レッグスプリングスティフネス。
ビジュアル：GPS ルート、距離数値、距離プログレス、時刻と日付、天気。

実際に表示できるかはアクティビティファイルのフィールド次第です。GPX は通常、時刻・位置・距離・速度のみで、完全な FIT にはより多くの指標が含まれます。

2.4 プレビューとキャンバス

動画・黒い空白・データオーバーレイは同じ一本のタイムラインでプレビューされます。動画がない場合は黒いキャンバス上のデータレイヤーです。
コンポーネントは直接ドラッグでき、複数選択・パーツ単位のサブ選択・スマートガイドのスナップに対応します。
「配置」メニューとコンテキストメニューでレイヤー順・整列・分布・スタイルのコピー/ペーストができます。
各アクティビティクリップはプロジェクトのデフォルトレイアウトを継承することも、独自のレイアウトと距離単位を持つこともできます。

2.5 書き出し

書き出しセンター（⌘E）はプリセット・設定・進捗・結果をひとつのウィンドウにまとめます：

透明オーバーレイ：常に透明背景を維持。エンコードは HEVC Alpha または ProRes 4444。
合成動画：動画がある区間は動画、データのみの区間は黒背景のデータレイヤー、何もない区間は純黒。エンコードは HEVC または H.264。
レンダー範囲は「タイムライン全体」（1 ファイル）または「個別のクリップ」（クリップごとに出力）。
内蔵プリセット 5 種。よく使う設定は「マイプリセット」に保存できます。

3. 始める前に

3.1 動作要件

Apple Silicon Mac。
macOS 13 Ventura 以降。
App Store 版は有効な購入記録が必要です。購入状態に問題がある場合は「購入を復元」を試してください。

3.2 素材のすすめ

動画：

元ファイルと元の作成日時をできるだけ保持してください。自動同期は撮影時刻メタデータに依存します。
横向き・縦向き・異なる解像度・異なるフレームレートを同じプロジェクトに混在できます。
プロジェクトが参照中のファイルを Finder で移動・削除しないでください。移動が必要な場合は後で「再リンク」を使います。

アクティビティデータ：

デバイスが書き出した元の FIT を優先してください。
GPX はルート・距離・速度・ペースには使えますが、心拍・パワー・ランニングダイナミクスは通常含まれません。
アクティビティファイルと動画は同じセッションのものを使ってください。
アクティビティ中に一時停止した場合、その実時間はタイムライン上に保持され、圧縮されません。

3.3 まず「二つの時間」を理解する

すべてのクリップには二つの時間系があります：

タイムライン時間：クリップがプロジェクトのどこに置かれているか。
ソース時間：クリップがソースファイルの何秒目から読み始めるか。

右側のクリップインスペクタには以下が表示されます：

タイムライン開始：編集可能。クリップ全体を正確に移動するために使います。
ソースイン点：読み取り専用。左のトリムハンドルで決まります。
長さ：読み取り専用。両端のトリムで決まります。

通常の同期はクリップを動かすだけで完了し、ソース自体を加工する必要はありません。

4. 画面構成

メインウィンドウは五つの領域に分かれます：

左の「ライブラリ」パネル：「素材 / コンポーネント / テンプレート」の三タブで素材の読み込み、コンポーネントの閲覧、テンプレートの管理を行います。
中央のプレビューキャンバス：現在時刻の最終画面を確認し、データコンポーネントを選択・ドラッグします。
プレビューコントロールバー：再生、一時停止、コマ送り、タイムコード、プレビューズーム、フルスクリーン。
下部のタイムライン：ビデオとアクティビティのクリップ配置、トラック管理、トリム、分割、コピー＆ペースト。
右のインスペクタ：データコンポーネント選択時はスタイルを、タイムラインクリップ選択時はクリップの時間とレイアウトを編集します。

ツールバーでライブラリ・タイムライン・インスペクタの表示/折りたたみを切り替えられ（⌥⌘1 / ⌥⌘2 / ⌥⌘3）、左右パネルの幅はドラッグで調整できます。右上の「出力」ボタンまたは ⌘E で書き出しセンターが開きます。同期・トリム・分割はすべてタイムライン上で直接行い、独立した「同期」や「トリム」ページはありません。

瞬時のメッセージ（保存完了、書き出し失敗の理由など）は右下のトーストで表示されます（最大 3 件、数秒で自動消滅）。完全な実行ログは「デバッグ > デバッグコンソールを表示」（⇧⌘D）にあります。

起動時はウェルカムウィンドウだけが表示されます：新規プロジェクト、既存プロジェクトを開く、最近のプロジェクトと「マイテンプレート」の閲覧、またはプロジェクト・動画・FIT・GPX をウィンドウの任意の場所へドロップ。アクティビティファイルを読み込むと、ウィンドウタイトルは「アクティビティ日付 + スポーツ種別」（例：「2026-07-05 ランニング」）を優先表示します。

5. はじめてのプロジェクト

ステップ 1：素材を読み込む

左の「ライブラリ > 素材」で：

ドロップゾーンまたは「ビデオを読み込む…」「アクティビティファイルを読み込む…」ボタンで素材を選ぶか、Finder からライブラリやタイムラインへ直接ドラッグします。
各行に長さが表示されるのを待ちます。動画は解像度も表示されます。
タイムラインに対応するクリップが現れたことを確認します。

動画メタデータと FIT/GPX の両方に信頼できる記録時刻があれば、実時刻に基づいて自動的に配置・同期されます。それでも明確なイベントで再生確認することをすすめます。記録時刻が欠けている・大きくずれている・トラックがロックされている場合は、後述の手動方法で調整します。

ショートカット：ビデオを開く ⌘O、アクティビティファイルを開く ⌘F。

ステップ 2：タイムラインを整える

新しい素材はデフォルトで末尾に追加され、素材ごとにトラックが自動作成されることはありません。できること：

クリップを左右にドラッグして位置を変更。上下にドラッグして同種トラックへ移動（Shift 押下で水平位置を固定）。
メディアライブラリから目的のトラック・時刻へ直接ドラッグ。
素材行の「タイムラインに追加」でプロジェクト末尾に新しいインスタンスを追加。

トラックを増やすには、タイムライン右上の「トラックを追加」からビデオトラックまたはアクティビティトラックを選びます。

ステップ 3：動画とアクティビティデータを同期する

同期の本質は、同じ出来事を両方の素材で同じタイムライン位置に置くことです。

最も一般的な方法：

動画内で明確なイベントを見つける（スタート、道路標識の通過、エイドステーション、コーナーなど）。
そのイベントが動画素材の何秒目に起きたかを確認。
同じイベントがアクティビティ記録の何秒目に起きたかを確認。
両方のイベントが赤い再生ヘッドの下に来るよう、動画またはアクティビティクリップをドラッグ。
イベント前後の数秒を再生し、距離・ルート・ペースの変化を確認。

正確に入力したい場合：クリップを選択し、クリップインスペクタの「タイムライン開始」に時・分・秒・ミリ秒を入力します。, / . での 1 フレーム単位の微調整もできます。

トリムしていないクリップの計算式：

アクティビティクリップのタイムライン開始
= ビデオクリップのタイムライン開始 + 動画内のイベント時刻 - アクティビティ内のイベント時刻

結果が負になる場合、クリップを負の時間に置かないでください。もう一方のクリップを後ろへ移動し、タイムライン先頭に空白を作れば済みます。

トリム済みのクリップは、インスペクタの「ソースイン点」で補正します：

アクティビティクリップ開始
= ビデオクリップ開始
 +（動画イベント時刻 - 動画ソースイン点）
 -（アクティビティイベント時刻 - アクティビティソースイン点）

ステップ 4：トリムと分割

トリム：

左ハンドルをドラッグ：ソースイン点とクリップ開始位置が変わります。
右ハンドルをドラッグ：クリップ終了位置が変わります。
ハンドルが赤い再生ヘッド・他クリップの端・タイムライン先頭に近づくとスナップし、ガイドラインが表示されます。不要なときはタイムラインツールバーでスナップを切れます。

分割：

赤い再生ヘッドを切りたい位置へ移動。
クリップを選択している場合、⌘B は再生ヘッド下の選択クリップだけを分割。
何も選択していない場合、⌘B は再生ヘッド下の編集可能な全トラックのクリップを分割。

DaVinci Resolve の一般的な操作ロジックと同じです。

ステップ 5：データコンポーネントを配置する

再生ヘッドをアクティビティデータのある位置へ移動。
「ライブラリ > コンポーネント」でダブルクリックして追加するか、キャンバスの目的の位置へドラッグ。
キャンバス上でコンポーネントをドラッグ。スマートガイドが他のコンポーネント・キャンバス中心線・セーフフレームへの整列を助けます。
右のインスペクタでレイアウト・スタイル・データ設定を調整。

最初はルート・距離・ペース・心拍だけに絞るのがおすすめです。情報の読みやすさを確保してから、ランニングダイナミクスや天気を足しましょう。

ステップ 6：書き出す

右上の「出力」または ⌘E で書き出しセンターを開く。
左の内蔵プリセットを選ぶか、右側でレンダーモード・サイズ・フレームレート・エンコード・ビットレートを直接調整。
保存先を選ぶ（「個別のクリップ」モードでは出力フォルダを指定）。
書き出しボタンを押すと進捗がその場に表示され、完了後は Finder で結果を確認できます。

6. タイムライン編集の詳細

6.1 選択と複数選択

クリップをクリック：そのクリップだけを選択し、右にクリップインスペクタを表示。
Command クリック：選択への追加・除外。
空白部分をクリック：選択解除。

複数選択したクリップは、移動・分割・削除・リップル削除・コピーを一括で行えます。

6.2 移動とトラック変更

水平ドラッグでタイムライン開始位置を変更。Shift 押下でトラック変更時に水平位置を固定。
垂直方向に同種トラックへドラッグすれば、移動とトラック変更を一度で完了。
ビデオはビデオトラックのみ、アクティビティはアクティビティトラックのみに配置可能。ロックされたトラックは受け付けません。
移動先に既存クリップがある場合、ドロップ位置に最も近い収まる隙間を探します。既存クリップを上書きしたり押し出したりしません。

6.3 コピー・カット・ペースト

⌘C でコピー、⌘X でカット。
⌘V で再生ヘッド位置にペースト。
⇧⌘V で挿入ペースト：ペーストと同時に、そのトラックの後続クリップを後ろへずらします。
タイムラインの空白部分を右クリックして「ペースト」を選ぶと、クリック位置にペーストされます。

6.4 スナップ

クリップの移動とトリムは、タイムライン先頭・赤い再生ヘッド・他クリップの先頭/末尾にスナップします。ヒット時はガイドラインとスナップ元の表示が出ます。特定の時刻に正確に合わせたいときは、先に再生ヘッドをそこへ置き、クリップの端を赤い線に吸着させます。タイムラインツールバーの磁石スイッチで一時的にオフにできます。

6.5 削除とリップル削除

⌫：選択クリップを削除し、空隙をそのまま残す。
⇧⌫：リップル削除。後続の内容を前へ詰める。
⌘Z 取り消し、⇧⌘Z やり直し。

通常の編集操作に確認ダイアログはありません。タイムラインで使用中のライブラリ素材の削除など、破壊的な操作のみ確認を求めます。

6.6 複数ビデオトラックの重なり

同じ時刻に複数のビデオトラックにクリップがある場合：

上にある有効なビデオトラックが下を覆います。
覆いが終わると、下の動画は自身の連続したソース時間から表示を再開します。
書き出しの音声も、その時点で見えているビデオクリップに追従します。

これは全画面の上書きであり、ピクチャインピクチャや透過合成ではありません。

6.7 複数アクティビティトラック

有効なアクティビティトラックはすべて合成に参加します。
トラックごとに別のアクティビティファイル・レイアウト・距離単位を使えます。
上のアクティビティトラックが最後に描画されるため、強調したいコンポーネントは上のトラックへ。
同一トラック内のクリップの重なりは避けてください。重なった場合はトラック内で最後にヒットしたクリップが優先されます。

6.8 トラック管理

トラックヘッダでは、名前変更・有効/無効・ロック/解除・空トラックの削除ができます。無効トラックはプレビューと書き出しに入りません。ロックされたトラックでは、クリップの移動・トリム・分割・削除・ドロップ受け付けができません。トラックが多い場合、トラック領域は縦にスクロールします。

6.9 クリップの一時無効化

クリップを選択して D を押すと、有効/無効が切り替わります。
無効クリップは暗くなりますが、元のトラックと位置に残ります。案の比較に便利です。
無効クリップはプレビュー・書き出し・編集点ジャンプ・書き出しプリフライトの対象外です。
クリップの無効化とトラック全体の無効化は独立したスイッチです。

6.10 ズームとナビゲーション

タイムライン右上のズームコントロール、またはトラックパッドのピンチで水平ズーム。ズームは赤い再生ヘッドを基準にします。
↑ / ↓ で前後の編集点へジャンプし、再生ヘッドが自動的にビューポートへ戻ります。
再生ヘッドはルーラー上のクリックやドラッグで直接動かせ、クリップの端付近でスナップします。

6.11 空白区間の画面ルール

タイムラインの状態	プレビュー / 合成動画	透明オーバーレイ
動画あり・データあり	動画の上にデータ	透明なデータレイヤーのみ
動画あり・データなし	元動画	完全に透明
動画なし・データあり	黒キャンバスにデータ	透明背景のデータレイヤー
動画なし・データなし	純黒キャンバス	完全に透明

したがってアクティビティクリップはビデオクリップよりずっと長くて構いません。アクティビティ全体を記録し、その一部だけ撮影クリップを挿入する場合の推奨構成です。

7. データコンポーネントとキャンバス

7.1 コンポーネントの追加と選択

「ライブラリ > コンポーネント」で全コンポーネントを閲覧・検索できます。ダブルクリックでデフォルト位置に追加、またはキャンバスの指定位置へドラッグ。インスペクタ上部の「追加」メニューも使えます。ソースデータがないコンポーネントは表示はされますが追加できません（GPS がなければルート不可、心拍フィールドがなければ心拍不可など）。

キャンバス上では：

クリックで選択、Command クリックで複数選択。
コンポーネント内のラベル・数値・単位などのパーツをクリックすると、そのパーツの編集に直接入り、インスペクタが対応するスタイル設定に切り替わります。

7.2 インスペクタとクイックコントロール

コンポーネントを選択すると、インスペクタはレイアウト・スタイル・データのセクションに分かれ、上部のクイックコントロール行には X/Y 位置・スケール・長さ（対応コンポーネントのみ）・表示スイッチが常時表示されます。調整できる項目：

位置、サイズ、長さ。
ラベル、単位、アイコン、カスタムテキスト。
パネル、枠線、不透明度、線幅。
フォント、フォントサイズ、色（パーツごとに設定可能）。
小数桁、ゲージ範囲、目盛り、天気アイコン。

距離系コンポーネント（距離数値、距離プログレス）のメートル/キロメートル単位も、それぞれのインスペクタで設定します。

7.3 配置・整列・スタイルの再利用

「配置」メニューとキャンバスのコンテキストメニューでは：

レイヤー：最前面へ、前面へ、背面へ、最背面へ（⌘⌥↑ / ⌘⌥↓ は前面/背面へ）。
整列：左、水平中央、右、上、垂直中央、下。
分布：水平分布、垂直分布（3 個以上の選択が必要）。
スタイルをコピー / スタイルをペースト：あるコンポーネントの外観を他へ素早く適用。
削除：選択全体に作用。

7.4 スマートガイド・グリッド・セーフフレーム

ドラッグ中、スマートガイドは他コンポーネントの端と中心、キャンバスの中心線と三分割線、セーフフレームにスナップします。
「プレビュー > グリッドを表示」は純粋に視覚的な参考グリッドです。行数・列数の設定はもうありません。
セーフフレームの内側マージンは「設定」で調整します（0–20%、デフォルト 5%）。コンポーネントが画面の縁に張り付くのを防ぎます。

7.5 クリップごとのレイアウト

アクティビティクリップを選択すると、インスペクタで：

そのクリップのメートル/キロメートル単位を設定。
「現在のレイアウトを使用」：現在のキャンバスレイアウトをそのクリップに保存。
「デフォルトレイアウトを使用」：プロジェクトのデフォルトレイアウトを継承。

7.6 レイアウトテンプレート

「ライブラリ > テンプレート」で、ユーザーレイアウトテンプレートの保存・適用・デフォルト設定・読み込み・書き出しができます：

書き出しは専用の .dlspreset 拡張子。読み込みは旧版 .json プリセットにも対応。
複数のレースで同じビジュアルを再利用、横向き/縦向きで別テンプレートを保持、別の Mac への移行に便利です。

テンプレートを適用すると現在のキャンバスレイアウトは置き換えられます。適用前に現在の変更を保存すべきか確認してください。アプリにテンプレートは内蔵されていません。ウェルカムウィンドウには自分で保存・読み込んだテンプレートだけが表示されます。

8. 天気コンポーネント

天気コンポーネントに必要なもの：

時刻と GPS を含むアクティビティファイル。
有効な OpenWeather API キー。
初回取得のためのネットワーク接続。

キー未設定のまま初めて天気コンポーネントを追加すると、アプリが設定ガイドを表示します。「API キーを取得」から OpenWeather アカウントを登録し、キーで One Call 4.0 を有効化（無料の日次枠あり）してから、キーをインスペクタに貼り付けて天気を更新します。新しいキーは有効になるまで時間がかかることがあります。キーはこの Mac にのみ保存されます。

取得に成功した天気データはプロジェクトにキャッシュされます。読み込み済みの天気はレンダリング中の回線断で失われることはなく、プロジェクトを開き直しても再取得は不要です。

天気コンポーネントを含むプロジェクトで、天気がまだ読み込まれていない・読み込み中の場合、書き出し開始時に確認が表示されます。天気が正しく表示されてから書き出すことをすすめます。不要と確信できる場合のみ続行してください。

9. 書き出しセンター詳解

⌘E または右上の「出力」で書き出しセンターを開きます。設定・進捗・結果はすべてこのウィンドウ内で完結します。

9.1 プリセット

左側はプリセット一覧です：

内蔵プリセット：透明オーバーレイ · ProRes 4444、透明オーバーレイ · HEVC、合成動画 · 4K HEVC、合成動画 · 1080p H.264、縦向き動画 · 4K HEVC。
マイプリセット：右側の現在の設定を名前を付けて保存し、再利用・削除できます。ユーザープリセットには具体的な解像度/フレームレート値が保存されます。

プリセット選択後も、右側で任意の項目を上書きできます。

9.2 透明オーバーレイと合成動画

透明オーバーレイを選ぶ場合：

この後カラーグレーディング・字幕・トランジション・速度変更を行う。
編集ソフトでデータレイヤーをいつでも非表示・差し替えしたい。
同じデータレイヤーを別バージョンの動画に重ねたい。

合成動画を選ぶ場合：

タイムラインが完成していて、他の編集ソフトに入りたくない。
元動画の音声を保持したまま、すぐ共有できるファイルが欲しい。

9.3 レンダー範囲

タイムライン全体：タイムライン全体を 1 本の連続ファイルとして出力。
個別のクリップ：合成動画はビデオクリップごと、透明オーバーレイはアクティビティクリップごとに出力。出力フォルダの指定が必要で、ファイルは連番になります。

タイムラインの一部だけを出力したい場合は、先にトリム・分割・削除でタイムラインを必要な内容に整えてください。

9.4 エンコードの目安

透明オーバーレイ：

HEVC/H.265 Alpha：ファイルが小さく、通常のポスプロに適する。
ProRes 4444：ファイルは大きいが、高品質の中間素材やより広いプロワークフローに適する。

合成動画：

HEVC/H.265：圧縮効率が高く、デフォルト推奨。
H.264：互換性が最も広く、再生機器の互換性重視の場面に。

9.5 サイズとフレームレート

プリセットは 3840×2160 から 720×1280 までの横/縦構成をカバーし、フレームレートは 23.976–60 fps。
カスタムサイズは「縦横比を固定」に対応し、幅を変えると高さが連動します。
動画がある場合は、ソースの解像度とフレームレートを優先するのが基本です。横/縦混在時は、各クリップが自身の向きのまま等比で縮小され中央配置、余白は黒になります。

9.6 ビットレート

デフォルトは 12000 kbps。目安：

1080p：8000–16000 kbps。
4K：30000–80000 kbps。
ProRes 4444 は配信用ビットレートの考え方では測れず、ファイルは大幅に大きくなります。

9.7 書き出し前プリフライト

書き出し前にアプリが確認する項目：

タイムラインに使用可能なビデオ/アクティビティクリップがあるか。
オフライン素材がないか。
クリップの読み取り範囲がソースを超えていないか。
エンコードが透明/合成モードに合っているか。
天気コンポーネントの準備が済んでいるか。
出力先に書き込み権限があるか。

ボタンが押せないときは、ボタン付近に表示される理由を確認してください。連打しても解決しません。

9.8 無料版の書き出し制限

Mac App Store 版は有料の製品版で、書き出しに制限はありません。
無料版（GitHub リリース、自分でビルドした版、コマンドラインツール）は編集とプレビューの全機能を利用できますが、書き出しは最大 1080p で、右下に「Made with DataLayer Studio」の透かしが入ります。
より高い解像度を設定した場合、無料版は書き出し時に 1080p 以内へ自動的に縮小し、書き出しパネルに案内を表示します。
Mac App Store で製品版を購入すると、フル解像度・透かしなしの書き出しが可能になります。

10. プロジェクトの保存・復元

10.1 保存

保存：⌘S。別名で保存：⇧⌘S。プロジェクトを開く：⇧⌘O。
プロジェクトはデフォルトで .dlsproj 拡張子。旧版 .json プロジェクトも開けます。
保存したプロジェクトは「ファイル > 最近使った項目を開く」に表示され、ウェルカムウィンドウからも開いたり場所を指定したりできます。

プロジェクトファイルに保存されるもの：

メディアライブラリと素材参照。
トラック名、有効・ロック状態。
クリップ位置、ソースイン点、長さ、レイアウト、距離単位。
書き出しサイズ、フレームレート、エンコード、ビットレート、レンダー範囲。
再生ヘッド位置と取得済みの天気データ。

出力先ファイルのパスはプロジェクトに保存されません。

10.2 プロジェクトの移動

プロジェクトファイルが素材と同じフォルダ（またはその親）にある場合、アプリは復元手段として相対パスを記録します。別マシンへ移すときは、プロジェクトと素材をひとつのフォルダにまとめてから丸ごとコピーするのがおすすめです。

10.3 オフライン素材の再リンク

素材ファイルが移動・改名・権限失効した場合：

メディアライブラリに「オフライン」と理由が表示されます。
リンクボタンまたは「再リンク…」をクリック。
正しい代替ファイルを選択。
アプリはまず動画メタデータの検証またはアクティビティファイルの解析を行います。
成功すると、元のクリップ位置・トリム・レイアウトはそのまま維持されます。

再リンクは取り消し/やり直しに対応します。誤ったファイルが元素材を黙って置き換えることはありません。

11. ケーススタディ

ケース 1：カメラが先、49 秒後にウォッチが記録開始

状況：動画は準備段階から始まり、ウォッチは動画の 00:49.000 で記録開始。

目標：最初の 49 秒は映像のみ（データ非表示）、49 秒以降にオーバーレイが動き出す。

手順：

ビデオクリップをタイムライン 00:00.000 に配置。
完全なアクティビティクリップを 00:49.000 に配置。
再生ヘッドを 49 秒に置き、アクティビティクリップの先頭を赤い線に吸着させる。インスペクタに 00:00:49.000 と入力してもよい。
45 秒から再生し、正しい瞬間にデータが現れることを確認。
合成動画では最初の 49 秒が元映像のみ。透明オーバーレイでは最初の 49 秒が完全に透明。

教訓：「同期のため」にアクティビティファイルの先頭をトリムしないこと。アクティビティクリップを 49 秒遅らせて置くのが最も自然な表現です。

ケース 2：アクティビティ開始の 5 分 30 秒後に録画開始

状況：ウォッチが先。動画の 00:00 はアクティビティの 05:30 に対応。

推奨構成：

完全なアクティビティクリップをタイムライン 00:00 に配置。
ビデオクリップを 05:30 に配置。
冒頭の黒背景データ区間を出力したくない場合は、アクティビティクリップの左ハンドルで先頭 5 分 30 秒をトリムし、両クリップを一緒にタイムライン先頭へ戻す。
5 分 30 秒のルート/データアニメーションを見せてから実写に切り替えたい場合は、そのままにする。

結果：

合成動画は 0–5:30 が黒背景のデータレイヤー、5:30 以降に映像が現れる。
透明オーバーレイは常に透明で、データのみ描画。

教訓：タイムラインは空白から始められるので、負のオフセットは不要です。遅れて登場する素材は、実際に登場する相対時刻に置くだけです。

ケース 3：長時間のアクティビティ、撮影は途中の三本だけ

状況：約 110 分の FIT に、名前順の三本の動画。動画間には大きな空きがあり、FIT には二回の一時停止がある。

推奨手順：

三本の動画を複数選択で読み込み、次に FIT を読み込む。記録時刻が信頼できれば自動的に正しい位置に配置される。
アクティビティクリップが実時間全体をカバーする状態を保つ。
各ビデオクリップの冒頭を再生し、交差点・ランドマーク・ウォッチの表示で同期を確認。必要なら , / . でフレーム単位の微調整。
動画は V1 に置けば十分。比較や一時的な上書きには V2 を使う。
FIT の一時停止部分を手動で切る必要はない。停止中は距離と速度が保持され、再開後に進み続ける。
完全な合成動画では動画のない区間が黒背景データレイヤーに、オーバーレイのみの書き出しではデータのない区間が透明になる。

教訓：アクティビティクリップは通常タイムラインで最も長いクリップで、動画はその中に散在する映像の証拠です。三本を無理につないで「偽の連続映像」にするより、実際のアクティビティ時間に忠実です。

ケース 4：DaVinci Resolve 用の透明データレイヤー

目標：編集・グレーディング・音声は DaVinci に残し、DataLayer Studio はデータレイヤーだけを作る。

手順：

DaVinci のタイムラインと同じ相対位置に、ビデオとアクティビティのクリップを配置。
書き出しセンターで「透明オーバーレイ · HEVC」を選択。高品質中間素材が必要なら「透明オーバーレイ · ProRes 4444」。
サイズとフレームレートを DaVinci プロジェクトに合わせる。
タイムライン全体を書き出す。
DaVinci で元映像の上のトラックにオーバーレイを置き、開始位置を揃える。

確認方法：

通常のプレーヤーで黒背景に見えても Alpha の失敗ではありません。
DaVinci の上位トラックで透過を確認してください。
オーバーレイに後から時間伸縮をかけないこと。データの同期が崩れます。

目標：同じアクティビティから複数の独立したショート動画を作る。

手順：

分割とトリムで複数のビデオクリップを整える。
各ショートに対応するデータトラックのカバー範囲を確認。
書き出しセンターでレンダー範囲「個別のクリップ」を選択。
出力フォルダを選ぶ。
合成動画はビデオクリップごとに、オーバーレイはアクティビティクリップごとに書き出されます。

教訓：ショートごとに異なるレイアウトが必要なら、各アクティビティクリップに「現在のレイアウト」を保存。スタイルが共通ならデフォルトレイアウトを継承させます。

ケース 6：別の Mac にコピーしたら素材がオフライン

手順：

.dlsproj プロジェクトを開く。
オフライン表示の素材ごとに「再リンク」をクリック。
新しいマシン上の対応する動画または FIT を選択。
クリップ位置・ソースイン点・レイアウトが維持されているか確認。
プロジェクトを一度保存し、新しいマシンでのアクセス権限を更新。

教訓：コピーの前にプロジェクトファイルと全素材をひとつのフォルダにまとめておくと、復元が最も簡単です。

12. キーボードショートカット

操作	ショートカット
ビデオを開く	`⌘O`
アクティビティファイルを開く	`⌘F`
タイムラインプロジェクトを開く	`⇧⌘O`
タイムラインプロジェクトを保存	`⌘S`
タイムラインプロジェクトを別名で保存	`⇧⌘S`
書き出しセンターを開く	`⌘E`
書き出しをキャンセル	`⌘.`
再生 / 一時停止	`Space`
プレビューを更新	`⌘R`
前 / 次の編集点	`↑` / `↓`
再生ヘッド位置で分割	`⌘B`
選択クリップの有効/無効	`D`
選択クリップをコピー / カット	`⌘C` / `⌘X`
ペースト / 挿入ペースト	`⌘V` / `⇧⌘V`
選択クリップを 1 フレーム左 / 右へ	`,` / `.`
削除（空隙を残す）	`⌫`
リップル削除	`⇧⌫`
クリップ / コンポーネントの複数選択	`Command` + クリック
取り消し / やり直し	`⌘Z` / `⇧⌘Z`
プレビュー拡大 / 縮小	`⌘+` / `⌘-`
プレビューズームをリセット	`⌘0`
プレビューをフルスクリーン	`⇧⌘F`
ライブラリ / タイムライン / インスペクタの表示切替	`⌥⌘1` / `⌥⌘2` / `⌥⌘3`
コンポーネントを前面へ / 背面へ	`⌘⌥↑` / `⌘⌥↓`
デバッグコンソールを開く	`⇧⌘D`

13. よくある質問

13.1 データと映像が合わない

確認の順序：

明確な一致イベントを一つ使う。「だいたい合っている」で済ませない。
アクティビティクリップとビデオクリップのタイムライン開始を確認。
クリップをトリムしていないか確認。トリム済みなら「ソースイン点」を考慮する。
FIT に一時停止が含まれていないか確認。アクティビティ時間と実時間は異なることがある。
一致点の前後 5–10 秒を再生して確認。

13.2 自動同期が働かない

自動同期は動画の撮影時刻メタデータとアクティビティファイルの開始時刻に依存します。トランスコード・編集ソフトからの再書き出し・チャットアプリからダウンロードした動画は、元の撮影時刻を失っていることが多いです。その場合は手動で合わせてください。編集ソフトが書き出した動画が自動同期を誤発動することはありません。

13.3 コンポーネントが `--` を表示する

考えられる原因：

アクティビティファイルに該当フィールドがない。
現在時刻がアクティビティクリップの範囲外。
そのアクティビティクリップが別のレイアウトを使っている。
天気が未読み込み、またはキャッシュが利用できない。

13.4 書き出した透明オーバーレイが黒背景に見える

多くのプレーヤーは Alpha を正しく表示しません。DaVinci Resolve・Final Cut Pro・Premiere の上位トラックで確認してください。ProRes 4444 でのクロスチェックも有効です。

13.5 書き出しボタンが押せない

書き出しセンター内の表示を確認してください。よくある原因：

タイムラインに該当タイプのクリップがない。
素材がオフライン。
クリップの読み取り範囲がソースを超えている。
透明モードで非 Alpha エンコード、または合成モードで Alpha エンコードを選んでいる。
出力先・出力フォルダが未選択。

13.6 合成動画の空白が黒いのはなぜ

これは仕様です。通常の動画に Alpha チャンネルはありません。動画のない区間は黒いキャンバスになり、そこにアクティビティデータがあれば黒の上に描画されます。透明背景が必要な場合は「透明オーバーレイ」を選んでください。

13.7 レンダリング中の回線断で天気が消えることはあるか

ありません。取得済みの天気はプロジェクトにキャッシュされ、そこから描画されます。リスクがあるのは、天気が一度も読み込まれないまま書き出しを始める場合だけで、その際はアプリが確認を求めます。

13.8 長い動画の書き出しが失敗する

確認事項：

出力先ディスクの空き容量。
出力フォルダの書き込み権限。
解像度・フレームレート・ビットレートが高すぎないか。
ソース動画をシステムが正常にデコードできるか。
デバッグコンソールの「書き出し」ログ。

DataLayer Studio はフレーム単位のストリーミング処理で、動画全体をメモリにキャッシュすることはありませんが、4K・長時間・ProRes 4444 には十分なディスク容量が必要です。

14. コマンドライン

GUI はマルチトラック編集に、CLI は自動化と既存プロジェクトの再利用に向いています。

14.1 単一動画 + 単一アクティビティファイル

swift run overlay \
  --video /path/to/run.mov \
  --fit /path/to/activity.fit \
  --output /path/to/overlay.mov

主なオプション：

--export-mode overlay|video
--width 1920 --height 1080
--fps 30
--codec hevc-alpha|prores-4444|hevc|h264
--bitrate 12000
--distance-unit km|m
--layout-preset "Race Layout"
--skip-fit-crc
--inspect

単一ソースの CLI は --fit-start、--sync-video / --sync-fit、旧版の --offset も受け付けます。これらは CLI の互換オプションであり、アプリに独立した同期ページがあるわけではありません。

14.2 タイムラインプロジェクトの書き出し

swift run overlay \
  --timeline-project /path/to/project.dlsproj \
  --output /path/to/output.mov \
  --export-mode video

--timeline-project 使用時は、--fit、--video、同期オプション、レイアウトプリセットを混用しないでください。プロジェクトのマルチトラック構造は同じコアレンダリングエンジンが読み取ります。

15. 書き出し前チェックリスト

使用中の動画とアクティビティファイルがすべてオンライン。
動画とアクティビティデータが少なくとも一つの明確なイベントで同期している。
FIT の一時停止区間の挙動が想定どおり。
上位ビデオトラックの重なりが正しい。
アクティビティクリップが正しいレイアウトと距離単位を使っている。
天気が読み込み済み、または不要と確認済み。
データコンポーネントが被写体・字幕・セーフエリアを隠していない。
タイムラインの内容がそのまま出力したい内容になっている（不要なクリップは削除または無効化済み）。
サイズ・フレームレート・エンコード・ビットレートが配信先に適している。
透明オーバーレイと編集ソフトのタイムラインの開始時刻が一致している。
出力先のディスク容量と書き込み権限が十分。
プロジェクトを ⌘S で保存済み。

長時間や 4K の書き出しの前にこのリストを確認すれば、ほとんどのやり直しを防げます。