GPX（時刻付きの経路ファイル）とMark（覚えておきたい瞬間の日時とコメント）から、長い録画の好きな場面へ。映像と音声を再エンコードせず必要な部分を無劣化で素早く切り出します。切り出した後も、撮影時刻と記録の対応を保ちます。
私が道具を作る中で直面した課題と、対応策・理由を載せています。必要なら、その内容をもとに自分の道具をAIと作るための設計と指示を使えます。
動画自体に位置・高度・速度を埋め込めていることは前提にしません。撮影時刻にどこにいたかはiPhoneが知っています。撮影時刻と切り出し位置の対応を残し、GPXから場所をたどれる形を目指します。
設計の模式図です。時刻と場面は例示です。
動画にGPSがなくても。撮影時刻から、同じGPXとMarkへ戻れる。
以下は私がCut/Editを作る中で直面した課題です。どの操作で困り、何を変え、なぜその方法を選んだかを示します。自分のカメラや素材に合う道具を作るときは、必要な課題から条件を選べます。
撮った動画を後日Macへコピーすると、ファイルの作成日時が撮影日を表さない場合があります。名前も利用者が変更できます。
Vroma Studioで時計を合わせた情報をCutやEditでも使いたいとき、同じ名前の別録画へ補正を当てるとMarkの位置がずれます。
カメラが長い録画を複数ファイルに分けると、続きの場面を見るためにファイルを切り替える必要があります。
INSVをInsta360 Studioで編集するとき、VromaのMark日時だけではファイルの何分何秒を開けばよいか分かりません。
同じ瞬間から複数の範囲を残すと、日時から作った保存名が同じになります。同時に別の処理がその名前を使う場合もあります。
動画には前のフレームの情報を使って再生する部分があり、そこだけを先頭にすると再生できない場合があります。
カメラの動画には複数の音声トラックが入ることがあります。最初の一つだけを保存すると、別の音声が残りません。
ファイルの存在だけでは、選んだ映像・音声が欠けずにコピーされたか判断できません。
MP4を組み直すと、映像・音声のコピーだけではカメラ独自の付加情報が出力へ残らないことがあります。
Macでコメントを開いている間に、別端末が同じCSVのコメントを直す場合があります。
複数の録画に同じ場面があると、どちらを残すか見比べたくなります。
コメントや出力動画が保存されても、調整中の候補や動画内に追加したMarkまで保存されたとは限りません。
好きな場面を切り出したいときに使う道具の設計です。
GPXとMarkから候補を見つけ、残す範囲を確認します。
記録した瞬間を切り出し候補に。映像を確認して、残す前後の範囲を選びます。
映像と音声の圧縮済みデータを残す設計。再生可能な境界に合わせて範囲が広がる場合は、実際の保存範囲を確認します。
切り出し済みの素材から、さらに必要な部分へ。原本のどの場面かを引き継ぎ、GPXとMarkへの対応を失わないことを検証します。
ここに書くのは、AIと自分用の道具を作るための設計案です。完成アプリの機能一覧ではありません。「守る要件」はこの設計の中心となる動作と、記録を壊さず対応を保つ条件です。「便利機能の提案」は必要なものを選ぶ候補で、全部を実装する条件ではありません。実装言語や映像処理の方式は指定しません。
撮影した場面と経路・Markを対応させるには、時刻の意味と参照元を残す必要があります。UTCで日時を比べることや、秒数を整数の組で保存することは一般的な方法です。Vromaのファイルと連携するときだけ、下の独自形式も使います。
GPXは経路を保存する標準形式です。VromaはGPX 1.1を使います。Topografixの公式仕様 ↗に形式の定義があります。動画との対応には、位置だけでなく観測日時のある点が必要です。
Markは瞬間の日時とコメントです。Vromaでは同じフォルダの「旅.gpx」と「旅.marks.csv」のように名前を対応させます。動画をこのフォルダへ移す必要はありません。
動画のある瞬間の日時は、カメラが記録した開始日時に、時計の補正秒数と動画内の位置を足して求めます。カメラが2秒遅れていたなら＋2秒です。表示を日本時間から別地域へ変えても、同じ瞬間を表す日時そのものは動かしません。
補正を適用済みの切り出し動画へ、同じ補正をもう一度足してはいけません。開始日時が読めない素材は不明と示し、名前やコピー日から撮影日時を決めません。
切り出しや作品編集は動画原本を変更せず、使用した範囲や追加表示を別に保存します。短い素材の0秒が原本の何秒目かを残せば、同じMarkと場所へ戻れます。
コメント編集は、自分の道具で必要な場合に採用します。採用する場合は、読み込んだMarkの参照元を追跡し、利用者が入力した変更だけを保存します。別端末の変更と競合したら勝手に上書きせず、両方を残して確認します。参照するだけで記録を書き換えません。保存はボタンでも自動保存でも構いませんが、その動きを利用者へ示します。
UTF-8、ヘッダーなしの3列です。第1列はUTCのISO 8601日時、第2列は時差付きの現地日時、第3列はコメント。小数秒を残し、カンマ・引用符・改行のあるコメントはCSVの引用で保存します。時刻を比べるときは第1列を使います。第2列は同じ瞬間の表示であり、別の時計補正ではありません。
このCSVにID列はありません。読み込む側が識別値を作ります。Cutは解析した日時の秒数とコメント、Editは第1列の日時文字列とコメントを使うため、両者のIDは常に同じとは限りません。IDは読み込み後のProjectや出力の対応情報に現れます。同じ瞬間を照合するため、参照元・日時・コメントも残します。出力にIDが付いている場合はその値を引き継ぎます。
補正を保存するのはStudioです。選んだ動画の場面をMarkの日時へ合わせて補正秒数を保存し、Cut/Editはこのファイルを読み込んで利用します。通常の保存先は動画フォルダで、別の場所なら利用者が明示的に読み込みます。
schemaVersion: 1のentriesに、対象のsource、補正秒数seconds、任意の表示名cameraNameを保存します。sourceは末尾の名前filename、バイト数size、補正前の開始日時cameraStart、秒単位の長さdurationです。cameraStartの数値は1970-01-01 UTCからのUnix秒です。
名前とサイズは一致、開始日時の差は1ms未満、長さの差は0.25秒以内のときだけ補正を使います。改名するとこの一致を失います。これは時計差を自動測定する処理でも、動画の全内容を比較する処理でもありません。Studioには内部日時が読めないときにファイルの作成日時を使う経路があります。Cutでも利用者が選択した場合にファイルの作成日時を使えます。使用する日時やコピー後のファイル日時によって、アプリ間で開始日時が一致しない場合があります。形式不正や曖昧な一致はエラーにします。
既存Cutの出力形式と連携するときは、MP4とこの対応ファイルを同じ出力フォルダに残します。CutはschemaVersion: 1を書き、Editは1と2を読みます。clipsのoutputFileが出力名、creationDateが出力の最初の実フレームに対応する補正後の撮影日時です。原本の開始日時や希望した開始日時とは限りません。
requestedは希望した範囲、actualは再生できる境界へ広げた実際の範囲です。どちらも切り出す前の原本、またはまとめた録画内の位置であり、出力の0秒を基準にした範囲ではありません。整数valueを時間単位timescaleで割ると秒になります。Editは両範囲の差から、出力内で希望部分が始まる位置を求めます。
この対応ファイルの数値日時は2001-01-01 UTCを基準にした秒数で、VromaMedia.jsonのUnix秒とは基準が違います。EditにはISO 8601文字列を読む経路もあります。表示用タイムゾーンを変えても絶対日時へ再び時差を足しません。
任意のmarksには識別値id、UTCのISO 8601日時date、comment、出力動画内の秒位置sourceTimeがあります。Mark情報のない出力は元のGPXとMark CSVを併用します。自分の道具が既存Cut/Editと連携しない場合、同じ形式を採用することは必須ではありません。
Vromaの停止拡張は、OSが確認した有限の停止区間を、すでにある実測点に添えるものです。観測していない時刻に新しい位置の点を追加するための形式ではありません。通常のGPX二点の近さから停止を推定する方法とは区別します。
実測点のtrkptの直下にあるextensionsへ、名前空間https://www.tsuyukimakoto.com/xmlns/vroma/gpx/1のstationary要素を一つ置きます。開始fromと終了untilはその要素の属性で、現行の書出しは小数秒付きのUTC ISO 8601日時です。たとえば<vroma:stationary from="2026-10-07T01:00:00.000Z" until="2026-10-07T01:02:00.000Z" />です。vromaの接頭辞は上の名前空間へ宣言します。実測点の時刻≦from＜untilを満たし、次の観測があればそこまでに制限し、終了時刻自体は区間へ含めません。接頭辞のつづりでなく名前空間と要素名で読み、不正・重複の宣言を停止の根拠にしません。推定値を観測点としてGPXへ書き戻しません。
まず、このページのURLをAIへ渡し、課題・対応策・理由と設計条件を読んでもらいます。目的と、記録のコピーを読める場所や方法を添えてください。AIがURLを取得できない場合は、本文をコピーして渡せます。
ローカル表示です。変更後の本文はまだ公開されていません。AIへ渡す場合は本文コピーを使ってください。
下の指示は相談の始め方です。URLが読めないときは「課題と設計の本文をコピー」で本文も渡してください。
次の課題・対応策・理由と設計条件を参考に、私のカメラ・素材・作業環境に合う自分用の道具を作ってください。 https://www.tsuyukimakoto.com/products/vroma/cut/ URLを取得できない場合は、私が渡す本文を使ってください。既存の対応策は作者の実装例なので、同じ言語や映像処理方式を必須にせず、選ぶ方法と理由を説明してください。 作りたい道具と用途：［指定］ カメラ・素材形式・OSと作業環境：［指定］ 残したいMarkや範囲：［指定］ 記録のコピーの保存場所と、AIが読める方法：［指定］ 既存Cut/Edit出力との互換性：［必要な場合だけ指定。通常は前提にしない］ まず課題から必要な条件を整理し、未知の条件は推測せず示してください。設計と実装、小さなコピーでの確認を進めてください。 動画原本を変更しないでください。コメント編集は必要な場合に採用し、採用する場合は参照元を追跡して利用者が入力した変更を保存し、同時変更を勝手に上書きしないでください。UTC比較は一般の時刻処理、Vroma独自形式は選んだ連携に応じて使ってください。 同じMarkと場面、時計補正、欠測、希望範囲と実保存範囲、再切り出し後の対応を確認してください。実装したこと、未対応条件、確認結果を分けて示してください。
課題と対応策は全項目の一覧でも読めます。本文コピーはこのページの掲載範囲です。全一覧も使う場合は、そのURLか本文を併せて渡してください。
原本は保存したまま、小さな範囲のコピーから。
使えることと、まだ扱えないことを確かめます。
| 確認すること | 自分の記録で見る結果 |
|---|---|
| 同じMark、同じ場面 | 自分のMarkが元の動画のどの場面かを確認する。時計差の補正や再切り出しの後も、同じ撮影時刻とGPXへの対応が保たれている。 |
| 動画にGPSがない | 位置や高度を持たない自分の動画でも、撮影時刻から持ち帰ったGPXを参照できる。時刻が読み取れない場合は、推測で埋めずに示す。 |
| 原本と、保存する範囲 | 原本を残し、コピーだけで確認する。希望した範囲と実際に保存した範囲を区別し、映像と音声を再生して確認する。GPX欠測や範囲外は不明として扱う。 |
| 切り出した動画を読み直す | 保存した動画と対応情報を読み直し、同じMarkが同じ撮影時刻を指すことを確認する。作業候補の保存・再開とは区別する。 |
| コメント編集を採用する場合の保存と同時変更 | コメント編集を採用する場合に確認する。参照するだけでは記録が変わらず、入力した変更は示された保存方式で指定の参照元へ反映される。別端末と同じMarkを違う文へ直した場合は上書きを止め、両方の内容を確認できる。 |
手元の写真や動画を見返すならChrova。動画を作品にまとめたいときはEditの設計を読めます。