Build & Testの使用

ワールド内の単純な機能であれば、エディターで「Play」を押すだけで動作します（マウスイベント、タイマー、アバターやネットワークとのインタラクションを必要としないものなど）。しかし、興味深い機能の多くを実現するには、実際のVRChatクライアントで動作するワールドのビルドを作成する必要があります。

UdonExampleSceneを開く

VRChat ExamplesフォルダからUdonExampleSceneを開いてください。このシーンには、学習に役立つ再利用可能なグラフが多数含まれています。すべてそのまま動作するように設定されているため、これを使ってすべてが正常に機能しているかを確認できます。

設定の準備

1. まずは新規プロジェクトを作成し、Worlds SDKが正しくインポートされていることを確認します。次に、メニューバーの「VRChat SDK > Show Control Panel」からVRChat Control Panelを開いてください。

2. 「Authentication」タブにログイン情報を入力し、「Sign In」を押してください。

3. 「Settings」タブをクリックし、一番下にある「VRChat Client」の項目を探してください。これはUnityがワールドをテストする際に使用するVRChatクライアントです。これを設定しないと、ワールドが正しく起動しない場合があります。

「Edit」を押してファイル選択画面を開き、VRChatをインストールした場所まで移動してVRChat.exeを選択してください。以下に、デフォルトのインストール場所の例をいくつか挙げます：

• Steam: C:\Program Files (x86)\Steam\steamapps\common\VRChat\VRChat.exe
• Oculus: C:\Program Files\Oculus\Software\Software\vrchat-vrchat\VRChat.exe
• Viveport: C:\Viveport\ViveApps\469fbcbb-bfde-40b5-a7d4-381249d387cd\1597468388\VRChat.exe

4. 「Builder」タブに切り替えます。VRChatが想定する設定に合わせて、レイヤーと衝突行列（Collision Matrix）を設定する必要があります。「Setup Layers for VRChat」ボタンを押し、表示されるポップアップで「Do it!」を選択してください。

次に、「Set Collision Matrix」ボタンに対しても同様の操作を行います。

初めてのテストを実行する

すべての設定が完了したら、シーンをビルドする準備は完了です。上記の手順に従ってBuilderタブの問題を解決すると、「Build & Test」ボタンが利用可能になります。最初のテストとして、「Force Non-VR」をオンにしてから「Build & Test」を押してください。

VRChatクライアントが起動し、ワールドのローカルコピーに入ることができます。そこで自由に動き回り、すべてを試してみてください！

複数のクライアントを起動する

Synced VariablesやCustom Network Eventsをテストするには、同じワールドに複数人がいる必要があります。これを最も簡単に行う方法は、Builderタブを使用して複数のクライアントを起動することです。現在VRChatクライアントウィンドウが開いている場合は一度閉じ、「Number of Clients」を2に変更してから、再度「Build and Test」を押してください。これでUnityはVRChatクライアントを2つ起動し、両方に同じアバターが表示されます。ウィンドウを切り替えて2つのアバターを操作すれば、両方のアバターが話している様子を確認できます。Synced Variablesのエリアを試してみてください。最初に読み込まれたアバターがインスタンスのMasterとなり、それらのGameObjectのOwnerになるため、UI Elementsを更新できます。一方、2番目のアバターは更新結果を見ることしかできません。このシーンにおける唯一の例外は、クリックした人にオーナー権限を譲渡する「SyncButtonAnyone」です。

Build & Reload

多数のクライアントをテストする場合、ワールドに変更を加えるたびにウィンドウを整列させたり、VRChatへのログインを待ったりするのは手間がかかります。起動する「Number of Clients」を0に変更すると、「Build & Test」が「Build & Reload」に切り替わります。

これによりワールドの新しいバージョンがビルドされ、開いているすべてのクライアントが新しいローカルインスタンスへ移動します。その際、VRChatの起動シーケンスは完全にスキップされます。

複数のプロファイルでテストしたい場合は、自身で起動するクライアントに対しても同様のことができます。新しいコマンドラインフラグ --watch-worlds を使用して、この機能を有効にしてください。例えば、以下のコマンドを実行すると、メインプロファイルでデスクトップモード、フルデバッグ付き、1920x1080の解像度でVRChatが起動し、ワールドのリロード機能が有効になります。

VRChat.exe --watch-worlds --profile=0 --no-vr --enable-debug-gui --enable-sdk-log-levels --enable-udon-debug-logging -screen-width 1920 -screen-height 1080