ファンスクリプトのトラブルシューティング

デバイスが遅れる・早すぎる

原因。どの環境でも、映像とデバイスの間には多少の遅延があります。Ultra ではネットワークと Autoblow のクラウド、Intiface のデバイスでは PC と Bluetooth です。動画の別の編集版に合わせて作られたスクリプトも、全体にわたってずれます。

解決方法。Offset を変更します。範囲は -5000 から +5000 ms で、50 ms 刻みです。デバイスが遅れると感じたら上げ、早すぎると感じたら下げてください。アプリは動画ごとに値を保存し（最大 200 本）、その動画を再び開いたときに復元します。値が保存されていない動画では、最後に使った Offset がそのまま使われます。Offset はデバイスごとではなく、すべてのデバイスで共通の 1 つです。

再生中に起きることは経路によって異なります：

• Autoblow AI Ultra。アプリは、動画の時刻に測定した往復時間の半分を足した位置でデバイスを開始し、その後 1.5〜5 秒ごとにデバイスの時計を確認します。80〜350 ms のドリフトは少しずつ補正し、350 ms を超えると動画の位置でデバイスを再スタートします。それでも Ultra がずれる場合は、一時停止してから再生し直すと、再び基準が合わせられます。
• Intiface のデバイス。遅延の測定やドリフト補正はありません。スクリプトは再生やシークのたびに PC の時計で動き、Offset の分だけずらされます。動画が止まったりバッファリングしたりしてもデバイスは動き続けるので、一時停止して再生し直すか、シークして合わせ直してください。

一部の区間だけがずれていてほかは合っている場合、原因は同期ではなくその部分のスクリプトです。タイムラインでその範囲を選択し、Shift ±20 ms を使ってください。

Autoblow AI Ultra に接続できない

原因。アプリが Ultra に接続するのは Autoblow のクラウド経由のみで、ローカルネットワークで直接つながることはありません。クラウドにあなたのデバイストークンの有効なセッションがない場合、Ultra がオフラインか、トークンが間違っています。

解決方法。

1. PC と Ultra の両方がインターネットに接続されていることを確認してください。デバイスが動いている間は、ずっと両方の接続が必要です。
2. Ultra をオンラインにします：ボタンを約 3 秒間押し続け、LED が白く速く点滅したら離し、ライトブルーに変わるのを待ちます。ライトブルーがオンライン状態です。
3. アプリに貼り付けたデバイストークンを確認してください。トークンは Autoblow のオンラインセットアップページで取得します。LED がライトブルーなのに失敗する場合は、fun.autoblow.com でトークンを確認してください。
4. もう一度接続し、再生する前に Send Script to Device を押してください。押さないと、アプリは大まかな位置コマンドに切り替え、「Streaming positions (fallback mode)」と表示します。

接続に成功した後で再生の開始や動作に失敗した場合、アプリは再接続中であることを表示し、5 秒ごとに再試行し、復帰したときにデバイスを動画に合わせ直します。Ultra が内蔵パターンやオシレートモードに切り替わった場合はその旨を表示するので、スクリプトを再送して同期に戻してください。セットアップの詳細は Autoblow AI Ultra のページにあります。これは私たちが実機でテストした唯一のデバイスです。

Intiface のデバイスが見つからない

原因。アプリは ws://127.0.0.1:12345 の Buttplug サーバーを通じてデバイスと通信します。そこで何も待ち受けていなければ、同梱の Intiface エンジン（バージョン 1.4.8）を自分で起動するので、Intiface Central は不要です。接続時には最大 12 秒間スキャンします。電源が切れているデバイス、Bluetooth の範囲外にあるデバイス、同梱エンジンより新しいデバイスは表示されません。

解決方法。

• Windows で Bluetooth をオンにし、デバイスの電源を入れ、スキャン中は PC の近くに置いてください。12 秒以内に準備ができなかった場合は、もう一度接続してください。
• The Handy は Intiface 経由の Bluetooth でのみ動作します。Wi-Fi の接続キーモードには対応していないので、Bluetooth に設定してください。
• Intiface Central を自分で起動している場合、アプリは自前のエンジンではなくそちらを使います。Intiface Central v3 との組み合わせは確認していません。Central ではデバイスが見つかるのにアプリでは見つからない場合は、Central を閉じて、アプリに同梱エンジンを起動させてください。
• 同梱エンジン（2023 年 11 月）より後に発売されたデバイスは、エンジンが認識できない場合があります。

