動画をファンスクリプトに変換する

開ける動画ファイル

Open Video のダイアログには MP4、MKV、AVI、MOV、WMV が表示され、All Files のオプションもあります。ドラッグ＆ドロップ、Batch Generate Folder、Play Folder as Playlist では WebM と M4V も使えます。

決まったコーデックのリストはありません。解析では、アプリは OpenCV に組み込まれた FFmpeg でデコードし、まずハードウェアデコード（グラフィックドライバーが提供するアクセラレーター）を試み、コーデック、ドライバー、または最初のフレームがうまくいかない場合はソフトウェアデコードに切り替えます。再生には、専用ウィンドウに埋め込んだ VLC を使います。つまり、その FFmpeg とインストール済みの VLC で読めるファイルなら再生も変換もできます。コーデックのリストはテストも公開もしていません。

VR 映像にも対応します。解析前に、アプリはサイドバイサイドまたはトップボトムのレイアウトと、魚眼または正距円筒図法の投影を検出し、片目の中央部分を通常の平面映像に補正します。この検出は、いくつかのサンプルフレームに基づく経験的な判定です。

動画に何が起きるか、順を追って

以下はすべてあなたの PC 上で実行されます。解析コードにはネットワーク呼び出しが含まれておらず、動画、フレーム、サムネイルがインターネットに送信されることはありません。

1. デコードとサンプリング。 Accuracy によって解析するフレームが決まります：Fast では 4 フレームごと、Balanced（デフォルト）では 3 フレームごと、High では 2 フレームごと。サンプリングした各フレームは、元の解像度にかかわらず幅 320 px に縮小されます。ワーカースレッドが先行してデコードするため、デコードと解析が並行して進みます。
2. 動きの領域を見つける。 自分で領域を指定していない場合、エンジンは動きが繰り返し起きている場所のヒートマップを作り、最も動きの多い領域を選んで 15% 広げます。シーンの切り替わりは、フレーム間の急な変化から検出します。
3. 動きを計測する。 DIS オプティカルフローで領域内の動きを計測します。姿勢推定モデルと深度モデルがインストールされていれば、体のキーポイントと、カメラに近づく／遠ざかる動きの読み取りが、位置信号の候補として加わります。バックグラウンドでは、動画自体のモーションベクトルとサウンドトラックの音量エンベロープも読み取りますが、それぞれ時間制限があるため、長い動画では一部しか対象にならないことがあります。
4. 位置の軌跡を作る。 計測した動きを積分して時間ごとの位置にし、その動画で最もスコアの高かった位置信号から作ったアンカーと統合します。トラッキングが途切れた部分は、周囲のストロークのリズムを引き継いだ動きで埋め、音声にビートがあればそれに合わせます。2 回目のパスで、印を付けた区間をいくつか（最大 4 つ）フルフレームレートで読み直すことがあります。
5. ポイントを配置する。 2 秒ごとの区間を動きの種類でラベル付けし、ストロークの大きさは、選んだ強さのカーブ（デフォルトは Smoothed）を通して、映像の動きの速さに従います。ポイントは方向が変わるたびに配置されるため、ポイントのレートは一定ではありません。
6. 保存する。 スクリプトは動画の隣に書き出されます（次のセクション）。

フロー、姿勢推定、深度の各部分について詳しくは、各段階を支える AI モデルで説明しています。

うまく変換できる映像と、できない映像

エンジンは計測した動きをもとに動作するため、スクリプト化したい動きが画面の中で主に動いているもので、見え続けているときに最もうまくいきます。

うまく変換できる

• 画面の 1 か所で、はっきりした動きが繰り返されている。モーションのヒートマップが捉えるのはまさにそれです。
• リズムが一定。欠落部分の補完とリズムの整理は周囲のストロークを頼りにするため、規則的な動きなら短い途切れがあっても保たれます。
• ゆっくりから中程度のペース。ゆっくりしたシーンでは、ストロークの大きさが手作りのスクリプトに近くなります。

うまく変換できない場合と、その対処法

• 他のものの方が大きく動いている。 領域の検出は最も強い動きを追うため、目的の部分でないことがあります。Set Motion Region… で自分で領域を指定するか、Live Track で動画の再生中にボックスを動かしてください。トラックは動画の隣に .roitrack.json ファイルとして保存されます。
• アクションが隠れている。 トラッキングが途切れると、その部分は計測ではなくリズムで補完されます。補完した割合は記録され、それが高くなると品質レポートが警告します。
• とても速い動き。 速いシーンではストロークが小さくなりすぎ、サンプリングレートが低いほどその傾向が強くなります。High を試すか、タイムラインでその区間を Amplify してください。
• アクションのない長い区間。 アクションの外にあるイントロやクレジットは静止したまま保たれますが、アクションの中では、人ならスクリプトを止めておく場所でも、エンジンがストロークを生成し続けることがよくあります。タイムラインでそれらのポイントを削除してください。
• ほとんど静止している動画。 実際の動きがあるサンプルが 5% 未満の場合、アプリはスクリプトの作成を拒否し、動画が静止しているようだと表示します。

.funscript が書き出される場所

<video name>.funscript

Generate の後、また Batch Generate Folder では各ファイルの処理後に、動画のフォルダーへ自動保存されます。次にその動画を開くと、アプリが自動で読み込みます。

<video name>.funscript.bak

Generate のとき、その名前のスクリプトがすでにあれば、まずここにコピーされます。保持されるバックアップは 1 つだけで、次の Generate で置き換えられます。

<video name>_as_played.funscript

File → Export Script (as played) を選んだ場合のみ：他のプレーヤー向けに、ストロークの設定を反映したものです。

%USERPROFILE%\.autoscript_sync\logs\gen_*.json

Generate または Batch の各ファイルごとの診断レポートで、最新の 40 件を保持します。記録されるのは動画のファイル名だけで、フォルダーや内容は一切記録しません。

Generate + Play（即時）はスクリプトを保存しません。作られたものを残したい場合は File → Save Funscript As… を使ってください。変換を実行する 3 つの方法はファンスクリプト生成ツールの概要で説明しています。

変換がうまくいかない場合

• スクリプトが違う動きを追っている： Set Motion Region… または Live Track で手動で領域を指定し、もう一度 Generate します。領域を変えると動画全体が再解析されるので、最初の実行とほぼ同じ時間がかかります。
• 生成がとても遅い： AI が CPU で動いている可能性があります。Check GPU を押して、解析が本当にグラフィックカードで行われているか確認してください。
• ファイルが開けない、または再生できない： 別のコンテナーを試すか、再エンコードしてください。デコードは OpenCV の FFmpeg に、再生は VLC に依存しています。
• デバイスの動きが遅れて感じる： Offset を上げてください（−5000〜+5000 ms、50 ms 刻み、動画ごとに記憶されます）。その他の再生の問題は ファンスクリプトのトラブルシューティングで扱っています。

よくある質問

次に読む

• ファンスクリプトの作り方手作業、AI、またはその両方：それぞれの方法が向いている場面。
• Windows へのインストールGPU と CPU、インストーラーが導入するもの、データの保存場所。
• エンジンのオプティカルフローDIS フローがトラッキング領域内の動きをどう計測するか。
• PC の外に出ないものアプリが行うすべてのネットワーク接続と、それぞれが送信する内容。