カスタムエンジンの使用
デフォルトでは、PlayCanvasアプリをエディターから起動すると、最新の安定版のエンジンが使用されます。しかし、以下のような理由で、アプリを異なるエンジンビルドで実行したい場合があります。
- 新しい機能やバグ修正をテストするために、最新の開発ビルドのエンジンでプロジェクトをテストし、次のエンジンリリース前に潜在的なリグレッションを検出するため。
- 現在の安定ビルドに見つかったリグレッションを緩和するために、一時的に以前の安定エンジンバージョンに戻るため。
- GitHub上のエンジンリポジトリの自分自身のフォークで開発およびデバッグするため。
それぞれの状況に対処する方法を見ていきましょう。
開発用エンジンで起動
エディターからアプリを起動すると、launchページと呼ばれる新しいタブが開きます。このページのURLは以下の形式です。
https://launch.playcanvas.com/<scene_id>
launchページのURLを編集して、次の文字列を末尾に追加します。
https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-latest.js
このビルドでローンチする場合は、次を使用してください。
https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-latest.min.js
デバッグモードを有効にして起動する場合は、次のようにしてください。
https://launch.playcanvas.com/<scene_id>?debug=true&use_local_engine=https://code.playcanvas.com/playcanvas-latest.dbg.js
以前の安定エンジンで起動
PlayCanvasエンジンの前の安定したビルドはcode.playcanvas.comにアーカイブされています。過去のすべてのリリースはGitHubで見つけることができます。エンジンは次の規則に従って命名されています。
playcanvas-<major>.<minor>.<patch>.js
例:
playcanvas-0.225.0.js
この特定のエンジンビルドで起動するには、次のローンチURLを使用してください。
https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-0.225.0.js
このビルドでローンチする場合は、次を使用してください。
https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-0.225.0.min.js
エディタは公式には現行のエンジンリリースと前のマイナーバージョンのみをサポートしています。古いバージョンのエンジンを使用することが可能な場合もありますが、それは長期にわたってサポートされるワークフローではありません。ライブプロジェクトは現行のエンジンリリースで更新しておくことを強く推奨します。
ローカルにビルドしたエンジンで起動
GitHubでエンジンリポジトリをフォークすると、そのエンジンを自分でビルドできます。ローンチページでカスタムビルドを起動するには、まずポート51000でlocalhostからサービングする必要があります。次のURLでエンジンのソースを確認してください。
http://localhost:51000/path/to/engine/playcanvas-latest.js
さて、次のURLを編集して、このエンジンをローンチページで使用します。
http://launch.playcanvas.com/<scene_id>?use_local_engine=http://localhost:51000/path/to/engine/playcanvas-latest.js
ローカルにサービスされたエンジンを使用するために、起動ページをhttpに変更する必要があることに注意してください。