Intiface の経路は、モックサーバーと実際のエンジン上のシミュレートしたデバイスでテストしており、実際の Bluetooth トイではテストしていません。詳細は Intiface のページに、そのデバイスについては The Handy のページにあります。

スクリプトが読み込めない、または上下逆に再生される

原因。ファイルが有効な JSON でない、actions リストがない、またはリリース済みのアプリが読めないエンコーディングで保存されています。バージョン 2.121.1 は UTF-8 しか読めないため、一部の Windows ツールが BOM 付きや UTF-16 で保存したファイルは拒否されます。また inverted フラグを無視するので、反転指定のスクリプトは上下逆に再生されます。

解決方法。ファイルをファンスクリプト検証ツールにドロップしてください。問題を特定し、並べ替え、時間の重複、範囲外の位置については修復したコピーを提供します。エンコーディングの問題なら、テキストエディターでファイルを開き、プレーンな UTF-8 で保存し直してください。次回のアップデート（2.121.2）では、BOM と UTF-16 を読み込み、inverted を正しく適用し、ファイルが使えない理由をわかりやすい言葉で説明します。

ファイル名も確認してください。自動で読み込まれるには、スクリプトが動画と同じベース名で同じフォルダーにある必要があります。そうでなければ Load Funscript… を使ってください。アプリが読み込み時に行う修復はすべて形式リファレンスに載っています。

動きが速すぎる、またはストロークが短く切られる

原因。アプリは Autoblow AI Ultra にスクリプトを送る前に、コピーをデバイス用の速度プロファイルに合わせて調整します。デバイスが処理できるより間隔の狭い点は統合され、プロファイルが許すより速い速度を必要とするストロークは、タイミングは保ったまま幅が小さくなります。速いシーンでは、タイムライン上よりもデバイス上のストロークが短くなって現れます。保存された .funscript が変更されることはありません。

プロファイルは、メーカーが公表している数値から約 10% 差し引いた値を使っており、私たち自身の測定値ではありません。Autoblow の毎秒 400 単位は意図的に控えめにした既定値です。Autoblow は速度の数値を公表していないためです。

解決方法。

• Device model を確認してください。そこで選んだプロファイルが Ultra 自身のものに置き換わるので、別のモデルが選ばれたままだと上限が正しくなくなります。
• ある区間だけがただ激しすぎる場合は、タイムラインでその区間を選択して Soften か Smooth を使い、スクリプトを再送してください。
• Ultra は送られたコピーを再生するので、編集やストローク設定の変更は、もう一度 Send Script to Device を押したときにだけ反映されます。

リリース済みのアプリでは、Intiface のストローカーにはこの調整を行わずにスクリプトを送ります。次回のアップデートでは、Intiface のデバイスにも同じ調整とストローク設定を適用します。任意の速度上限でファイルをチェックするには、検証ツールの速度チェックを使ってください。

速いシーンでストロークが小さすぎる

原因。これはジェネレーターの既知の弱点で、あなたの PC の不具合ではありません。メインの解析はすべてのフレームを見るわけではなく、30 fps の動画では Fast、Balanced、High でそれぞれ毎秒 7.5 回、10 回、15 回サンプリングします。動きが速いと、この粗いサンプリングではストロークの上端と下端を取りこぼします。開発者が手作りのスクリプトと比較したテストでは、速いシーンで生成されたストロークがかなり小さすぎる結果になりました。

解決方法。

• タイムラインで速い区間を選択し、Re-analyze を選びます。その区間だけをフルフレームレートで再スキャンし、結果を差し込みます。
• または区間を選択して Amplify を使うと、その区間のすべてのストロークが 15% 大きくなります。さらに大きくするには繰り返してください。
• High で生成します。3 フレームごとではなく 2 フレームごとにサンプリングします。時間は長くかかります。

生成したスクリプトを編集して保存すると、シーンの種類ごとにあなたの好みのストロークの大きさをアプリが学習し、以降の動画に適用します。

何も起きていないのにデバイスが動き続ける

