VRChatアバター AudioSource 安全チェックツール（Avatar Audio Safety Guard）

VRChat アバター内の AudioSource を Dry Run で診断し、必要に応じて Build 時だけ build clone 側へ安全側の補正を適用できる Unity Editor ツールです。

音量や到達距離の設定ミスを Build 前に見つけたい時や、scene / prefab 本体を触らずに Build 時だけ補正したい時に使えます。

まず Dry Run で確認してから進められるので、いきなり補正をかけるのが不安な場合にも使いやすい構成です。

主導線は VCC / VPM で、Git URL 導入は補助扱いです。

■ 何のツールか

・VRChat アバター内の AudioSource を一覧で診断するツールです

・元アバターには直接変更を加えず、必要な補正は Build 時の一時的な build clone にのみ適用します

・まず Dry Run で確認してから使う前提の、非破壊寄りの運用を重視しています

■ できること

・アバタールートに AvatarAudioSafetySettings を追加して設定を保持

・「AudioSource を走査」で Dry Run 診断

・「検出された AudioSource」一覧で対象を確認

・「診断レポートを開く」で詳細確認

・必要な場合だけ「Build時に補正」を使って build clone 側へ補正

・Build 時に要約ログを出力

■ 現在の対応範囲

・AudioSource の Dry Run 診断

・結果一覧と診断レポート表示

・Build 時の補正対象は Far / Near / Volumetric Radius / Gain / Volume

・Custom Rolloff は自動補正しません

・波形解析や AudioClip 自体の加工は未対応です

■ 想定用途

・音量や到達距離が大きすぎないかを公開前に確認したい時

・複数 AudioSource をまとめて見直したい時

・元 prefab / scene を壊さずに Build 時だけ安全側へ寄せたい時

・まず診断だけ回して、補正を後から判断したい時

■ 使い方（最短）

1. VCC / VPM から導入します

2. アバタールートに AvatarAudioSafetySettings を追加します

3. 動作モードはまず「診断のみ」のままにします

4. 「AudioSource を走査」を押します

5. 「検出された AudioSource」一覧と「診断レポートを開く」で結果を確認します

6. 問題がなければそのまま運用します

7. Build 時だけ補正したい場合だけ「Build時に補正」に切り替えます

■ VPM 導入リンク

listing ページ:

https://sebanne1225.github.io/sebanne-listing/

VCC に追加する URL:

https://sebanne1225.github.io/sebanne-listing/index.json

GitHub repo:

https://github.com/sebanne1225/avatar-audio-safety-guard

※ VCC / VPM 導入を主導線にしています

※ Git URL 導入は補助扱いで、依存 package の解決確認が別途必要です

■ 注意点

・まず Dry Run で結果を確認してください

・このツールは非破壊で動作し、元アバターには直接変更を加えません

・必要な補正は Build 時の一時的な build clone にのみ適用されます

・Custom Rolloff は自動補正しません

・VRC Spatial Audio Source の自動追加はしません

・Near / Volumetric Radius は現在の有効 Far を超える場合だけ補正します

■ 動作確認

・Unity 2022.3 前提

・VRChat Avatars package >= 3.10.0

・NDMF >= 1.11.0 < 2.0.0-a

・GitHub Release / VPM listing / 公開導線は 1.0.1 前提で整理済みです

■ 配布内容

この BOOTH 配布物は、購入後に最短で導入へ進むための案内パッケージです。

実際のツール本体は VCC / VPM から導入してください。

同梱物:

・00_README_FIRST.txt

・01_VCC_INSTALL.txt

・02_QUICKSTART.txt

・LICENSE

配布ファイル名:

・AvatarAudioSafetyGuard_Booth_Package_v1.0.1

■ 更新履歴

v1.0.1

・公開導線 URL を live の index.json に統一

・README / BOOTH_PACKAGE の公開導線表記を調整

・release zip から内部メモを除外するよう調整

・QuickStart の UI 表記を実装に合わせて修正

v1.0.0

・初回公開

■ ライセンス

MIT License

無保証 / 現状のまま提供です。詳細は同梱の LICENSE を確認してください。

何かあれば BOOTH のメッセージか X からご連絡ください。

不具合や要望も、内容が分かる形で送ってもらえると助かります。