obs-delay-stream v9.0.1

VRChat Dancer/音楽パフォーマー支援ツール[obs-delay-stream]

BOOTH | バグ報告 | English

ダンサー間の同期ズレやダンスとワールド音楽の同期ズレを、OBSプラグインとGoogle Chromeのみで自動計測・自動調整し解決するプラグインです。OBSに出演者向けWebSocket音声配信機能を追加します。 同時接続出演者数20人まで。

各出演者への遅延時間が自動計測され、タイミングが揃うように自動調整された音声ストリームをGoogle Chromeブラウザで受信可能です。 OBS配信（RTSP E2E）の遅延計測にも対応し、ワールドへ配信される音声との同期調整も行えます。 cloudflared トンネルで、出演者がインターネット経由で接続する受信用URLを発行します。

• SYNCROOMやDAWを必要としません。
• 出演者は配信者から渡された受信用URLにGoogle Chromeでアクセスするだけで、低遅延かつ同期された音声を受信できます。
• VRChatクライアントに影響を与えません。
• 受信ページは音量調整・リシンク/自動リシンク・スペクトラムメーター・JP/EN言語表示に対応しています。

---

設定タブ一覧

タブ	内容
出演者名	出演者ごとの名前を管理します。チャンネルの追加・削除・並べ替えができます
トンネル	cloudflared で公開URLを発行します。出演者はこのURL経由で接続するため、起動は必須です
WS配信	音声コーデック（Opus / PCM）の設定、WebSocketサーバーの起動・停止と送信制御を行います
URL共有	出演者用URLの一覧表示・一括コピーができます。共有時の手間や配布ミスを減らせます
WS計測	接続中の全チャンネルのWebSocket配信遅延を自動計測します。出演者接続時の自動計測にも対応しています
RTSP計測	OBS配信（RTSP E2E）の遅延を計測します。サイレント / ミックスの2つの計測モードを選べます
微調整	チャンネル別の環境遅延設定とディレイ全体図の確認ができます。想定アバター遅延の設定、およびローカルで生演奏する場合の同期調整（先行時間の指定）もここで行います

---

インストール

1. Releases または BOOTH から最新の obs-delay-stream-vX.X.X.zip をダウンロードして解凍
2. ZIP内に For ProgramData と For Program Files (legacy) の2種類が入っています。使用中のOBS配置に合わせて選択してください

ProgramData 配置（推奨）

1. For ProgramData/plugins/obs-delay-stream を以下へ配置:

C:\ProgramData\obs-studio\plugins\

2. OBS Studio を再起動

Program Files 配置（レガシー）

1. For Program Files (legacy)/obs-plugins/64bit/obs-delay-stream.dll を以下へ配置:

C:\Program Files\obs-studio\obs-plugins\64bit\

2. For Program Files (legacy)/data/obs-plugins/obs-delay-stream を以下へ配置:

C:\Program Files\obs-studio\data\obs-plugins\

3. 既存ファイルがある場合は上書きでOKです（更新の場合）
4. OBS Studio を再起動（管理者権限が必要な場合があります）

動作確認

1. OBS Studio を起動
2. 音声ソース（マイク・デスクトップ音声など）を右クリック
3. フィルター → ＋ → 「obs-delay-stream」 を選択
4. GUIパネルが開けばインストール成功

---

使い方

初期設定

1. フィルターパネルを開く
2. 出演者名 タブで各出演者の名前を入力
3. WS配信 タブで WebSocket サーバー起動 ボタンを押す

トンネルの起動（出演者への共有に必須）

WebSocket サーバーはこのPC（127.0.0.1）だけで待ち受けます。出演者はトンネルが発行するURL経由でのみ接続でき、LAN内のIPアドレスで直接接続することはできません。

1. cloudflared.exe path は auto のままでOK（カスタム指定したい場合のみ exe のパスを入力）
2. 「トンネルを起動」ボタンを押す（デフォルトでは初回に exe が自動ダウンロードされる）
3. https://xxxx.trycloudflare.com 形式のURLが発行される

注意: セキュリティソフトが *.trycloudflare.com をブロックしてトンネル接続に失敗することがあります。 その場合は *.trycloudflare.com を例外（許可）に追加してください。

※ 自動では、プラグインが承認した版の cloudflared を取得し、ファイルが改変されていないか起動のたびに検証します。保存先は版ごとのフォルダーです: %LOCALAPPDATA%\obs-delay-stream\bin\cloudflared\<版>\cloudflared.exe

