VRChat 非公式日本語ドキュメント

プロジェクトを 2022 にアップグレードする

このページでは、VRChat プロジェクトをバージョン 2019.4.31f1 から Unity 2022.3.22f1 にアップグレードする方法を説明します。 最新バージョンの VRChat SDK を使用するには Unity 2022 が必要です。アップグレードのメリットはこちらで確認できます。

Creator Companion を使用している場合、プロジェクトのアップグレードは簡単です！ただしその前に、必ずプロジェクトのバックアップを作成してください。

Unity プロジェクトのバックアップ

VRChat Creator Companion を使用している場合、プロジェクトを移行する前にバックアップを作成するよう自動的に提案されます。

  1. プロジェクトをバックアップするには、Manage Projectボタンの横にある3点メニューをクリックし、「Create Backup」オプションを選択してください。これは特に初心者の方に推奨されるバックアップ方法です。
    • 「Create Backup」では、Udon、UdonSharp、VRChat Examplesの各フォルダーはバックアップされない点にご注意ください。これらのフォルダーに変更を加えた場合は、別のバックアップ方法を選択してください。
    • プロジェクトフォルダー全体を複製し、MyProject-Backupのような新しい名前を付けることでもバックアップ可能です。
    • プロジェクト全体をUnity Packageとしてエクスポートすることも可能ですが、これには時間がかかり、エラーが発生する可能性があります。推奨はしません。

バックアップの作成

この手順を飛ばさないでください！

大切なプロジェクトに大きな変更を加える際は、常にバックアップを取っておくことを推奨します。

アップグレードは失敗することがあります。その場合、バックアップをチェックポイントとして利用できます。元のプロジェクトファイルを安全に保管しておけば、それを復元して再試行し、何が問題だったのかを確認できます。

Without a backup, you don't get a second try. 間違いを犯したりアップグレードが失敗したりした場合、修正が困難、あるいは impossible. になる可能性があります。

  1. Unity 2019でプロジェクトを開き、UnityコンソールやVRChat SDK Buildパネルにエラーや警告が出ていないか確認してください。
    • Unity 2019プロジェクトで問題を修正しておかないと、Unity 2022で不具合の原因となる可能性があります。
    • 無視しても問題ない警告も一部存在しますが、なぜその警告が表示されているのかを理解しておくべきです。

これでアップグレードの準備は完了です！

アップロード前にコンテンツをテストする

Unity 2022でワールドやアバターのアップロードに成功すると、それ以降Unity 2019でアップロードすることはできなくなります。

Creator Companionを使用する

VCCからプロジェクトをアップグレードする方法は2つあります。「Projects」ページから直接行う方法と、各プロジェクトの「Manage Project」ページから行う方法です。アップグレードを行う前に、対象のプロジェクトが閉じていることを必ず確認してください。

  1. 「Settings」に移動し、「Updates」をクリックして、Creator Companionのアップデートが必要かどうかを確認してください。アップデートを行わないと、Unity 2022へのアップグレードを促すメッセージが表示されません。

VCCのアップデートを確認。

  1. 「Projects」ページには、各プロジェクトのバージョン切り替え機能が付いた新しい Unity カラムが表示されます。これをクリックし、「Migrate to Unity 2022」をクリックしてください。

該当するプロジェクトをクリック。

または、任意のプロジェクトの Manage Project をクリックすると、「Upgrade to 2022」のバナーが表示されます。

Manage Projectからアップグレードします。

Unity Hubの使用

Unity Hubは、複数のUnityバージョンを同時にインストールし、シームレスに作業を行うための独立したアプリケーションです。Creator Companionを使用したくない場合は、Unity Hubを使用してUnity 2022をインストールすることも可能です。

  1. Unity Hubをインストールします。
  2. Unityのダウンロードアーカイブにアクセスしてください。
  3. Unity 2022.xをクリックします。
  4. Unity 2022.3.22が表示されるまでスクロールし、青いUnity Hubボタンをクリックしてください。
    • リストの一番上にあるUnityバージョンは選ばないでください！
    • 現在のUnityバージョンページから、正しいバージョンのUnityをダウンロードするためのリンクを探すこともできます。

Unityアーカイブでインストールする正しいバージョンを選択してください。

Unity Hubを開くためのブラウザのプロンプトで「開く」を選択します。

  1. ウェブブラウザで Open Unity Hub をクリックします。

Androidデバイス向けのコンテンツ開発を行いたい場合は、Android Buildサポートを有効にします。

  1. Unityのインストール画面で Android Build Support を有効にします。
    • 現時点でAndroidやQuestにコンテンツをアップロードする予定がない場合は、この手順をスキップできます。
    • この手順は、後からUnity Hubで Add modules を選択することで完了できます。
  2. Continue をクリックして Unity 2022.3.22 をインストールします。

Unity バージョンの管理

Creator Companion で使用可能な Unity のバージョンを PC 上で簡単に確認できます。また、すべての新規プロジェクトを開く際に使用する Unity のバージョンを変更することも可能です。

  1. CC で Settings を開きます。
  2. Unity Editors の下にあるドロップダウンメニューを使用して、デフォルトの Unity エディタを変更します。これは、すでに作成済みのプロジェクトには適用されません。
  3. Unity 2022.3.22 をまだインストールしていない場合は、上記の手順に従ってください。
  4. インストール済みの Unity バージョンがここに表示されない場合は、更新ボタンを使用するか、ファイルボタンを使って直接パスを指定してみてください。

パッケージ

2022 プロジェクトにパッケージを追加しようとする際は、以下の点に注意してください：

  • すべての Curated Package には、2022 で動作するバージョンが用意されています。
  • その他のパッケージは動作する可能性もありますが、パッケージ作成者による新しいバージョンが必要になる場合があります！
  • 古いパッケージを使用すると多くのエラーが発生するため、インポートするものはすべてUnity 2022と互換性があることを確認してください。

トラブルシューティング

  • ワールドをアップロードする前にテストを行ってください。Unityのコンソールでエラーを確認し、VRChatでワールドをテストして正常に動作するか確認しましょう。
    • Unity 2022でワールドをアップロードした後は、同じワールドをUnity 2019でアップロードすることはできなくなります。
  • Unity Personalライセンスを必ずアクティベートしてから、VRChat SDKを使用してください。Unityは個人利用であれば無料です。
  • Unity Hubの詳細については、Unityのドキュメントをご覧ください。
  • SDK自体に関連する問題が発生している場合は、SDKトラブルシューティングのページをお読みください。

最終更新: