カスタムエンジンの使用

デフォルトでは、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

ヒント

エディタは公式には現行のエンジンリリースと前のマイナーバージョンのみをサポートしています。古いバージョンのエンジンを使用することが可能な場合もありますが、それは長期にわたってサポートされるワークフローではありません。ライブプロジェクトは現行のエンジンリリースで更新しておくことを強く推奨します。

ローカルにビルドしたエンジンで起動

If you fork the engine repo on GitHub, you can build the engine yourself (via npm run build). To have the launch page launch your custom build, you need to start a local web server by running npm run serve.

Verify you can see your engine source at the URL:

    http://localhost:51000/playcanvas.js

To use this engine in the launch page, edit the URL to:

    https://launch.playcanvas.com/<scene_id>?use_local_engine=http://localhost:51000/playcanvas.js