原因。既知の制限です。ジェネレーターはオープニングタイトルとエンドクレジットでは静止させ、ほとんど動きのないウィンドウは平らにしますが、動画の途中では、手作業でスクリプトを作る人なら止めるような区間でもストロークを出し続けることがあります。

解決方法。編集で取り除きます。タイムラインで動きのない区間を Shift+ドラッグで選択し、Delete を選びます。点がなくなると、デバイスは区間の前の点から後の点までゆっくりと移動します。完全に止めたい場合は、Ctrl+クリックで区間の両端に同じ高さの点を追加してください。そのあと保存し、Ultra を使っているならスクリプトをデバイスに再送します。解析が動画全体を通して間違ったものを追い続ける場合は、Set Motion Region… で追跡する領域を描いて、もう一度生成してください。

動画に動きがほぼまったくない場合、アプリはスクリプトをでっち上げることはせず、動画が静止しているように見えると伝えます。

生成が遅い

原因。AI モデル（姿勢と深度）は、CUDA を通じて NVIDIA のグラフィックカード上でのみ高速化されます。AMD や Intel のグラフィックス、または NVIDIA のカードが使えない場合はプロセッサー上で動作します。動きはしますが、かなり遅くなります。アプリはこれを隠さず、実際に使われているプロバイダーを表示します。オプティカルフローは常にプロセッサー上で動作します。

解決方法。

• Check GPU（View → Check GPU… からも可）を押してください。PyTorch と ONNX Runtime がグラフィックカードを使えるかどうかを表示し、姿勢モデルがインストールされていれば、姿勢推定がどのプロバイダーで動いているかと、フレームあたりのミリ秒での速度セルフテストを表示します。
• Hardware を Auto または GPU (CUDA) に設定してください。Auto は CUDA が使えるときに CUDA を使います。
• High ではなく Balanced を使ってください。開発者自身がいくつかのテスト動画で測定したところ、High はほぼ同じ結果に約 1.5 倍の時間がかかりました。Fast はさらに速いですが、読み取るストロークが目に見えて少なくなります。
• 同じセッション内で同じ動画を同じ解析設定で再生成すると、すでに行った解析を再利用するのでほぼ一瞬で終わります。アプリは閉じるまで直近 3 本の動画をメモリに保持します。

起動時にメッセージなしでアプリが閉じる

原因。最も可能性が高いのは VLC がないことです。アプリはインストール済みの 64 ビット版 VLC で動画を再生します。インストーラーは VLC の有無を確認し、見つからなければ videolan.org からダウンロードして自動でインストールします。インストール中に PC がオフラインだったなどでダウンロードに失敗すると VLC は飛ばされ、アプリは起動時に何のメッセージも表示せずに閉じます。説明はログファイルにしか書かれません。

解決方法。64 ビット版 VLC をインストールするか、PC をオンラインにした状態で AutoScript Sync のインストーラーをもう一度実行して、VLC を自動で取得させてください。そのあとアプリを再度起動します。設定、モデル、教えた AI は %USERPROFILE%\.autoscript_sync に保存されており、再インストールしても残ります。

体験版が開始できない

原因。体験版は初回起動時に自動では始まらず、オフラインでは開始できません。ライセンスサーバーが PC ごとに体験版を記録するため、一度は接続する必要があります。

解決方法。インターネットに接続してアプリを開き、アクティベーションウィンドウで Start free 1-day trial をクリックしてください。その日はすべての機能が使えます。その PC ですでに使った体験版は、再インストールしても再開しません。体験版が終わったら、同じウィンドウ（Help → License / Activation…）でライセンスキーを入力します。キーは ASYN-XXXX-XXXX-XXXX の形式です。インストーラーはダウンロードページにあり、ストアでは £14.99 の買い切りでライセンスを販売しています。

次に読む

• アプリのガイドインストール、アクティベーション、デバイスのセットアップ、品質レポートを順を追って説明します。
• Autoblow AI Ultra のセットアップと同期接続方法、ランプの意味、ドリフト補正のしくみ。
• 対応デバイスデバイスの系統ごとに、何に対応していて、どこまでテストされているか。
• アプリがスクリプトファイルを読み込む方法ほかのツールで作られたファイルにアプリが行うすべての修復。
• 学習ハブ4 つのリファレンスページすべて。