以前の版が自動取得した %LOCALAPPDATA%\obs-delay-stream\bin\cloudflared.exe は使われなくなるため、削除してかまいません。PATHや手動で指定した exe は検証しません。

出演者への接続案内

URL共有 タブで 出演者用URL一覧をコピー ボタンを押し、Discordなどにペーストして共有する。 各出演者に、対応する自分のURLをGoogle Chromeで開いてもらう。

公開の停止と再開

出演者への公開をやめるときは、次の順に停止します。

1. トンネル タブで 停止 を押す。発行されたURLは使えなくなり、インターネットからは接続できなくなる
2. WS配信 タブで WebSocket サーバーの 停止 を押す。接続中の出演者はすべて切断される

OBSを終了した場合も両方とも止まります。OBSが異常終了した場合も、通常はプラグインが起動した cloudflared が終了します。ただし、OBSのログに cloudflared is not in the kill-on-close job という警告が出ている環境では、cloudflared が残ることがあります。残ったまま OBS を起動し直すと以前の URL で再び接続できてしまうため、タスクマネージャーで cloudflared.exe を終了してください。

再開するときは、トンネルを起動し直します。トンネルを起動するたびにURLのドメインが変わるため、URL共有 タブから改めてURL一覧を出演者に共有してください。

URLが関係者以外に漏れた場合も、トンネルを起動し直せば、それまでのURLは使えなくなります。

遅延計測（推奨手順）

1. 全出演者が受信ページに接続済みであることを確認
2. WS計測 タブで全チャンネルの遅延を計測（出演者接続時の自動計測も利用可能）
3. 計測完了後、各チャンネルのベース遅延が自動適用される
4. RTSP計測 タブでOBS配信遅延を計測（OBSの配信を事前に開始しておく）
5. 必要に応じて 微調整 タブで環境遅延やアバター遅延を設定

cloudflared・FFmpeg に脆弱性が見つかったとき

自動取得 で使う cloudflared と FFmpeg は、プラグインが承認した版に固定されています。承認版の版番号は、トンネル タブの cloudflaredパス と、RTSP計測 タブの ffmpegパス の下にある注記に表示されます。承認版に脆弱性が見つかり、プラグインの修正版がまだ出ていない場合は、次の手順で自分で更新した exe に差し替えられます。

1. 該当する exe を止める
   • cloudflared: 公開の停止と再開 の手順でトンネルを停止する
   • FFmpeg: RTSP計測 タブの計測を実行しない（FFmpeg は計測中だけ起動する）
2. 公式の入手元から最新版を入れる
   • cloudflared: Cloudflare 公式の GitHub リリース（https://github.com/cloudflare/cloudflared/releases）から cloudflared-windows-amd64.exe を取得する。または winget install --id Cloudflare.cloudflared でインストールする
   • FFmpeg: FFmpeg 公式サイトのダウンロードページ（https://ffmpeg.org/download.html）が案内する Windows ビルド（gyan.dev または BtbN）から win64 の ZIP を取得し、展開した bin\ffmpeg.exe を使う
3. プラグインの exe パス設定を切り替える
   • cloudflaredパス または ffmpegパス のプルダウンで、次のどちらかを選ぶ
   • %PATH%から解決: PATH の通ったフォルダーにある cloudflared.exe／ffmpeg.exe を使う。ファイル名はこのとおりである必要がある。PATH を変更した場合や winget でインストールした場合は、OBS を起動し直してから選ぶ。どの exe が使われるかは、コマンドプロンプトで where cloudflared／where ffmpeg を実行すると確かめられる
   • 絶対パス指定: 入力欄に exe のフルパスを入力する（例: C:\tools\cloudflared\cloudflared-windows-amd64.exe）
4. 切り替えた exe で起動し直す
   • cloudflared: トンネルを 起動 する。URLのドメインが変わるため、URL共有 タブから改めて出演者にURLを共有する
   • FFmpeg: 次回の計測から新しい exe が使われる

注意: %PATH%から解決 と 絶対パス指定 で使う exe は、注記にあるとおりプラグインが検証しません。入手元が上記の公式サイトであることを自分で確かめ、配布元が公開しているハッシュがあれば照合してください。

プラグインの修正版が出たら、更新したうえで cloudflaredパス・ffmpegパス を 自動取得 に戻してください。自動取得に戻すと、新しい承認版が取得され、起動のたびに検証されるようになります。

---

開発者向け情報

ビルド手順・トラブルシューティング・ファイル構成については BUILDING.md を参照してください。

---

ライセンス

• GNU General Public License v2.0 or later
• サードパーティライセンスについては THIRD_PARTY_NOTICES を参照してください。